开发规范

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对象去拼装业务逻辑。