java开发规范文档

合集下载

JAVA开发规范文档

JAVA开发规范文档

Java 开发规范文档一:目的使本组织能以标准的,规范的方式设计和编码。

通过建立编码规范,以使每个开发人员养成良好的编码风格和习惯;并以此形成开发小组编码约定,提高程序的可靠性,可读性,可修改性,可维护性和一致性等,增进团队间的交流,并保证软件产品的质量。

二:代码组织与风格1:长度:为便于阅读和理解,单个函数的有效代码长度当尽量在100行以内(不包括注释行),当功能模块过大时往往采用使用子函数将相应的功能抽取出来,这也有利于提高代码的重用度。

2:单个类不宜过大,当出现此类过大时当将相应功能的代码重构到其他类中,通过组合等方式来调用,建议单个类的长度包括注释行不超过1500行。

尽量避免使用大类和长方法。

3:间隔:类,方法及功能块间等应以空行相隔,以增加可读性,但不得有无规则的大片空行。

操作符两端应当各空一个字符以增加可读性。

三:注释1:注释应该增加代码的清晰度。

代码注释的目的时要使代码更易于被其他开发人员等理解。

2:保持注释的简洁。

3:注释信息应该包括代码的功能。

4:除变量定义等较短语句的注释使用行尾注释外,其他注释当避免使用行尾注释。

5:JavaDoc规范对类,方法,变量等注释需要符合javadoc规范,对每个类,方法都应详细说明其功能条件,参数等。

类注释中应当包含版本和作者信息。

1)类,接口注释在类,接口定义之前当对其进行注释,包括类,接口的目的,作用,功能,继承于何种父类,实现的接口,实现的算法,使用方法,示例程序等。

2)方法注释以明确该方法功能,作者,各参数含义以及返回值等。

3)其他注释应对重要的变量及不易理解的分支条件表达式加以注释,以说明其含义等。

四命名规范1:对变量,类,接口及包的命名应该使用英文。

严禁使用汉语拼音及不相关单词命名。

更不可以使用汉字来进行命名。

采用大小写混合,提高名字的可读性。

一般应该采用小写字母,但时类和接口的名称的首字母,以及任何中间单词的首字母应该大写。

包名全部小写。

java 开发规范

java 开发规范

java开发规范(一)java命名规范1、变量、成员、方法名统一采用驼峰命名(lowerCamelCase),做到见语知其义例子:变量——用户数据(userList)、方法——getUserData(int type)等。

说明:正常变量定义使用驼峰命名,特殊的如DTO\VO\DO等除外。

2、类名的定义(1)普通类名采用大写字母开始;(2)抽象类采用Abstract或Base开头。

例子:普通类——class UserModel,抽象类——abstract class AbstractUserDefinition等。

3、常量、类型、接口、子类的定义(1)常量使用全大写且单词之间用"_“隔开; (2)boolean变量不能使用is开头;(3)接口尽量不要修饰符、子类紧跟接口追加Impl。

例子:常量——SORT_TYPE,布尔类型——flag,接口——UserService,实现类——UserServiceImpl等。

说明:常量不可组装,需要原子性定义,不能出现"KEY”+SORT_TYPE 这种内部出现。

4、包名、异常、枚举、方法名称的定义(1)包名一律采用小写; (2)异常都采用_Exception结尾; (3)枚举都是以Enum结尾;(4)方法名称——根据方法内容采用如插入insert-*。

例子:异常——UserException,包名——com.test,枚举——UserEnum,方法名称——insertUser等。

5、领域模型定义规范:主要是以VO\DTO\DO等结尾例子:用户数据——UserDTO等(1)数据对象:xxxDO,xxx 即为数据表名。

(2)数据传输对象:xxxDTO,xxx为业务领域相关的名称。

(3)展示对象:xxxVO,xxx一般为网页名称。

(4)POJO是DO/DTO/BO/VO的统称,禁止命名成xxxPOJO。

(二)代码格式规范1、括号代码要求左大括号前不换行、左大括号后换行、右大括号前换行、右大括号后还有else等代码则不换行;表示终止的右大括号后必须换行。

Java开发规范

Java开发规范

Java开发规范信息技术中⼼IT应⽤开发技术规范Java开发规范版权说明本⽂件中包含的任何⽂字叙述、⽂档格式、插图、照⽚、⽅法、过程等内容,除另有特别注明,版权均属太平洋保险所有。

未经许可任何⼈不得将此⽂件中的任何部分以任何形式进⾏复制,储存和传播。

版本记录⽬录1.概述 (1)1.1.⽂档⽬的 (1)1.2.适⽤范围 (1)1.3.⽂档说明 (1)1.4.术语定义 (1)2.技术选型规范 (1)2.1.开发⼯具指南 (2)2.2.J AVA标准 (2)2.3.源代码管理⼯具 (2)2.4.依赖管理⼯具 (2)2.5.第三⽅组件选型 (2)3.总体技术规范 (2)3.1.原则 (2)3.1.1.程序对象重⽤原则 (2)3.1.2.依赖解除原则 (3)3.1.3.常量使⽤原则 (3)3.1.4.第三⽅代码使⽤原则 (3)3.1.5.⾃动代码检查原则 (4)3.1.6.⾃动单元测试原则 (4)3.1.7.⽇志处理原则 (4)3.2.规范 (6)3.2.1.应⽤分层规范 (6)3.2.2.编码字符集规范 (7)3.2.3.项⽬⼯程规范 (7)3.2.4.代码⽬录结构规范 (8)3.2.5.对象命名规范 (9)3.2.6.代码注释规范 (10)3.3.指南 (12)3.3.1.java代码指南 (12)3.3.2.HTML/JAVASCRIPT代码指南 (18)4.展现层技术规范 (19)4.1.原则 (19)4.1.1.事物⼀致性原则 (19)4.1.2.浏览器⽀持原则 (19)4.1.3.插件使⽤原则 (19)4.1.4.信息提⽰原则 (20)5.业务层技术规范 (20)5.1.原则 (20)5.1.1.数据访问分离原则 (20)5.1.2.配置信息分离原则 (20)5.2.规范 (21)5.2.1.业务逻辑层设计规范 (21)5.2.2.编码规范 (21)5.2.3.业务规则与⼯作流规范 (22)6.数据层开发规范 (23)6.1.原则 (23)6.1.1.ORM框架使⽤原则 (23)6.1.2.复杂SQL使⽤原则 (23)6.1.3.存储过程与触发器使⽤原则 (24)6.1.4.数据量控制原则 (24)6.1.5.绑定变量使⽤原则 (25)6.2.规范 (25)6.2.1.DAO层使⽤规范 (25)4.1.1.DAO类注⼊配置规范 (25)4.1.2.实体类代码实现规范 (26)1.概述1.1.⽂档⽬的《中国太平洋保险股份有限公司IT应⽤开发技术规范》(以下简称太保IT开发规范)定义了IT应⽤项⽬开发时应遵循的技术指南,作为各项⽬组的开发指导性指南和代码审查的依据。

