欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

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

程序员文章站 2022-05-29 22:57:28
...

一、开发环境

  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为实体类工程,如果业务不需要与数据库交互可以删除此工程。

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

修改工程名称及配置:

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

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

    • 修改类包的sampleproject名称为sso

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

    • 修改web.xml中的sampleproject为sso

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

 

三、业务开发

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

四、部署

通过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。

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

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

O2OA开源办公平台:搭建自定义工程及开发
            
    
    博客分类: O2OA二次开发手册企业信息化系统架构企业信息化系统 OA办公系统办公软件开源软件开源 

 

(转自公众号:浙江兰德网络)