一、开发环境
- JDK1.8
- maven V3.5+
- 运行环境 o2server V5.0+
二、搭建工程及配置
- 工程模板下载：https://git.o2oa.net/o2oa/o2custom-sample/-/archive/master/o2custom-sample-master.zip
- 解压o2custom-sample-master.zip，然后重命名文件夹名称为自己业务相关的名称（如：o2custom-sso）
- 打开系统命令窗口（cmd），进入到2步骤的文件夹，然后执行mvn install（第一次需要下载很多依赖包比较慢），直至BUILD SUCCESS。
- 使用idea或者eclipse导入工程（eclipse导入之前先执行mvn命令：mvn eclipse:eclipse）
- 工程目录解析：
- 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），如：
