开发规范
1.1 构件包
1、 概念
构件包是JUD项目中基础的业务实现和业务部署单元,其中包含了构件,构件实现以及一些额外需要的资源(如配置信息、页面资源等)。
2、 命名规范
全部使用英文小写。
采用长命名空间的方式,如com.cgn.deomo. iccard。
包名=系统命名空间+”.”+应用代码+”.””模块名”,例如com.cgn.demo.iccard;本规范假定系统命名空间在项目中统一使用com.cgn 应用代码demo 模块名iccard
显示名称使用默认信息,描述信息为中文。
3、 设计开发规范
设计时,合理规划项目中构件包的粒度,一个构件包对应与应用系统中一个相对独立的业务域,例如客户管理、产品管理等。
通常每个构件包对应一个与其名称一致的web路径。但现在多应用开发中,应在每一个应用下的构件包下加一个前缀,用以区分将不同应用下的部署到特定的目录中,而不是部署到一起(除非有需要时)。如: com.towngas.tcis.frame构件包的web路径为:frame 。
划分构件包时应避免构件包之间的相互依赖,如构件包A依赖构件包B的资源,而构件包B又要使用构件包A的资源,这时应该将构件包A,B相应的资源抽取到公用构件包C。
2.2 逻辑构件
1、 命名规范
(1) 逻辑构件名称为构件对象的单词(或缩写),其后可选如Manager等动词,首字母大写,与java类命名一致。如UserManager、MenuManager。
(2) 逻辑构件直接建在以构件包为名称的包。
(3) 显示名称使用默认信息,描述信息为中文。
(4) 逻辑构件是包含一个单一实体管理功能的操作集合,例如增(add)、删(delete)、改(update)、查(query)等。
2、 参数传递规范
优先使用业务实体对象和JUD内置对象,其次为map对象
3、 设计开发规范
逻辑构件在项目的设计中主要充当了逻辑功能拼装的载体,对于复杂业务,建议通过调用spring中定义的bean对象去拼装业务逻辑。