1 背景概述
数通畅联本着分享传递的理念已经将产品家族中的核心产品开源,目的在于满足客户与伙伴的OEM需求,以及为广大IT爱好者的集成工具提供多一种选择,多一种便利。如果需要对产品进行扩展开发或者更深层次的了解产品可以在svn中check out源码。
本文详细介绍BPM、Portal、SMC工程在AEAI DP中配置步骤以及方法,来支持扩展开发,以-d模式启动来支持远程debug调试,debug模式方法可以参考AEAI DP开发平台技术手册(http://pan.baidu.com/s/1gdKlQvD)。另外,由于BPMServer、PortalServer、ESBServer的内部运行机制不建议使用MyEclipse或者Eclipse JavaEE来进行扩展开发。
2 预期读者
-
数通畅联内部员工
-
外部扩展开发人员
3 名词解释
-
用户库:可以导入的jar包,为了满足编译时的需要。
-
SVN:SVN是Subversion的简称,是一个开放源代码的版本控制系统。
4 实现思路
创建SVN路径,将工程从SVN上check out下来,配置用户库引用相应的jar包,解决编译出错的问题。设置对应的服务器配置,修改对应的服务器中的配置文件指向开发目录,正确启动服务器,保证程序的正确运行。
5 实现步骤
5.1 AEAI BPM工程
AEAI BPM是以业务流程为中心、帮助企业各业务环节与客户需求对齐的管理方法,用户可以在http://pan.baidu.com/s/1i4zLpcD#path=%252FAEAI%2520BPM下载相关介质以及文档,源码托管于开源中国http://git.oschina.net/agileai/aeaibpm,可以从SVN上check out源码进行二次开发,路径为svn://git.oschina.net/agileai/aeaibpm。
5.1.1 SVN Check Out程序
2. 弹出界面在URL中输入对应的SVN路径,点击Finish,成功后点击SVN路径如下图:
3. 在项目名上右键选择“检出为”
4. 弹出界面点击NEXT可以查看项目地址,之后点击Finish
5. 点击按钮切换到JAVA透视图,检出的工程会出现编译出错的问题如下图:
6. 查看报错信息,问题定位为缺少jar包,下面开始配置用户库引入相应的jar包。
5.1.2 配置用户库
用户库在工程Check Out时已经创建,但是可能会缺少对应的Jar这里只需要对用户库进行配置引入相应的Jar即可。
1. 在工程下右键选择Build Path –Configure Build Path
2. 选择Add Library
3. 选择 User Library点击Next之后点击Finish
4. 选择新创建的用户库点击右侧的Add JARs
5. 另需配置用户库BPM Server 引入(您服务器的地址) bpm_server_x86_ Vx.x.x.YYYYMMDD shared下的jar以及
(您服务器的地址) bpm_server_x86_ Vx.x.x.YYYYMMDD lib下的jsp-api.jar以及servlet-api.jar
6. 用户库创建成功后,刷新应用
7. 修改数据库配置文件
5.1.3 BPM Server设置
1. 解压BPM Server安装介质bpm_server_x86_Vx.x.x.YYYYMMDD.rar;
编辑bpm_server_x86_Vx.x.x.YYYYMMDDin目录下,startconfigtoolNaNd文件,设置JDK路径,如图所示:
2. 打开数据库配置,设置连接URL改为数据库名,填写数据库的用户、密码后点击“测试连接”,连接成功后,初始化数据高亮显示,若创建的BPM数据库中没有内容,则点击初始化数据,将自动生成数据表。若数据库已经存在且有内容,不可点击初始化数据,否则将覆盖已有的数据库内容。如图:
3. 双击bin目录下的startup.bat,即可直接启动BPMServer,如图所示:
5.1.4 修改服务器配置文件
1. (您服务器的地址)pm_server_x86_ Vx.x.x.YYYYMMDD confCatalinalocalhost
2.添加bpm.xml文件如下:docBase属性指向开发目录
3.删除(您服务器的地址)pm_server_x86_ Vx.x.x.YYYYMMDD webapps下预置的bpm工程;
4. 双击bin目录下的startup.bat,即可直接启动BPMServer,如图所示:
5. 浏览器输入http://localhost:7070/访问界面如下:
6. 输入账号admin(密码admin)登陆后界面:
5.2 AEAI Portal工程
Portal是门户集成平台, 可以作为企业的应用中心,或者是企业应用的入口,在统一的界面上聚合现有各业务系统的数据、菜单、界面。 用户可以在http://pan.baidu.com/s/1mgj3SV2下载相关介质以及文档,源码托管于开源中国http://git.oschina.net/agileai/aeaiportal,可以从SVN上check out源码进行二次开发,路径为svn://git.oschina.net/agileai/aeaiportal。
5.2.1 SVN Check Out程序
1. 打开设计器点击跳转到界面点击
按钮,弹出界面在URL中输入对应的SVN路径,点击Finish
2. 成功后,点击SVN路径如下图:
3. 在项目名上右键,选择“检出为”
4. 弹出界面点击NEXT可以查看项目地址,点击Finish
5. 点击按钮切换到JAVA透视图,检测出的工程会出现变异出错的问题如下图:
6. 查看报错信息,定位为缺少jar包,下面开始配置用户库引入相应的jar包
5.2.2 配置用户库
用户库在工程Check Out时已经创建,但是可能会缺少对应的Jar这里只需要对用户库进行配置引入相应的Jar即可。
1. 在工程下右键选择Build Path –Configure Build Path
2. 指定设计器的Jre
3. 另需配置用户库Portal Server 引入(您服务器的地址)portal_server_x86_ Vx.x.x.YYYYMMDD shared下的jar以及(您服务器的地址)portal_server_x86_ Vx.x.x.YYYYMMDD lib下的jsp-api.jar以及servlet-api.jar
4. 用户库创建成功后刷新应用
5. 修改数据库配置信息及开发目录下配置信息
5.2.3 Portal Server设置
1. 解压PortalServer安装介质portal _server_ x86_Vx.x.x.YYYYMMDD.rar;
编辑portal_server _x86_Vx.x.x.YYYYMMDDin目录下,startconfigtoolNaNd文件,设置JDK路径,如图所示:
2. 打开数据库配置,设置连接URL改为数据库名,填写数据库的用户、密码后点击测试连接,连接成功后,初始化数据高亮显示,若创建的portal数据库中没有内容,则点击初始化数据,将自动生成数据表。若数据库已经存在且有内容,不可点击初始化数据,否则将覆盖已有的数据库内容。如图:
5.2.4 修改服务器配置文件
1. (您服务器的地址)portal_server_x86_ Vx.x.x.YYYYMMDD confCatalinalocalhost
2.打开对应的xml文件添加属性docBase指向开发工程的webRoot目录
3.删除(您服务器的地址)portal_server_x86_ Vx.x.x.YYYYMMDD webapps下预置的portal与portal_portlets工程结果如下
4. 双击bin目录下的startup.bat,即可直接启动PortalServer,如图所示:
5. 浏览器输入http://localhost:8080/portal/login.jsp访问界面如下:
6. 输入账号admin(密码admin)登陆后界面:
5.3 AEAI ESB SMC工程
AEAI ESB是集成各业务系统,实现异构系统的互联互通。 用户可以在http://pan.baidu.com/s/1o6NvxXo下载相关介质以及文档,源码托管于开源中国http://git.oschina.net/agileai/aeaiesb,可以从SVN上check out源码进行二次开发,路径为svn://git.oschina.net/agileai/aeaiesb。
5.3.1 SVN Check Out程序
2. 弹出界面在URL中输入对应的SVN路径,点击Finish
3. 成功后点击SVN路径,如下图:
4. 在项目名上右键后选择“检出为”
5. 弹出界面点击NEXT可以查看项目地址,点击Finish
6. 点击按钮切换到JAVA透视图,检测出的工程会出现变异出错的问题。查看报错信息,问题定位为缺少jar包,下面开始配置用户库引入相应的jar包。
5.3.2 配置用户库
用户库在工程Check Out时已经创建,但是可能会缺少对应的Jar这里只需要对用户库进行配置引入相应的Jar即可。
1. 在工程下右键选择Build Path –Configure Build Path
2. 指定设计器的jre
3. 创建的用户库soaker
4. 重复步骤1和2点击 User Library 后点击Next
6. 选择创建的库,点击右侧的Add JARs添加jar包
7. 引入ESB服务器下的
**(您的ESBServer的目录)esb_server_x86_ Vx.x.x.YYYYMMDD shared
**(您的ESBServer的目录)esb_server_x86_ Vx.x.x.YYYYMMDD lib下的jsp-api.jar以及servlet-api.jar目录中的jar包,点击OK,选择添加的用户库,点击Finish。
8. 用户库创建成功后,刷新应用解决编译出错的问题如下图:
9. 修改数据库的配置文件及开发目录下配置信息
5.3.3 ESB Server设置
1. 解压ESBServer安装介质esb_server_x86_Vx.x.x.YYYYMMDD.rar;
编辑esb_server_x86_Vx.x.x.YYYYMMDDin目录下,startconfigtoolNaNd文件,设置JDK路径,如图所示:
2. 打开数据库配置,设置连接URL改为数据库名,填写数据库的用户、密码后点击测试连接连接成功后,初始化数据高亮显示,若创建的esb数据库中没有内容,则点击初始化数据,将自动生成数据表。若数据库已经存在且有内容,不可点击初始化数据,否则将覆盖已有的数据库内容。如图:
5.3.4 修改服务器配置文件
1.**(您的ESBServer的目录)esb_server_x86_Vx.x.x.YYYYMMDD confCatalinalocalhost
2.添加docBase属性指向开发工程的webRoot目录
3.删除**(您的ESBServer的目录)esb_server_x86_ Vx.x.x.YYYYMMDDwebapps下预置的SMC工程
4.浏览器输入http://localhost:9090/SMC/访问界面如下
5.admin(密码admin)登录后如下图