Java开发规范

Java开发规范

Java开发规范开发组密级[私人]2011年7月目录Java开发规范 (1)第1章绪论 (6)1.1 目的 (6)1.2 范围 (6)1.3 版权声明 (6)1.4 参考资料 (6)1.5 概述 (6)第2章代码组织与风格 (6)2.1 基本原则 (6)2.2 缩进 (6)2.3 长度 (7)2.4 行宽 (7)2.5 间隔 (7)2.6 对齐 (7)2.7 括号 (8)第3章注释 (9)3.1 基本原则 (9)3.2 JavaDoc (9)3.3 文件与包注释 (9)3.4 类、接口注释 (10)3.5 方法注释 (10)3.6 其他注释 (10)3.7 注释参考表 (11)第4章命名 (12)4.1 基本原则 (12)4.2 文件、包 (12)4.3 类、接口 (12)4.4 字段 (13)4.4.1 常量 (13)4.4.2 变量和参数 (13)4.4.3 组件/部件 (13)4.4.4 集合 (13)4.4.5 神秘的数 (13)4.4.6 其他 (13)4.5 方法 (14)4.6 异常 (14)4.7 命名约定表 (14)第5章声明 (17)5.1 基本原则 (17)5.2 包 (17)5.3 类、接口 (17)5.4 方法 (17)5.5 字段 (17)5.6 示例 (18)第6章类与接口 (20)6.1 基本原则 (20)6.2 抽象类与接口 (20)6.3 继承与组合 (20)6.4 构造函数和静态工厂方法 (20)6.5 toString() (20)6.6 Singleton Class (21)第7章方法 (21)7.1 基本原则 (21)7.2 参数和返回值 (22)7.3 输入参数合法性判断原则 (22)第8章表达式与语句 (24)8.1 基本原则 (24)8.2 控制语句 (24)8.3 循环语句 (26)第9章错误与异常 (27)9.1 基本原则 (27)9.2 已检查异常与运行时异常 (27)9.3 异常的传递 (27)9.4 技术服务部异常处理规范 (28)9.5 异常处理范例 (28)第10章测试基本原则 (29)第11章性能与安全 (29)11.1 基本原则 (29)11.2 String与StringBugffer (29)11.3 确定StringBuffer的容量 (30)11.4 集合 (30)11.5 对象 (30)11.6 同步 (30)11.7 final (30)11.8 垃圾收集和资源释放 (31)11.9 使用‘System.arraycopy ()‘代替通过来循环复制数组 (31)第12章附录 (32)12.1 常用缩写简表 (32)第1章绪论1.1 目的本规范的目的是使本组织能以标准的、规范的方式设计和编码。

java开发规范

java开发规范

精品文档精心整理Java开发规范变更履历目录1 前言 (4)2 源代码划分规范 (4)3 模块依赖关系 (5)4 代码签入、签出规则 (5)5 异常处理 (6)6 数据库连接释放 (6)1.前言本文档主要是对Java开发过程中的总体要求,包括源代码的划分规范、模块输出的目标文件、模块的引用规则、代码签入规则等内容。

本文档不涉及编码规范的要求,具体的编码规范请参照相关的文档。

2.源代码划分规范◆J ava的源代码通常分为Java代码和JSP代码,这两类代码通常需要按目录进行区分,然后再在各自的目录下按功能模块进行划分◆目录的命名以能够准确说明该目录含义的英文单词进行命名◆由于有些中间件(如weblogic)是大小写敏感的,因此为保证开发测试环境与发布环境代码的一致性,要求所有包名均以小写英文字母进行命名以下是参考的源代码目录结构:模块目录下的代码结构可以按两类原则进行划分:1、按代码所完成的职能进行划分,如service、manager、dao、bean、tree等2、按代码所实现的功能进行划分,如groupmanager(分组管理)、templatemanager(模板管理)等建议结合以上两种原则进行模块代码的划分,即将对外接口的代码统一进行存在,内部的代码则按功能进行划分,如service(提供外部调用的接口代码)、groupmanager(分组管理)、templatemanager(模板管理)等。

3.模块依赖关系1.模块依赖关系表列示模块/组件间的依赖关系2.各个模块/组件必须按照编译的顺序列出3.定义模块的粒度(比如包、单元、类),以及根据具体项目在模块依赖关系表中表现的粒度的策略模块依赖关系是编译时,确定模块需要前置编译顺序。

通过整理模块依赖关系,可以在进行每日构建时,保证正确的编译完成。

4.代码签入、签出规则◆修改所有代码时都必须先从代码库中进行签出,并对代码库中相关的代码进行加锁,以防止多人同时修改、互相覆盖源代码的情况发生◆所有签入代码库的代码必须保证能够正确的编译通过,对于不完整的代码严禁签入代码库◆所有签入代码库中的代码应将调试代码进行删除或注释,如“System.out.println”等语句5.异常处理◆必须对可能产生异常的代码进行异常捕获(try…except)◆出现异常时,在前台应提供尽量可读的业务性提示,严禁简单的提示类似“操作错误”等无意义的错误信息;同时应在后台打印出错误堆栈以便开发人员进行跟踪解决6.数据库连接释放◆使用数据库连接时必须在使用完连接后关闭相关的资源(包括Connection、Statement、ResultSet),以防止数据库连接泄漏或游标泄漏的情况发生(try…final)××××公司/集团股东财务报销规范鉴于股东身份的特殊性,经董事会研究决定,特出台此报销流程制度以做规范,希各位股东自觉遵守执行:(投进去的钱不可以拿出来,撤资办法有两种:⑴减少注册资本;⑵股东购买)1适用范围:此报销规范适用于参与企业实际经营管理,并担任企业高层管理者的股东人员。

