JBoss.orgCommunity Documentation

第 1 章 应用规范

1.1. 应用开发要求
1.2. 应用开发规范

EpicSaaS中的应用是SaaS化后的分布式应用。为了解决SaaS后应用中会出现的节点单点、应用集成、日志抓取、应用升级等问题,我们遵行约定大于配置的原则作出了以下开发规范,开发时必须遵守。

  1. 目前只支持基于标准J2EE WEB规范开发出的程序,即其程序部署包必须是WAR包。其他暂不支持

  2. 使用JAVA SDK开发的应用/服务程序必须使用log4j组件且使用其XML配置方式进行日志输出,即在应用/服务的war包里必须存在/WEB-INF/classes/log4j.xml文件,否则平台无法保证其相关日志功能正确

  3. 当使用JAVASDK开发的应用/服务程序需要得到静态资源自动动静分离功能时,必须将其静态资源放入war包的根目录下的static子目录里

  4. 应用部署升级时需要使用的sql文件存放目录必须为 /sql/mariadb/目录下,文件命名:上一版本-下一版本.sql,例如(0.0.0-0.0.1.sql表示安装0.0.1版本对于的sql文件,0.0.1-0.0.2.sql表示从0.0.1升级到0.0.2对于的sql文件)

  5. 应用为分布式结构,要求应用必须使用平台分布式Session(不能使用httpsession、避免单点问题)

  6. 应用必须使用平台提供的组织机构、群组

  7. 应用要使用平台服务必须在集成配置文件中申请,具体请看后面内容中的《授权机制》

  8. 应用要使不同租户数据存储隔离必须使用com.epicpaas.sdk.core.jdbc.EPICXaDataSource作为数据源

  9. 应用头部菜单必须使用平台提供的

  10. 应用管理员必须使用平台默认角色编码(编码为:__APP_MANAGER_GROUP,可使用常量com.epicsaas.common.Constants.APP_MANAGER_GROUP获取。 上传应用时平台会自动分配一个应用管理员角色给该应用)

  11. 流程共享群组(app资源ID区分不同租户)必须在集成配置文件中设置

  12. 应用集成配置文件中配置的三张图片,必须是分辨率为29×29、57×57、114×114 的圆角图片

  13. 应用部件不能有背景图片、背景颜色。避免集成到门户中影响视觉

开发规范请参考 EPICSAAS平台开发规范参考-v0.1.docx