O2OA开源办公平台：搭建自定义工程及开发

一、开发环境

1. JDK1.8

2. maven V3.5+

3. 运行环境 o2server V5.0+

二、搭建工程及配置

1. 工程模板下载：https://git.o2oa.net/o2oa/o2custom-sample/-/archive/master/o2custom-sample-master.zip

2. 解压o2custom-sample-master.zip，然后重命名文件夹名称为自己业务相关的名称（如：o2custom-sso）

3. 打开系统命令窗口（cmd），进入到2步骤的文件夹，然后执行mvn install（第一次需要下载很多依赖包比较慢），直至BUILD SUCCESS。

4. 使用idea或者eclipse导入工程（eclipse导入之前先执行mvn命令：mvn eclipse:eclipse）

5. 工程目录解析：

• • store目录存储mvn install命令后打包的war包和jar包，其中x_base_core_project.jar包为系统包误删除（打包时需要）；

  • x_program_center目录打包时生成，可以直接删除；

  • x_sampleproject_assemble_control为业务应用工程，所有业务代码都写在这里；

  • x_sampleproject_core_entity为实体类工程，如果业务不需要与数据库交互可以删除此工程。

修改工程名称及配置：

• • 根据业务修改工程名称中sampleproject的名字，这里修改为sso

  • 修改所有pom文件中的工程名称

• • 修改类包的sampleproject名称为sso

• • 修改x_sampleproject_core_entity类名称为x_sso_core_entity，并修改该类中的sampleproject名称为sso

• • 修改x_sampleproject_assemble_control类名称为x_sso_assemble_control，并修改该类中的sampleproject名称为sso

• • 修改web.xml中的sampleproject为sso

• • 最后再用maven命令或者工具进行mvn install，直至success，这样新的工程就搭建完成了。

 

三、业务开发

如果有自己的业务需要存储，那首先需要定义实体类，实体类是与数据库表映射（o2oa是通过openjpa与数据库交互，表会通过实体类在工程第一次启动的时候自动创建的，无需手工创建），可以拷贝或修改SampleEntityClassName类，然后添加自己的业务属性

添加或修改实体类后，需要在x_sso_assemble_control类的containerEntities中添加或修改对应的实体类，多值逗号隔开

业务接口开发，后端业务统一提供restful接口，业务模块在com.x.sso.assemble.control.jaxrs下开发，现在有示例sample模块，根据需要修改名称或添加模块，然后修改或增加action类Anonymous

权限过滤配置，根据业务需要定义接口是否需要权限访问，JaxrsServicePathFilter需要权限访问，AnonymousJaxrsServicePathFilter不需要权限访问，把业务地址配置到相应类中

获取当前登录用户及用户组织查询

应用模块自定义配置，o2server V5.3+​版本可以读取自定义配置文件，定义的配置文件同平台配置存放在o2server/config下，平台提交接口获取，之前的版本需要自定义配置文件在war中，然后自行读取。

四、部署

通过mvn install命令打包，打包后会生成war包和jar包到项目的store目录下，war包部署到o2server/custom下，jar包部署到o2server/custom/jars目录下，如果项目有额外引进第三方jar包（确认平台未引进，平台使用的jar包在o2server/commons/ext目录下）同样部署到o2server/custom/jars目录下，项目如果有通用帮助类需要在前端脚本使用，也可以打包成jar包部署在o2server/custom/jars目录下。

应用包部署也可以通过web端部署，管理员登录平台进入系统设置——系统部署——服务部署，先部署custom的jar，再部署custom的war，部署好后需要重启o2server。

部署成功与否可以访问http://*:20030/x_program_center/jest/list.html检查api列表中是否有部署的模块（需管理员登录o2server），如：

（转自公众号：浙江兰德网络）