java项目开发规范

java项目开发规范

java项目开发规范————————————————————————————————作者:————————————————————————————————日期:项目开发规范:1、开发人员分工:每人负责一个模块的开发,由后端一直到前端。

实现所有功能。

2、每个人每天必须写出项目进度总结。

3、数据库管理所有数据表格必须一致。

也就是保持数据的一致性。

4、必须遵循命名规范。

能重用的类应尽可能的使用。

5、遵守以下代码规范:1.JAVA 程序编写规范1.1命名规则1.1.1 文件的命名规则请参考各模块相关设计文档。

1.1.2变量的命名规则变量的格式:变量的前缀+变量描述变量前缀数据类型前缀标记Char / signed char chChar[] cUnsigned char uchShort [int] / signed short [int] siUnsigned short [int] usiInt / signed [int] / Int[] iUnsigned [int] uiLong [int] / signed long [int] liUnsigned long [int] uliFloat fDouble dLong double ldEnum enu* pStructure sctUnion unnString szString[] sHashtable hHashtable[] hbVector vboolean b其它数组arr_对象结合对象名各英文单词首字母的缩写1)变量描述的第一个字符必须大写,与前缀区分开,前缀必须小写。

2)数组变量的定义格式,要把数组的前缀放在前面,格式如下:数组前缀+变量的前缀+描述如:NodeList[] arrNLTemp[3] 表示节点列表数组。

3)变量的定义,必须在程序的首部或函数的首部,不允许任意定义变量。

4)变量必须在定义时初始化。

5)变量表达尽量使用英文单词全称,每一单词首字母使用大写。

Java开发规范

Java开发规范

Java开发规范(版本号:V1.0)目录1.引言 (1)1.1目的 (1)1.2内容 (1)1.3修订审批记录 (1)2.总体要求 (1)2.1J AVA程序代码规范 (1)2.1.1命名规范 (1)2.1.2代码规范 (3)2.2代码注释规范 (5)2.2.1文件版权信息 (5)2.2.2类和接口的注释 (5)2.2.3方法的注释 (5)2.2.4初版代码中注释 (6)2.2.5新增代码中注释 (6)2.2.6修改代码中注释 (7)2.2.7XML 文件中注释 (7)1.引言1.1目的为规范项目组的应用开发、解决开发中的代码规范问题和命名规范问题、促进开发工作顺利有序地进行,特制定本开发规范手册。

本文档适用对象为项目开发人员、编码人员、模版编写人员、系统测试人员等。

1.2内容本文主要描述Java程序命名规范、代码规范、注释规范等。

1.3修订审批记录表1-1 文档修订记录表表1-2文档审批记录表2.总体要求2.1Java程序代码规范2.1.1命名规范1)包名命名规范包名必须均为小写。

包名需要使用英文说明包内代码功能,不能采用、拼音。

具体示例如下:以 com.xxx.apimanager.web 为例:第一段 com 代表公司,org 代表组织。

第二段第二段 xxx 为公司名称 xxx。

第三段第三段 apimanager 为项目名称。

第四段四段 web 为模块名称(分层)。

对于与各项目之间的通用包如 util 包、 db 包直接隶属于xxx.apimanager 包下。

通用包的内的代码必须不依赖于任何项目,可独立编译。

2)文件名命名规范Java 文件名称必须以大写字母开头,可以使用 2-4 个英文单词(尽量不要用缩写)组成每个单词的首字母大写。

文件名称必须能说明文件内代码功能。

对 java 文件大致分为接口,实现类,模型,静态类型声明,逻辑类,工具类。

a)接口类命名:IxxxxInterFace。

java开发规范

java开发规范

java开发规范
Java 开发规范
1.命名规范:
(1)包名要求全部小写;
(2)类名使用驼峰表示法,首字母大写;
(3)方法名驼峰表示法,首字母小写;
(4)常量字段名较长的是全部大写,单词之间用下划线分隔;
(5)变量命名使用驼峰表示法,文件名也采用驼峰表示法;
2. 代码组织规范:
(1)类前必须有注释,包含类名,作者,日期,简要说明;
(2)public 的内部类或内部接口类前也需要有注释;
(3)新增方法或变量必须添加注释,说明方法或变量的作用;
(4)不使用编译器警告选项,必须对所有的编译器的警告进行处理;
3. 代码规约:
(1)一行只放一条语句,行长不能超过80个字符;
(2)在表达式中间,每个运算符两侧必须有一个空格;
(3)每个代码块左括号前加一个空格,右括号后加一个空格;
(4)if,while 等关键字后面都加一个空格;
(5)使用Javadoc标准,保证各类、方法和字段都有完整的注释;
4. 代码质量控制:
(1)按照具体的代码质量控制规则,进行代码质量检查;
(2)特定的文件以特定的编码格式编辑,不得混用;
(3)代码不得包含未使用的变量,常量,导入和类;
(4)保证可ログ出力:必要的情况下,可以进行日志记录,定位代码运行情况;
(5)保证可测试:针对每个实现模块,提供单元测试,检查代码可靠性;。

Java软件开发规范

Java软件开发规范

JAVA软件开发规范一、绪论1.1概述随着公司上ERP项目,为统一开发技术规范,缩短开发周期,进一步提高项目质量,降低后期维护难度,迫切需要一个更完善、专业、有效的开发规范。

本规范的目的是使本科室JAVA开发能以统一、标准的、规范的方式设计和编码。

通过建立开发规范,使每个开发人员养成良好的开发风格和习惯;提高程序的可靠性、可读性、可维护性和一致性等,提高程序员的开发水平,增进团队间的交流,并保证软件产品的质量。

