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)保证可测试:针对每个实现模块,提供单元测试,检查代码可靠性;。

  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}建议使用第一种书写方式。

相关文档
最新文档