下载文档原格式
1 Java 编程规范1.1 排版1.1.1 规则规则1程序块要采用缩进风格编写，缩进的空格数为4个，不允许使用TAB缩进。
(1.42+)说明：缩进使程序更易阅读，使用空格缩进可以适应不同操作系统与不同开发工具。
规则2分界符（如大括号‘{’和‘}’）应各独占一行，同时与引用它们的语句左对齐。
在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序或者static、,synchronized等语句块中都要采用如上的缩进方式。
(1.42+) 示例:if (a>b){doStart();}规则3较长的语句、表达式或参数（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。
(1.42+)示例：if (logger.isDebugEnabled()){logger.debug("Session destroyed,call-id"+ event.getSession().getCallId());}规则4不允许把多个短语句写在一行中，即一行只写一条语句(1.42+)说明：阅读代码更加清晰示例：如下例子不符合规范。
Object o = new Object(); Object b = null;规则5if, for, do, while, case, switch, default 等语句自占一行，且if, for, do, while,switch等语句的执行语句无论多少都要加括号{},case 的执行语句中如果定义变量必须加括号{}。
(1.42+)说明：阅读代码更加清晰，减少错误产生示例：if (a>b){doStart();}case x:{int i = 9;}规则6相对独立的程序块之间、变量说明之后必须加空行。
(1.42+)说明:阅读代码更加清晰示例：if(a > b){doStart();}//此处是空行return;规则7在两个以上的关键字、变量、常量进行对等操作时，它们之间的操作符之前、之后或者前后要加空格；进行非对等操作时，如果是关系密切的立即操作符（如.），后不应加空格。
Java编程规范总结命名：1. 为包、类、⽅法、变量取⼀个好名字，使代码易于理解2. 禁⽌使⽤魔⿁数字3. 常量命名，由全⼤写单词组成，单词间⽤下划线分隔，且使⽤ static final修饰4. 变量、属性命名，使⽤名词，并采⽤⾸字母⼩写的驼峰命名法5. ⽅法的命名，⽤动词和动宾结构，并采⽤⾸字母⼩写的驼峰命名法6. 类和接⼝的命名，采⽤⾸字母⼤写的驼峰命名法7. 包的命名，由⼀个或若⼲个单词组成，所有的字母均为⼩写8. 数组声明的时候使⽤ int[] index，⽽不要使⽤ int index[]注释：1. 尽量⽤代码来解释⾃⼰2. 注释应解释代码的意图，⽽不是描述代码怎么做的3. 保证注释与代码⼀致，避免产⽣误导4. 注释应与其描述代码位置相邻，放在所注释代码上⽅或右⽅，并与代码采⽤同样缩进5. 不要⽤注释保留废弃代码6. 不要⽤注释记录修改⽇志7. ⼀般单⾏注释⽤//，块注释⽤，JavaDoc注释⽤排版：1. 团队应遵守⼀致的排版风格2. 将排版风格固化到IDE的代码格式化配置⽂件中，并让整个团队使⽤3. 在不同的概念之间，增加空⾏4. 将逻辑紧密相关的代码放在⼀起5. 控制⼀⾏的宽度，不要超过120个字符6. 在不同的概念间（关键字、变量、操作符等）增加空格，以便清楚区分概念7. 采⽤缩进来区分不同层次的概念8. 将局部变量的作⽤域最⼩化9. 给if、for、do、while、switch等语句的执⾏体加⼤括号{}10. 控制⽂件的长度，最好不要超过500⾏变量和类型：1. 谨慎使⽤静态成员变量2. 避免随意进⾏类型强制转换，应改善设计，或在转换前⽤instanceof进⾏判断33. 需要精确计算时不要使⽤float和double4. 不能⽤浮点数作为循环变量5. 浮点型数据判断相等不能直接使⽤==6. 避免同⼀个局部变量在前后表达不同的含义7. 不要在单个的表达式中对相同的变量赋值超过⼀次8. 基本类型优于包装类型，注意合理使⽤包装类型⽅法：1. ⽅法设计的第⼀原则是要短⼩2. ⽅法设计应遵循单⼀职责原则（SRP），⼀个⽅法仅完成⼀个功能3. ⽅法设计应遵循单⼀抽象层次原则（SLAP）4. ⽅法设计应遵循命令与查询职责分离原则（CQRS）5. 不要把⽅法的⼊参当做⼯作变量/临时变量，除⾮特别需要6. 使⽤类名调⽤静态⽅法，⽽不要使⽤实例或表达式来调⽤7. 应明确规定对接⼝⽅法参数的合法性检查由调⽤者负责还是由接⼝⽅法本⾝负责8. ⽅法的参数个数不宜过多9. 谨慎使⽤可变数量参数的⽅法包、类和接⼝：1. 类和接⼝的设计应遵循⾯向对象SOLID设计原则2. 类的设计应遵循迪⽶特法则3. 类的设计应遵循“Tell，Don't ask”原则4. 类设计时优选组合⽽不是继承5. 除提供给外部使⽤的全局常量外，应尽量避免类成员变量被外部直接访问6. 避免在⽆关的变量或⽆关的概念之间重⽤名字，避免隐藏（hide）、遮蔽（shadow）和遮掩（obscure）7. 覆写（override）——⼦类与⽗类间8. 重载（overload）——类内部9. 隐藏（hide）——⼦类与⽗类间10. 遮蔽（shadow）——类内部11. 遮掩（obscure）——类内部12. 不要在⽗类的构造⽅法中调⽤可能被⼦类覆写的⽅法13. 覆写equals⽅法时，应同时覆写hashCode⽅法14. ⼦类覆写⽗类⽅法时应加上@Override注解15. 接⼝定义中去掉多余的修饰词16. 设计时，考虑类的可变性最⼩化异常：1. 只针对真正异常的情况才使⽤exception机制2. 在抛出异常的细节信息中，应包含能捕获失败的信息3. 对可恢复的情况使⽤受检异常（checked exception），对编程错误使⽤运⾏时异常（runtime exception）4. 不要忽略异常5. ⽅法注释和⽂档中要包含所抛出异常的说明6. ⽅法抛出的异常，应该与本⾝的抽象层次相对应7. 对第三⽅API抛出⼤量各类异常进⾏封装8. 使⽤异常来做错误处理，⽽⾮错误码9. 在finally块中不要使⽤return、break或continue使finally块⾮正常结束10. 不要直接捕获受检异常的基类Exception11. ⼀个⽅法不应抛出太多类型的异常12. 充分利⽤断⾔⽇志：1. ⽇志信息准确、繁简得当，满⾜快速定位的需要2. ⽇志的记录，不要使⽤ System.out 与 System.err 进⾏控制台打印，应该使⽤专⽤的⽇志⼯具(⽐如：slf4j+logback)进⾏处理3. ⽇志⼯具对象logger应声明为private static final4. ⽇志应分等级5. ⽇志中不要记录敏感信息多线程并发：1. 多线程访问同⼀个可变变量，需增加同步机制2. 禁⽌不加控制地创建新线程3. 创建新线程时需指定线程名4. 使⽤Thread对象的setUncaughtExceptionHandler⽅法注册Runtime异常的处理者(v1.5+)5. 不要使⽤Thread.stop⽅法，因为该⽅法本质是不安全的，使⽤它可能会导致数据遭到破坏6. 不要依赖线程调度器、线程优先级和yield()⽅法7. 采⽤Java1.5提供新并发⼯具代替wait和notify（v1.5+）8. 使⽤线程安全集合在多线程间共享可变数据9. 多线程操作同⼀个字符串相加，应采⽤StringBuffer10. 针对线程安全性，需要进⾏⽂档（javadoc）说明运算和表达式：1. 不要写复杂的表达式2. 运算时应避免产⽣溢出3. 采⽤括号明确运算的优先级控制语句：1. 采⽤for-each代替传统的for循环（v1.5+）2. 在switch语句的每⼀个case、和default中都放置⼀条break语句序列化：1. 尽量不要实现Serializable接⼝2. 序列化对象中的HashMap、HashSet或HashTable等集合不能包含对象⾃⾝的引⽤3. 实现Serializable接⼝的可序列化类应该显式声明 serialVersionUID泛型：1. 在集合中使⽤泛型（v1.5+）2. 类的设计可优先考虑泛型（v1.5+）3. ⽅法的设计可优先考虑泛型（v1.5+）4. 优先使⽤泛型集合，⽽不是数组（v1.5+）其他语⾔特性：1. 新代码不要使⽤已标注为@deprecated的⽅法2. 使⽤JDK⾃带的API或⼴泛使⽤的开源库，不要⾃⼰写类似的功能。
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的世界里畅游时，要是大家都按照一套约定俗成的编码规范来写代码，那我们的代码就像训练有素的军队一样，整齐又高效。
这份规范就是我们在Java编程旅程中的小指南，让我们的代码既容易理解，又方便维护。
二、命名规范。
# （一）包（package）命名。
1. 包名应该全部小写，用点（.）分隔单词。
就像你的小包裹要摆放得井井有条一样，包名也得规规矩矩。
例如：`com.example.myproject`，这看起来多清爽。
如果写成`Com.Example.MyProject`，那就像穿着奇装异服的士兵混在整齐的队伍里，很不协调。
# （二）类（class）命名。
1. 类名采用大驼峰命名法（UpperCamelCase），每个单词的首字母大写，不要包含下划线或者其他奇怪的符号。
这就好比给每个班级取一个正式又响亮的名字。
比如：`MyFirstClass`，而不是`my_first_class`或者`my first class`。
那些奇怪的写法就像给班级取个让人摸不着头脑的名字，可不好。
# （三）方法（method）命名。
1. 方法名采用小驼峰命名法（lowerCamelCase），第一个单词小写，后面每个单词首字母大写。
这就像给方法这个小助手取个清晰明了的名字，方便我们知道它是干什么的。
例如：`calculateSum`，而不是`Calculate_Sum`或者`CALCULATESUM`。
要是写成后面那种，就像一个小助手穿着奇装异服，你都不知道它是来帮忙做什么的。
# （四）变量（variable）命名。
1. 变量名同样采用小驼峰命名法。
变量就像一个个小盒子，我们得给它们取个能让人一眼就大概知道里面装什么东西的名字。
像`studentName`，你一看就知道这个变量可能是用来存学生名字的。
要是写成`student_name`或者`STUDENTNAME`，就有点让人迷糊啦。
java 编码规则
Java编码规则是指在编写Java程序时需要遵循的一系列规范和约定，旨在提高代码的可读性、可维护性和可扩展性。
下面是一些常见的Java编码规则：
1. 代码缩进：使用四个空格进行缩进，不要使用制表符。
2. 代码行长度：每行代码尽量不超过80个字符，超过时可以换行。
3. 命名规范：使用驼峰命名法，即首字母小写，后面每个单词的首字母大写。
4. 类名：类名使用名词或名词短语，首字母大写。
5. 方法名：方法名使用动词或动词短语，首字母小写。
6. 变量名：变量名使用名词或名词短语，首字母小写。
7. 常量名：常量名应全部大写，并用下划线分隔单词。
8. 注释：为代码添加适当的注释，解释代码的用途、实现细节等。
9. 空格使用：在运算符两侧、逗号后面、冒号后面等地方使用空格，增加代码的可读性。
10.代码格式化：使用合适的缩进、空行、大括号等格式化代码，以增强可读性。
遵循这些Java编码规则可以使你的代码更易于理解和维护。
此外，还可以使用一些静态代码分析工具来自动检查代码是否符合编码规范，如Checkstyle、FindBugs等。
编码规则的遵守不仅仅是个人习惯的问题，也是一个团队合作的重要环节，通过统一的编码规范可以提高代码的一致性，方便开发人员的协作和项目的维护。
JAVA编程规范1.1 Java文件名与文件组织结构1.一个java源文件不应该超过2 000行。
2.在Java源文件中应该包含一个单一的公共类（class）或接口（interface），这个公共类或公共接口，应该是这个源文件的第一个类或接口。
3.一个Java源文件一般由下面的顺序构成：（1）文件注释头（2）包名（package）（3）引入（import）声明（4）类（class）或接口（interface）的声明部分1.2 Java文件注释头Java类文件注释头是用来描述该类功能及其特点，以及相关开发信息的，如该类的关联类（通常情况下不描述Java系统核心类如java.util.Vector, ng.Thread等）、开发公司或单位、版权、作者、代码审定人该类所支持的JDK版本、该类版本、开发日期、最后更改日期、修改人、复审人等信息，下面就是一个Java类文件注释头：/****************************************************************** 该类功能及其特点的描述（例如：该类是用来……）** 该类未被编译测试过。
** @see（与该类相关联的类）：(AnatherClass.java)*** 开发公司或单位：××软件有限公司研发中心** 版权：本文件版权归属××公司研发中心*** @author（作者）：必胜利** @since（该文件所支持的JDK版本）：Jdk1.3 或JDK1.42.在重点同时难以理解的地方另加注释。
方法体内的注释应该与其所描述的代码位于同一个层次上。
在一个块注释之前一般有一空白行用于做区分代码与注释的边界。
1.7 变量的声明初始化与放置1.7.1 变量声明1.在一般情况下我们建议每一行代码，只声明一个变量；2.如果变量名称较短并且又是同一数据类型同一结构类型，并且没有给变量初始化则可以在同一行声明；1.7.2 变量初始化尽量在变量声明的地方初始化，如果变量的初始化与有待于计算或处理后的值有关，则我们可以在取得这个值后对变量做初始化。
java代码规范Java代码规范是一套约定俗成的编程规范，旨在提高代码的可读性、可维护性和可重用性。
以下是一些常见的Java代码规范：命名规范：1. 类名使用大驼峰命名法，例如MyClass。
2. 方法名和变量名使用小驼峰命名法，例如myMethod。
3. 常量名使用全大写字母和下划线，例如MAX_VALUE。
4. 包名使用全小写字母，例如com.example.mypackage。
代码格式规范：1. 使用四个空格缩进，避免使用制表符。
2. 每行代码不超过80个字符，超出则换行。
3. 使用空格将运算符、逗号和分号与操作数分开，例如"int a =b + c;"。
4. 在左括号前后加一个空格，例如"if (condition) {"。
5. 在方法的左花括号前加空格，例如"public void myMethod() {"。
6. 使用大括号括起的代码块独占一行。
7. 在逻辑上相关的代码块之间使用空行分隔。
注释规范：1. 在类、方法和成员变量定义之前使用Javadoc注释说明其作用、参数和返回值。
2. 在方法内部使用注释解释代码的逻辑。
3. 避免使用不必要的注释，代码应尽可能自解释。
代码质量规范：1. 遵循SOLID原则，尽量将代码设计为松耦合、高内聚的模块。
2. 避免使用魔术数字，使用常量代替。
3. 使用异常处理机制来处理可预料的异常情况，不要捕获所有异常。
4. 避免使用全局变量，尽量将变量的作用范围限制在最小范围内。
5. 避免代码冗余和重复，尽量使用工具类和设计模式来重用代码。
测试规范：1. 使用单元测试框架（例如JUnit）编写测试用例，并确保每个方法都有相应的测试用例。
2. 使用断言来验证预期结果和实际结果是否一致。
3. 测试方法的命名应描述被测试方法的功能和预期结果。
版本管理规范：1. 使用版本管理工具（例如Git）来管理代码的版本和变更历史。
Java编码规范及实践目录Java编码规范及实践 (1)1.2术语 (2)1.3约束 (3)||!(condition5 && condition6)) { (14)4.1一般命名规范 (14)IQuery, IDataAccess,IReportBuilder (15)MAX_TIMES, DEFAULT_NAME (15)4.2特殊命名规范 (17)AbstractReportBuilder，AbstractBeanFactory (18)AccessException, RuntimeException (19)5.2一般原则 (20)1.代码应该和注释保持同步，如果代码和注释不同步，则阅读代码的人会 (20)2.注释尽量简洁，尺度没有准确的定义，大部分人能明白即可，可以将自 (20)Result getResult() throws Exception{ (21)Object getAction(); (22)JavaDoc 工具不要改变格式. (22)Get a default date/time formatter that uses the SHORT (23)Thread.sleep(1000); (24)Derived，如果一个方法可以接受基类对象b 的话：method1(Base b), (25)7.1工厂模式 (26)7.1.1简单工厂 (26)7.1.2工厂方法 (26)7.2单例模式 (27)Client: (27)7.3适配器模式 (28)7.4组合模式 (29)Client: (29)7.5外观模式 (30)Client: (30)7.6代理模式 (31)7.7命令模式 (32)Client: (33)7.8观察者模式 (33)7.9策略模式 (35)Client: (35)IKeyPairGenerable desGenerator = (35)IKeyPairGenerable rsaGenerator = (36)IKeyPairGenerable ideaGenerator = (36)KeyPairManager manager = new KeyPairManager(); (36)7.10模版方法模式 (36)7.11参观者模式 (38)总价格 (40)Client: (40)第1章概述1.1前言代码之于程序员，就像零件之于机械工，庄稼之于农民，它是软件的基石，一行行代码都是程序员的心血经过日日夜夜凝结成的。
java代码规则标准Java代码规则标准可以参考以下内容：- 类命名：- 抽象类：适用的设计模式为模板模式。
抽象是自下往上的设计。
由具体实现推断出抽象方法。
建议以`Abstract`开头。
- 枚举类：枚举是由JVM来保证的单例。
可以用来做单例类。
枚举类常用来做值判断，不建议每次进行循环判断得到实例。
建议由内部维护一个`map`类型，当做`cache`。
此方法建议放在`static`静态代码块中实现。
- 工具类：工具类常为无状态对象，无状态对象都是线程安全对象，建议使用`final`修饰。
工具类中避免出现业务属性，如果出现业务属性，抽象出领域层。
- 异常类：建议保持异常链。
- 接口实现类：众所周知。
- 设计模式相关类：- 处理特定功能的：其主要的目的是代码可重复使用。
- 测试类：- 领域模型载体：- 方法命名：- 布尔判断方法：- 检查的方法：- 按需求才执行的方法：- 异步相关方法：- 回调方法：- 操作对象生命周期的方法：- 与集合操作相关的方法：- 数据增删改查相关的方法：- 成对出现的动词：- 获取必须的参数：- 获取数据并对数据进行某种处理：- 方法编程建议：- 方法复杂度：凡事逻辑判断语句均为复杂度。
当一个方法中出现了大于等于10个复杂度，建议根据方法实现进行业务抽离。
在编写Java代码时，需要遵循一定的规则和标准，以提高代码的可读性、可维护性和可扩展性。
你可以根据项目的具体需求和团队的约定来选择合适的规范。
JAVA代码规范本Java代码规范以SUN的标准Java代码规范为基础，为适应我们公司的实际需要，可能会做一些修改。
本文档中没有说明的地方，请参看SUN Java标准代码规范。
如果两边有冲突，以SUN Java标准为准。
1. 标识符命名规范1.1 概述标识符的命名力求做到统一、达意和简洁。
1.1.1 统一统一是指，对于同一个概念，在程序中用同一种表示方法，比如对于供应商，既可以用supplier，也可以用provider，但是我们只能选定一个使用，至少在一个Java项目中保持统一。
统一是作为重要的，如果对同一概念有不同的表示方法，会使代码混乱难以理解。
即使不能取得好的名称，但是只要统一，阅读起来也不会太困难，因为阅读者只要理解一次。
1.1.2 达意达意是指，标识符能准确的表达出它所代表的意义，比如：newSupplier, OrderPaymentGatewayService等；而supplier1, service2，idtts等则不是好的命名方式。
准确有两成含义，一是正确，而是丰富。
如果给一个代表供应商的变量起名是order，显然没有正确表达。
同样的，supplier1, 远没有targetSupplier意义丰富。
1.1.3 简洁简洁是指，在统一和达意的前提下，用尽量少的标识符。
如果不能达意，宁愿不要简洁。
比如：theOrderNameOfTheTargetSupplierWhichIsTransfered 太长，transferedTargetSupplierOrderName则较好，但是transTgtSplOrdNm就不好了。
省略元音的缩写方式不要使用，我们的英语往往还没有好到看得懂奇怪的缩写。
1.1.4 骆驼法则Java中，除了包名，静态常量等特殊情况，大部分情况下标识符使用骆驼法则，即单词之间不使用特殊符号分割，而是通过首字母大写来分割。
比如: supplierName, addNewContract，而不是supplier_name, add_new_contract。
排版规范1. 关键词和操作符之间加适当的空格。
2. 相对独立的程序块与块之间加空行3. 较长的语句、表达式等要分成多行书写。
4. 划分出的新行要进行适应的缩进，使排版整齐，语句可读。
5. 长表达式要在低优先级操作符处划分新行，操作符放在新行之首。
6. 循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分。
7. 若函数或过程中的参数较长，则要进行适当的划分。
8. 不允许把多个短语句写在一行中，即一行只写一条语句。
9. 函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格。
10. C/C++语言是用大括号…{‟和…}‟界定一段程序块的，编写程序块时…{‟和11. …}‟应各独占一行并且位于同一列，同时与引用它们的语句左对齐。
在函数体12. 的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、13. switch、case语句中的程序都要采用如上的缩进方式。
Java 文件格式所有的Java(*.java) 文件都必须遵守如下的样式规则：• 版权信息版权信息必须在java 文件的开头，比如：/** Copyright ? 2000 Shanghai XXX Co. Ltd.* All right reserved.*/• 其他不需要出现在javadoc 的信息也可以包含在这里。
• Package/Importspackage 行要在import 行之前，import 中标准的包名要在本地的包名之前，而且按照字母顺序排列。
如果import 行中包含了同一个包中的不同子目录，则应该用* 来处理。
package .stats;import java.io.*;import java.util.Observable;import hotlava.util.Application;• 这里java.io.* 使用来代替InputStream and OutputStream 的。
• Class接下来的是类的注释，一般是用来解释类的。
/*** A class representing a set of packet and byte counters* It is observable to allow it to be watched, but only* reports changes when the current set is complete*/• 接下来是类定义，包含了在不同的行的extends 和implementspublic class CounterSetextends Observableimplements Cloneable• Class Fields接下来是类的成员变量：/*** Packet counters*/protected int[] packets;• pu blic 的成员变量必须生成文档（JavaDoc）。
proceted、private和package 定义的成员变量如果名字含义明确的话，可以没有注释。
• 存取方法接下来是类变量的存取的方法。
它只是简单的用来将类的变量赋值获取值的话，可以简单的写在一行上。
/*** Get the counters* @return an array containing the statistical data. This array has been* freshly allocated and can be modified by the caller.*/public int[] getPackets() { return copyArray(packets, offset); }public int[] getBytes() { return copyArray(bytes, offset); }public int[] getPackets() { return packets; }public void setPackets(int[] packets) { this.packets = packets; }• 其它的方法不要写在一行上• 构造函数接下来是构造函数，它应该用递增的方式写（比如：参数多的写在后面）。
访问类型("public", "private" 等.) 和任何"static", "final" 或"synchronized" 应该在一行中，并且方法和参数另写一行，这样可以使方法和参数更易读。
publicCounterSet(int size){this.size = size;}• 克隆方法如果这个类是可以被克隆的，那么下一步就是clone 方法：publicObject clone() {try {CounterSet obj = (CounterSet)super.clone();obj.packets = (int[])packets.clone();obj.size = size;return obj;}catch(CloneNotSupportedException e) {throw new InternalError("Unexpected CloneNotSUpportedException: " + e.getMessage()); }}• 类方法下面开始写类的方法：/*** Set the packet counters* (such as when restoring from a database)*/protected finalvoid setArray(int[] r1, int[] r2, int[] r3, int[] r4)throws IllegalArgumentException{//// Ensure the arrays are of equal size//if (r1.length != r2.length || r1.length != r3.length || r1.length != r4.length)throw new IllegalArgumentException("Arrays must be of the same size");System.arraycopy(r1, 0, r3, 0, r1.length);System.arraycopy(r2, 0, r4, 0, r1.length);}• toString 方法无论如何，每一个类都应该定义toString 方法：publicString toString() {String retval = "CounterSet: ";for (int i = 0; i < data.length(); i++) {retval += data.bytes.toString();retval += data.packets.toString();}return retval;}}• main 方法如果main(String[]) 方法已经定义了, 那么它应该写在类的底部.可读性• 避免使用不易理解的数字，用有意义的标识来替代。
• 不要使用难懂的技巧性很高的语句。
• 源程序中关系较为紧密的代码应尽可能相邻。
性能• 在写代码的时候，从头至尾都应该考虑性能问题。
这不是说时间都应该浪费在优化代码上，而是我们时刻应该提醒自己要注意代码的效率。
比如：如果没有时间来实现一个高效的算法，那么我们应该在文档中记录下来，以便在以后有空的时候再来实现她。
不是所有的人都同意在写代码的时候应该优化性能这个观点的，他们认为性能优化的问题应该在项目的后期再去考虑，也就是在程序的轮廓已经实现了以后。
• 不必要的对象构造o 不要在循环中构造和释放对象o 使用StringBuffer 对象在处理String 的时候要尽量使用StringBuffer 类，StringBuffer 类是构成String 类的基础。
String 类将StringBuffer 类封装了起来，（以花费更多时间为代价）为开发人员提供了一个安全的接口。
当我们在构造字符串的时候，我们应该用StringBuffer 来实现大部分的工作，当工作完成后将StringBuffer 对象再转换为需要的String 对象。
比如：如果有一个字符串必须不断地在其后添加许多字符来完成构造，那么我们应该使用StringBuffer 对象和她的append() 方法。
如果我们用String 对象代替StringBuffer 对象的话，会花费许多不必要的创建和释放对象的CPU 时间。
• 避免太多的使用synchronized 关键字避免不必要的使用关键字synchronized，应该在必要的时候再使用她，这是一个避免死锁的好方法。
代码编写格式• 代码样式代码应该用unix 的格式，而不是windows 的（比如：回车变成回车+恍校?• 文档化必须用javadoc 来为类生成文档。
不仅因为它是标准，这也是被各种java 编译器都认可的方法。
使用@author 标记是不被推荐的，因为代码不应该是被个人拥有的。
• 缩进缩进应该是每行2个空格. 不要在源文件中保存Tab字符. 在使用不同的源代码管理工具时Tab字符将因为用户设置的不同而扩展为不同的宽度.如果你使用UltrEdit 作为你的Java 源代码编辑器的话，你可以通过如下操作来禁止保存Tab字符, 方法是通过UltrEdit中先设定Tab 使用的长度室2个空格，然后用Format|Tabs to Spaces 菜单将Tab 转换为空格。
• 页宽页宽应该设置为80字符. 源代码一般不会超过这个宽度, 并导致无法完整显示, 但这一设置也可以灵活调整. 在任何情况下, 超长的语句应该在一个逗号或者一个操作符后折行. 一条语句折行后, 应该比原来的语句再缩进2个字符.• {} 对{} 中的语句应该单独作为一行. 例如, 下面的第1行是错误的, 第2行是正确的:if (i>0) { i ++ }; // 错误, { 和} 在同一行if (i>0) {i ++}; // 正确, { 单独作为一行} 语句永远单独作为一行.• 如果} 语句应该缩进到与其相对应的{ 那一行相对齐的位置。
• 括号左括号和后一个字符之间不应该出现空格, 同样, 右括号和前一个字符之间也不应该出现空格. 下面的例子说明括号和空格的错误及正确使用:CallProc( AParameter ); // 错误CallProc(AParameter); // 正确不要在语句中使用无意义的括号. 括号只应该为达到某种目的而出现在源代码中。