1.2适用范围本规范适用于本公司所有JAVA软件项目、产品等的设计、开发以及维护等。

所有JAVA软件开发人员在整个软件开发过程中必须遵循此规范。

二、总体框架2.1框架概述本公司JAVA开发的软件产品多为B/S结构,涉及多个层面的开发,为便于逻辑分离及项目分工,开发的软件产品应当符合MVC设计模式,基础框架使用SSH(spring+hibernate+struts2)MVC基础框架。

2.2框架规范旧框架中Servlet层应当仅负责宏观层面的业务逻辑,不进行具体的数据访问,新框架中Action组件负责事务同旧框架中的Servlet层组件。

Model由开发人员自己实现。

hibernate是将原来的 DAO部分,就是数据库部分,进行数据持久化,可以理解为数据库的接口和对数据库的操作之一。

spring是管理容器的角色,降低耦合度,方便管理。

2.2.1 Hibernate DAO规范DAO为数据访问组件,用于访问持久性数据,例如为关系型数据库。

本规范要求DAO对象必须直接或间接继承数据访问组件的基础类com.yonggang.framework.hibernate.HibernateDAOSupport ,该基类已经实现了hibernate通用的查询,更新,插入,删除,分页查询等操作,业务类继承该类后即可使用HibernateDAOSupport提供的hibernate数据库操作方法。

DAO处理完正常逻辑后设置本次处理后用于界面提示的消息。

java开发规范文档

java开发规范文档

java开发规范文档
以下是一个简单的Java开发规范文档:
1. 命名规范:
- 类名使用首字母大写的驼峰命名法,如:MyClass
- 方法名以小写字母开头的驼峰命名法,如:myMethod
- 变量名使用小写字母开头的驼峰命名法,如:myVariable - 常量名使用全大写字母和下划线的命名法,如:
MY_CONSTANT
2. 缩进和格式:
- 使用4个空格进行缩进
- 在每一行结束后使用分号
- 在大括号的前面留空格,如:if (condition) {
- 在逗号后面留空格,如:int a, b, c;
3. 注释规范:
- 使用JavaDoc格式注释解释类、方法和变量的功能和用法 - 在代码中适当添加注释,解释代码的实现逻辑
4. 异常处理:
- 使用try-catch-finally语句块来处理异常
- 不要使用空的catch块,尽量提供明确的异常处理逻辑
5. 最佳实践:
- 使用面向对象的思想设计代码结构
- 避免使用全局变量,尽量使用局部变量和参数传递数据
- 不要在循环中创建对象,尽量在循环外部创建对象
- 使用合适的数据结构和算法来提高性能
这只是一个简单的Java开发规范文档,实际中可以根据团队的需求和项目的特点进行适当的修改和补充。

JAVA技术架构及开发规范文档

JAVA技术架构及开发规范文档

JAVA技术架构及开发规范文档一、概述二、技术架构1.三层架构基于业务功能的划分,将系统划分为表示层、业务逻辑层和数据持久层。

这样可以实现业务逻辑与表示层、数据持久层的解耦,提高代码的复用性和可维护性。

2.MVC模式使用MVC(Model-View-Controller)模式进行开发,将系统分为模型层、视图层和控制层,使各层之间的职责分明,提高代码的可维护性和可测试性。

3.面向对象设计原则遵循SOLID原则,尽量使用面向对象的设计和编程,其中包括单一职责原则、开闭原则、里式替换原则、接口隔离原则和依赖反转原则等。

三、开发规范1.命名规范采用驼峰命名法,变量名、方法名、类名等均应具有描述性,避免使用拼音或缩写。

2.代码风格代码应该具有良好的缩进和格式,增加代码的可读性。

要求适当添加注释,注释应说明代码的目的和使用注意事项。

3.异常处理合理处理异常,避免直接抛出异常,而是进行捕获和处理。

对于特定的业务异常,可以定义自定义异常类,并进行抛出。

4.注释规范需要对代码进行充分的注释,注释的风格应明确,注释应配合代码,解释代码的用途和作用。

5.单元测试开发过程中应进行单元测试,确保代码的正确性。

对于每个功能模块,编写相应的单元测试用例进行测试,覆盖率应尽量达到100%。

6.安全性对于涉及到的用户输入数据和敏感数据,应进行有效的验证和过滤,防止恶意注入和跨站脚本攻击等安全威胁。

7.日志规范所有的关键操作和错误信息都应记录到日志中,日志级别应根据实际需要进行配置。

8.数据库规范数据库表设计应符合第三范式,避免数据冗余和数据不一致。

使用参数化查询和预编译语句,提高数据库查询性能和安全性。

9.版本管理使用版本管理工具(如Git)进行代码管理,每个开发人员都应具备良好的版本管理和协同开发能力。

四、总结本文档主要介绍了JAVA技术架构及开发规范。

通过采用三层架构和MVC模式,可以实现代码的复用性和可维护性。

同时,遵循JAVA的面向对象设计原则,提高代码的可测试性和可扩展性。

Java开发写规范文档

Java开发写规范文档

JAVA源程序文件结构表示方法:
(1)原则上1行最大为80或90个文字。

(2)缩格4列(空4格,不等同于TAB,TAB在不同编辑器中有不同规定)为1个单位。

(3)大括号[{}]与开始处理位置对齐。

(4)程序按以下顺序进行表示。

a)文件注释
b)定义包语句(Package statement)
c)Import语句(Import statement)顺序
i.JDK软件包
ii.其它公司软件包
iii.本系统定义的包
d)类的声明
e)变量的声明(顺序)
i.类常量
ii.类变量
iii.实例变量
f)方法群(methods)顺序
i.构造方法(constructor)
ii.类的操作方法
iii.覆盖方法(overwrite)
iv.上述以外的方法
g)类的一般书写格式(例):
JSP源程序文件结构表示方法:
(5)HTML缩格2列,JSP缩格4列(空2格或4格,不等同于TAB,TAB在不同编辑器中有不同规定)为1个单位。

(6)JSP标记[<%%>]成对对齐。

(7)程序示例。

Java开发规范(参照阿里规范改编)

Java开发规范(参照阿里规范改编)

Java开发规范(参照阿⾥规范改编)JAVA 开发规范v1.0.0 2021/08/27本篇规范基于阿⾥巴巴、华为的开发⼿册,补充了⼀些细节。

规范不是为了约束和禁锢⼤家的创造⼒,⽽是为了帮助⼤家能够在正确的道路上,尽可能的避免踩坑和跑偏。

规范可以让我们⽆论单枪匹马还是与众⼈同⾏的时候都能得⼼应⼿。

规范可以让我们在⾯对⽇益变态的需求和做代码接盘侠的时候,更优雅从容。

⼀、编程规范1、好代码的原则我们参考 Kent Beck 的简单设计四原则来指导我们的如何写出优秀的代码,如何有效地判断我们的代码是优秀的。

通过所有测试(Passes its tests):强调的是外部需求,这是代码实现最重要的尽可能消除重复 (Minimizes duplication):代码的模块架构设计,保证代码的正交性,保证代码更容易修改尽可能清晰表达 (Maximizes clarity):代码的可阅读性,保证代码是容易阅读的更少代码元素 (Has fewer elements):保证代码是简洁的,在简洁和表达⼒之间,我们更看重表达⼒以上四个原则的重要程度依次降低,这组定义被称做简单设计原则。

22-1全部采⽤⼩写⽅式,以中划线分隔。

正例:mall-management-system / order-service-client / user-api反例:mall_management-system / mallManagementSystem / orderServiceClient2-2模块名称:{项⽬名称}-{模块名称} 模块名称简洁体现职责模块名字作为模块组件的名称(即maven中的标签)2-3包名不应该⽤来表达模块完整的意思,包名应该仅⽤作与同包下的其他包做区分。

但尽可能使⽤单个单词命名,如果单个单词⽆法正确表达,可采⽤.分割,实在不⾏可采⽤全部单词⼩写(参考的spring命名)2-4类名使⽤ UpperCamelCase 风格,必须遵从驼峰形式,但以下情形例外:DO / BO / DTO / VO / AO ;抽象类命名使⽤ Abstract 或 Base 开头;异常类命名使⽤ Exception 结尾;测试类命名以它要测试的类的名称开始,以 Test 结尾;如果使⽤到了设计模式,建议在类名中体现出具体模式;枚举类名建议带上 Enum 后缀,枚举成员名称需要全⼤写,单词间⽤下划线隔开。

JAVA开发规范文档

JAVA开发规范文档

JAVA开发规范文档引言:为了提高JAVA开发效率和可维护性,降低开发过程中的错误率,特制定此开发规范文档。

本规范适用于所有JAVA开发项目,包括前端、后端和移动端开发。

1.命名规范1.2 类名:采用驼峰命名法,首字母大写,如UserService。

1.3 方法名:采用驼峰命名法,首字母小写,如getUserList。

1.4 变量名:采用驼峰命名法,首字母小写,如userName。

1.5常量名:全部大写,使用下划线分隔,如MAX_COUNT。

1.6 接口名:采用驼峰命名法,首字母大写,如UserService。

1.7 枚举名:采用驼峰命名法,首字母大写,如ColorType。

2.注释规范2.2方法或代码块内应有必要的注释,解释方法的功能和输入输出参数的含义。

2.3注释要简洁明了,不得使用拗口难懂的词汇。

2.4注释要与代码保持同步更新。

3.代码风格规范3.1缩进:使用4个空格进行缩进,不得使用制表符。

3.2行宽:每行代码不得超过120个字符。

3.3空行:合理使用空行,以提高代码的可读性。

3.4操作符前后空格:操作符前后必须有一个空格,如a=b+c。

3.5大括号位置:大括号应该独占一行,且与前面的语句间有一个空格。

3.6代码块注释:使用//或/*...*/对代码块进行注释,描述代码块的功能和作用。

3.7异常处理:所有异常都需要捕获处理,不允许直接忽略异常。

3.8类内方法的顺序:构造方法、公有方法、私有方法,按照方法访问权限从公有到私有的顺序排列。

4.代码规范4.1不允许出现未使用的变量和方法。

4.2不允许出现硬编码的常量,应使用常量定义。

4.3 字符串拼接使用StringBuilder或StringBuffer,避免使用+操作符。

4.4尽量使用接口和抽象类进行编程,而不是具体实现类。

4.5 使用try-with-resources来释放资源,如文件流、数据库连接等。

4.6尽量使用JDK提供的集合类,避免使用原生数组。

开发规范_JAVA程序编写规范

开发规范_JAVA程序编写规范

Java程序开发书写规范【注意】每一个在公司使用Java语言从事系统开发工作的新员工必须首先阅读本文件,并在工作中严格按照本文件的说明进行源程序书写。

目录程序开发书写规范 (1)1. 文件头部注释 (2)2. 类头部注释 (3)3. 方法头部注释 (4)4. 命名规范 (5)5. 示例程序........................................................................ 错误!未定义书签。

6. 注意事项 (5)1.文件头部注释说明:在所有程序文件的头部,都应有此注释。

格式:2.类头部注释说明:在类的源程序文件中,都应有此注释。

该注释必须位于类定义的上方,导入说明(import语句)的下方格式:3.方法头部注释说明:在程序文件中所有public方法的头部,都应有此注释。

格式:注:文中带<>的部分必须填写。

“[]”为可选项,只在必要时填写其中“/**”“@param”和“@return”等蓝色字体必须按照标准书写4.命名规范在java程序中:●日期格式为“yyyy-mm-dd”●时间格式为:“yyyy-mm-dd hh:mm:ss”5.注意事项在实际工作中,必须严格按照本标准说明中的规范进行书写,尤其注意以下注释的格式:●注释开始符号必须为“/**”,●对于参数的说明必须使用“*@param”开始,并另起一行书写具体参数列表●每一参数说明使用独立的“*@param”标志●返回值说明必须使用“*@return”开始,并另起一行书写返回值说明正确的源程序书写格式,可以保证使用jdk的文档生成工具javadoc生成正确合适的文档,而省去编撰开发文档的麻烦。

JAVA开发规范

JAVA开发规范

JAVA开发规范1. 引言 (3)1.1. 编写目的 (3)1.2. 编写原因 (3)2. 格式规范 (3)2.1. 缩进 (3)2.2. 间隔 (3)2.3. 空行 (3)2.4. 花括号 (4)2.5. 控制语句 (4)2.6. 类成员的摆放顺序 (4)2.7. 文件格式 (5)2.8. 行最大长度 (5)3. 命名规范 (5)3.1. 包 (5)3.2. 类和接口 (5)3.3. 对象 (5)3.4. 数组 (5)3.5.Static Final 变量 (6)3.6. 循环计数变量 (6)3.7. 其他标识符 (6)3.8. get和set方法 (6)3.9. 构造方法 (6)3.10. toString方法 (6)3.11. main方法 (7)4. 注释规范 (7)4.1. 类的整体注释 (7)4.2. 类中方法的注释 (7)4.3. 行注释 (7)4.4. 块注释 (8)4.5. 注释内容 (8)5. HTML标记语言编写规范 (8)5.1. 标记的换行规范 (8)5.2. 标记的关闭规范 (8)5.3. 标记的属性赋值规范 (8)5.4. 标记的缩进规范 (9)6. JavaScript编写规范 (9)6.1. 变量命名规范 (9)6.2. 变量使用规范 (10)6.3. 对象命名规范 (10)6.4. 函数命名规范 (10)7. 其它 (10)7.1. 数据库连接规范 (11)7.2. 例外控制规范 (11)7.3. 方法返回类型规范 (11)7.4. JSP文件命名规范 (11)7.5. 尽量使用接口而不是一个具体的类 (11)7.6. 避免太多的使用synchronized 关键字 (12)7.7. 使用StringBuffer而不用String (12)7.8. 变量名前缀的约定 (12)7.9. JSP编码注意事项 (12)7.10. 采用STRUTS框架开发B/S软件的注意事项 (13)1.引言1.1.编写目的本文档主要是为JAVA开发人员提供一个源代码书写标准,以及程序和文件的命名标准,使他们在编程时有一致格式可遵循。

Java 开发规范

Java 开发规范

Java开发规范1. 说明本文对《Web 应用系统开发规范》作适当扩充,规定了Java编程的规范,主要包括命名、注释、排版、语句、设计、常用类以及日志规范。

统一规范的格式有利于项目的交付和后续维护。

本文档适用于所有以Java为开发语言的定制开发应用系统。

2. 命名规范命名规范使程序易读,从而更易于理解。

2.1. Package的命名规范2.1.1. Package名要使用小写字如无特殊规定,请将Package名统一成小写字。

这是Java的一般规则。

例如:2.1.2. Package名要有意义尽量给Package命名一个能联想到Package内容的名字。

如果使用功能ID、流水号等来命名Package的话,不能马上明白其意思。

遵守此规范,将提高代码的易读性。

例如:2.1.3. Package名不应缩写即使Package名长,也请尽量不要缩写,而使用易懂的名字。

例如:2.1.4. Package名的组成标准的package名分为三部分:<公司名>.<应用系统名>.<模块名>,本公司<公司名>均使用com.citicpru。

例如:march.domain//存放DTO,POJO,JA V ABEANcom.nemtarch.spring//存放Spring的相关文件march.struts.actin//存放struts的ACTION类march.struts.form//存放struts的FORM类march.filter //存放过滤器,如session过滤器,字符过滤器等march.listener //存放监听器,如访问流量监听器,商业软件中的配置文件读取监听器march.util //存放公用的类库,以后完善了我们公司的类库过后,就可以只用导入一个JAR包就可以啦march.maps //存放iBATIS的XML配置文件march.interface //存放接口类march.infaimpl //存放接口实现类(这个可以根据需要,也可以用march.dao)march.dao //实体操作类march.abst //存放抽象类march.hibernate//存放hibernate相关类march.test //存放的测试类march.service //业务接口外部调用类mon //基本配置类march.excel //生成EXCEL的操作类(根据项目的不同,下面可以再添加相关的包,这个可以由PM来决定)2.2. Class命名规范2.2.1. Class的名称应该是一个名词短语Class的名称应是“形容词/名词+名词”的形式。

java开发规范文档

java开发规范文档

java开发规范文档Java开发规范文档一、命名规范:1.类名使用大驼峰命名法,首字母大写。

2.方法名使用小驼峰命名法,首字母小写。

3.变量名使用小驼峰命名法,首字母小写。

4.常量名使用全大写字母,多个单词之间用下划线连接。

二、代码风格规范:1.代码缩进使用4个空格,不使用制表符。

2.每行代码尽量不超过80个字符。

3.每个方法应该有注释说明其作用。

4.使用行注释或块注释对代码进行注释。

三、类结构规范:1.每个源文件只包含一个类,类名与文件名保持一致。

2.类的字段应该在声明处进行初始化。

3.类的方法按照功能进行分组,相似功能的方法放在一起。

4.类的字段和方法应该用private修饰,对外提供访问的方法使用public修饰。

四、包规范:1.包名采用小写英文字母,多个单词之间用点号(.)分隔。

2.包名应该能够反映出所包含类的功能和用途。

五、注释规范:1.源文件开头应该包含版权声明和作者信息。

2.对于每个类、方法及其参数,应该提供注释,说明其作用和用途。

3.注释应该简洁明了,尽量使用英文。

六、异常处理规范:1.不要在catch块中使用空的catch块。

2.能够处理的异常应该在模块内进行处理,不能处理的异常应该抛出。

七、代码排版规范:1.应该将相关的变量和方法放在一起。

2.应该根据代码逻辑来进行代码的排版,让代码易于阅读。

八、代码复用规范:1.不要重复编写相同功能的代码,应该进行代码复用。

2.可以将公共的代码封装成方法或类,供其他地方使用。

九、版本控制规范:1.使用版本控制工具进行源代码的管理。

2.提交代码前进行代码的版本比较和合并。

以上是Java开发规范的一些常见规范,开发人员应该遵守这些规范,以便提高代码的可维护性和可读性。

规范的遵守可以减少代码的错误和提高代码的质量,有助于团队的合作和项目的开发进度。

java开发规范文档

java开发规范文档

一千零一夜产品部系统开发规范V1.0一千零一夜途遇科技有限公司2015-11-03修改记录目录1前言 (4)2开发管理 (4)3项目周期 (4)4命名规范 (5)4.1项目编号命名规范 (5)4.2文档命名规范 (5)4.3路径管理 (5)4.4jsp/html命名规范 (6)4.5数据库命名规范 (8)4.5.1表名规范 (8)4.5.2字段规范 (8)5文档规范 (8)6代码规范 (9)6.1Java源代码规范 (9)6.1.1命名 (9)6.1.2代码格式 (11)6.1.3注释 (12)6.1.4其他 (13)6.2jsp/html代码规范 (13)6.3数据库开发规范 (15)6.3.1主键 (15)6.3.2日期类型 (16)6.3.3固定字段 (16)6.3.4取值规范 (16)6.3.5数据库开发工具 (16)6.3.6Sql书写规范 (17)6.4其他规范 (17)7实战代码规范 (18)7.1Java源代码规范 (18)7.1.1java代码命名与格式 (18)7.2jsp/html代码规范 (26)8FAQ (29)8.1Logic类中新增数据方法怎么写 (29)8.2Logic类中修改数据方法怎么写 (30)8.3Logic类中删除数据方法怎么写 (31)8.4怎样创建一个没有底部按钮的窗口 (32)8.5怎样设置弹出窗口的标题 (32)8.6怎样重写提交数据的方法 (33)8.7怎样创建单grid的页面 (33)8.8怎样多个页签的grid的页面 (34)8.9怎样创建左边树右边grid的页面 (34)9代码检查规定 (34)10附录1:JPA使用指南javax.persistence的注解配置 (34)1前言为了使软件开发过程有章可循,保证软件质量,加强开发管理。

2开发管理3项目周期公司项目开发周期分为以下几个步骤:4命名规范4.1 项目编号命名规范4.2 文档命名规范4.3 路径管理路径结构如下:项目名称|_database(数据库数据)|_docs(文档)|_参考文档(项目参考文件)|_需求&设计(需求文件及各种设计文档)|_开发计划|_软件测试|_部署&培训|_工作汇报|_trunk(主目录)|_WebRoot(应用文件)|_src(源代码)|_业务模块一(某一个功能分类,如工具类)|_com.navinfo.分类英文名(源代码目录)||_entity (数据模型)|_logic (逻辑实现类)|_services (逻辑接口层)|_action (Action层)|_utils(当前功能的工具类或常量定义)|_|_spring/ (spring的配置文件)|_hibernate/ (hibernate的配置文件)|_struts/ (struts的配置文件)|_quartz/ (quartz的配置文件)注,红色字体的部分和原有规范不同,主要是业务模块和配置文件放在同一个根目录下,为防止eclipse的配置顺序导致源代码和配置文件分离的很远。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

一千零一夜产品部系统开发规范V1.0一千零一夜途遇科技有限公司2015-11-03修改记录目录1前言 (4)2开发管理 (4)3项目周期 (4)4命名规范 (5)4.1项目编号命名规范 (5)4.2文档命名规范 (5)4.3路径管理 (5)4.4jsp/html命名规范 (6)4.5数据库命名规范 (8)4.5.1表名规范 (8)4.5.2字段规范 (8)5文档规范 (8)6代码规范 (9)6.1Java源代码规范 (9)6.1.1命名 (9)6.1.2代码格式 (11)6.1.3注释 (12)6.1.4其他 (13)6.2jsp/html代码规范 (13)6.3数据库开发规范 (15)6.3.1主键 (15)6.3.2日期类型 (16)6.3.3固定字段 (16)6.3.4取值规范 (16)6.3.5数据库开发工具 (16)6.3.6Sql书写规范 (17)6.4其他规范 (17)7实战代码规范 (18)7.1Java源代码规范 (18)7.1.1java代码命名与格式 (18)7.2jsp/html代码规范 (26)8FAQ (29)8.1Logic类中新增数据方法怎么写 (29)8.2Logic类中修改数据方法怎么写 (30)8.3Logic类中删除数据方法怎么写 (31)8.4怎样创建一个没有底部按钮的窗口 (32)8.5怎样设置弹出窗口的标题 (32)8.6怎样重写提交数据的方法 (33)8.7怎样创建单grid的页面 (33)8.8怎样多个页签的grid的页面 (34)8.9怎样创建左边树右边grid的页面 (34)9代码检查规定 (34)10附录1:JPA使用指南javax.persistence的注解配置 (34)1前言为了使软件开发过程有章可循,保证软件质量,加强开发管理。

2开发管理3项目周期公司项目开发周期分为以下几个步骤:4命名规范4.1 项目编号命名规范4.2 文档命名规范4.3 路径管理路径结构如下:项目名称|_database(数据库数据)|_docs(文档)|_参考文档(项目参考文件)|_需求&设计(需求文件及各种设计文档)|_开发计划|_软件测试|_部署&培训|_工作汇报|_trunk(主目录)|_WebRoot(应用文件)|_src(源代码)|_业务模块一(某一个功能分类,如工具类)|_com.navinfo.分类英文名(源代码目录)||_entity (数据模型)|_logic (逻辑实现类)|_services (逻辑接口层)|_action (Action层)|_utils(当前功能的工具类或常量定义)|_|_spring/ (spring的配置文件)|_hibernate/ (hibernate的配置文件)|_struts/ (struts的配置文件)|_quartz/ (quartz的配置文件)注,红色字体的部分和原有规范不同,主要是业务模块和配置文件放在同一个根目录下,为防止eclipse的配置顺序导致源代码和配置文件分离的很远。

|_业务模块二|_......示例:图:Src路径4.4 jsp/html命名规范jsp与html文件名全部小写,并遵循如下的规范:数据/内容显示页名词,多个单词用下划线分隔,要求能说明显示内容的信息,为避免冲突,可加上"_list"。

例如:new_message.html 或my_file_list.jsp操作处理页命名格式:名词_下划线_动词,例如:file_delete.jsp。

图:Jsp命名含frame页面<frameset>中<frame>的name属性命名的格式是①xxx._②xxx_③xxx①xxx部分用来标识当前页面隶属于整个系统中的哪一功能模块。

如:属于ebwebmail则被表示为ebwebmail,其它情况依次类推。

②xxx部分标识当前页面所要完成的功能。

如:完成用户登录的功能则被标识为login,其它情况依次类推。

③xxx部分用来用来表示页面在浏览器窗口所处的位置。

处于浏览器窗口的顶部则标识为top,其它情况依次类推。

例如:ebwebmail_inbox_top.jsp<frame> src属性相应的文件名根据情况建议在原命名规范上用下划线加上所处窗口的位置。

javascript脚本方法脚本函数都以①xxx_②xxx的方式命名。

①xxx对应页面隶属的模块。

②xxx表示函数所要实现的功能(动宾结构),多个单词用下划线连接。

例如:ebwebmail_send_mail()模块通用的脚本函数必须集合于一个js文件中,在页面上通过<script language="javascript" src="url"></script>形式导入。

js文件名命名使用模块名,例如:ebwebmail.js。

如果项目已经提供了公共js脚本,则优先使用公共js脚本中提供的函数。

所有定义方法的<script>元素定义在<head></head>中或</body>后。

javascript脚本内部变量与参数单词之间用下划线分隔且全部小写,例如:var file_size。

<form>表单name属性除系统模版生成的form外,统一以"form_"开头,其后加该表单所需收集的信息的作用或动作,例如:form_file_upload 或form_send_mail。

表单elements表单element的名称以element需收集的信息标示命名,单词之间使用下划线分隔且全部小写,例如:<input type="text" name="username"><input type="radio" name="file_type"><textarea name="content" rows="5" cols="40">cookie命名命名格式:模块名_存储信息名词(多个单词用下划线分隔) ,全部大写,例如:EBWEBMAIL_SORT_TYPE。

window.open中name参数的命名javascript 的window.open方法中有一个name的参数,浏览器约定同样的名字的窗口只能打开一个,如果程序间名字重复将相互冲突。

如果不限制打开窗口数,可以指定''或""(不是null),否则需要加上模块名,例如ebwebmail_viewmail。

4.5 数据库命名规范4.5.1表名规范关于命名的规范,统一使用大写,单词之间用下滑写,采用三段式或者二段式。

a)头一段标识数据库对象类型(T-表, V-视图,SP-存储过程,TR-触发器)b)二段标识业务的类型,详见《四维产品体系.mmap》c)三段和四段标识表的属性。

(订单:ORDERS,计划:PLANS,路线:ROUTES)例如:系统用户表,系统用户状态字典表(T_CP_URERS_STATES),订单表(T_BD_BLL_ORDERS)4.5.2字段规范所有表示boolean含义的字段,在前方需要加入IS_前缀5文档规范编写文档目前主要使用的工具是Word(项目计划文档例外,需要使用Project制作,项目计划文档为非技术的客户提供Excel版本),辅助使用的工具有Visio,PowerPoint等。

⏹所有Office文档均使用Office2003兼容格式文档。

⏹文档务必保持段落格式整齐,文字字体,颜色,大小统一。

⏹如果需要摘引html页面中的内容,不能直接从html中粘贴过来(会在word文档中留下html格式),而必须先去除格式,例如:先粘贴到notepad中。

⏹务必注意中英文标点符号,文档正文一概使用中文标点符号。

⏹如果需要在文档中插图,不要使用word自带的绘图工具。

可以选择使用PowerPoint或visio。

使用PowerPoint,选择"插入"- >"对象"->"Microsoft PowerPoint 幻灯片"。

使用visio,需要另外建立visio文档,绘制完以后粘贴到word中。

Visio不得在word文档上的Visio对象上进行修改,要在源文件上修改后粘贴到word文档上。

⏹数据建模使用PowerDesigner工具。

在项目进入开发阶段后,所有的的对PowerDesigner的修改需要同时提供相应修改的sql语句,并放到系统的文档目录下。

对数据建模的文档修改,需要由项目经理统一进行,防止发生版本不统一的情况。

⏹修改他人文档务必使用修订模式,以便保留备修改的内容。

使用修订模式,选择"工具"->"修订"->"突出显示修订",勾上"编辑时标记修订"。

6代码规范6.1 Java源代码规范6.1.1命名6.1.1.1 Package 的命名Package 的名字应该都是由一个小写单词组成,例如:com.navinfo. backplatform。

此外,对于包名我们做如下约定:⏹工具函数类包名前缀为.utils⏹test case类包名前缀为.test图:工具类包结构6.1.1.2 Class 的命名Class 的名字必须由大写字母开头而其他字母都小写的单词组成,例如:DataFile或InfoParser。

⏹Class 变量的命名变量的名字必须用一个小写字母开头。

后面的单词用大写字母开头,例如:debug 或inputFileSize。

⏹Static Final 变量的命名Static Final 变量的名字应该都大写,并且指出完整含义,例如:MAX_UPLOAD_FILE_SIZE=1024。

⏹参数的命名参数的名字必须和变量的命名规范一致。

⏹数组的命名数组应该总是用下面的方式来命名:byte[] buffer;而不是:byte buffer[];⏹方法的参数使用有意义的参数命名,如果可能的话,使用和要赋值的字段一样的名字:SetCounter(int size){this.size = size;}6.1.2代码格式6.1.2.1 文件头声明源文件的头部需要一个history段,对于每次对源文件的重大改动,都需要在history段中注明。

该段定义在package和import之间,例如:/****************************************************** HISTORY* 功能描述:* 2002/01/29 Biz 创建文件** 2002/02/19 kevin 增加新功能********************************************************/代码块书写格式可以选择以下任意一种代码块的书写方式:if (true){//body}if (true){//body}建议使用第一种书写方式。

相关文档
最新文档