《java 语言编程规范》由会员分享，可在线阅读，更多相关《java 语言编程规范（12页珍藏版）》请在金锄头文库上搜索。
1、 杭州珍诚医药网络有限公司JAVA编码规范内容目录一 排版规范 .2二 注释规范 .3三 命名规范 .5四 编码规范 .6五 规则建议 .7（一）规则 .7（二）建议 .8一 排版规范1 程序块要采用缩进风格编写，缩进的空格数为4个，对齐只使用空格键，不使用TAB键 2 分界符（如大括号和），左分界符应跟随在引用语句之后，右分界符应独自一行并且与引用它们的语句左对齐； for (.) . / program codeif (.) . / program codevoid example_fun( void ). / program code3 较长的语句、表达式或参数（80字符）要分成多行书写
2、，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读； if (filename != null & new File(logPath + filename).length() = MAX_TIME_VALUE) a = b + c;a *= 2;a = b 2; !、 、 +、- 、&（地址运算符）等单目操作符前后不加空格 flag = !isEmpty; / 非操作! 与内容之间i+; / +,-与内容之间 .前后不加空格 p.id = pid; / .前后不加空格 if、for、while、switch等与后面的括号间应加空格，使
3、if等关键字更为突出、明显 if (a = b & c d)二 注释规范1 包的注释写入一名为 package.html 的HTML 格式 说明文件放入当前路径,例如： com/zcnet/msg/relay/comm/package.html2 文件注释：文件注释写入文件头部，包名之前的位置 /* 注释内容*/package m;3 文件注释内容：版权说明、描述信息、生成日期、修改历史 /* 文件名：文件名* 版权：版权* 描述：描述* 修改人：修改人* 修改时间：YYYY-MM-DD* 修改单号：修改单号* 修改内容：修改内容*/4 类和接口的注释：该注释放在 package 关键字之后，
4、class 或者 interface 关键字之前 package m;/* 注释内容*/public class CommManager5 类和接口的注释内容：类的注释主要是一句话功能简述、功能详细描述 /* 一句话功能简述* 功能详细描述* author 作者* version 版本号, YYYY-MM-DD* see 相关类/ 方法* since 产品/ 模块版本 * deprecated*/6 类属性、公有和保护方法注释：写在类属性、公有和保护方法上面 /* 注释内容*/private String logType;/* 注释内容*/public void write()7 成员变量注释
5、内容：成员变量的意义、目的、功能，可能被用到的地方 8 公有和保护方法注释内容：列出方法的一句话功能简述、功能详细描述、输入参数、输出参数、返回值、违例 /* 一句话功能简述* 功能详细描述* param 参数1 参数1 说明* param 参数2 参数2 说明* return 返回类型说明* exception/throws 违例类型 违例说明* see 类、类#方法、类# 成员* deprecated*/9 对于方法内部用throw语句抛出的异常，必须在方法的注释中标明，对于所调用的其他方法所抛出的异常，选择主要的在注释中说明。 对于非RuntimeException，即throws子句声
6、明会抛出的异常，必须在方法的注释中标明: 用exception标注Runtime异 常， throws标注非Runtime异常 10 注释应与其描述的代码相近，对代码的注释应放在其上方或右方（对单条语句的注释）相邻位置，不可放在下面，如放于上方则需与其上面的代码用空行隔开 11 注释与所描述内容进行同样的缩排 public void example( )/ 注释CodeBlock One/ 注释 CodeBlock Two12 将注释与其上面的代码用空行隔开 /注释program code one/注释program code two13 对变量的定义和分支语句（条件分支、循环语句等）必须编写
7、注释 14 对于switch语句下的case 语句，如果因为特殊情况需要处理完一个case后进入下一个case 处理，必须在该case语句处理完、下一个 case语句前加上明确的注 释 15 边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。不再有用的注释要删除 16 避免在注释中使用缩写，特别是不常用缩写 17 一些复杂的代码需要说明 /1. 如果能被4 整除，是闰年；/2. 如果能被100 整除，不是 闰年. ；/3. 如果能被400 整除，是 闰年. 。三 命名规范1 包名采用域后缀倒置的加上自定义的包名，采用小写字母。在部门内部应该规划好包名的范围，防止产生冲突。部
8、门内部产品使用部门的名称加上模块名称。产品线的产品使用产品的名称加上模块的名称 com.zcnet.产品名.模块名称com.zcnet.部门名称.项目名称2 类名和接口使用类意义完整的英文描述，每个英文单词的首字母使用大写、其余字母使用小写的大小写混合法 OrderInformation, CustomerList, LogManager, LogConfig3 方法名使用类意义完整的英文描述：第一个单词的字母使用小写、剩余单词首字母大写其余字母小写的大小写混合法 private void calculateRate();public void addNewOrder();4 属性名使用意义完
9、整的英文描述：第一个单词的字母使用小写、剩余单词首字母大写其余字母小写的大小写混合法。属性名不能与方法名相同 private customerName;private orderNumber;private smpSession;5 常量名使用全大写的英文描述，英文单词之间用下划线分隔开，并且使用 final static 修饰 public final static int MAX_VALUE = 1000;public final static String DEFAULT_START_DATE = 2001-12-08;6 属性名可以和公有方法参数相同，不能和局部变量相同，引用非静态成员
10、变量时使用 this 引用，引用静态成员变量时使用类名引用 public class Personprivate String name;private static List properties;public void setName (String name)this.name = name;public void setProperties (List properties)Person.properties = properties;7 常用组件类的命名以组件名加上组件类型名结尾 Application 类型的，命名以 App 结尾MainAppFrame 类型的，命名以Frame
11、结尾TopoFramePanel 类型的，建议命名以Panel 结尾CreateCircuitPanelBean 类型的，建议命名以Bean 结尾 DataAccessBeanEJB 类型的，建议命名以EJB 结尾DBProxyEJBApplet 类型的，建议命名以Applet 结尾 PictureShowApplet8 准确地确定成员函数的存取控制符号，不是必须使用 public 属性的，请使用 protected，不是必 须使用 protected, 请使用 private protected void setUserName();private void calculateRate();
12、9 含有集合意义的属性命名，尽量包含其复数的意义 customers, orderItems四 编码规范1 明确方法功能，精确（而不是近似）地实现方法设计。一个函数仅完成一件功能，即使简单功能也应该编写方法实现。 2 应明确规定对接口方法参数的合法性检查应由方法的调用者负责还是由接口方法本身负责，缺省是由方法调用者负责。 3 明确类的功能，精确（而非近似）地实现类的设计。一个类仅实现一组相近的功能。 示例：数据类不能包含数据处理的逻辑。通信类不能包含显示处理的逻辑。 4 所有的数据类必须重载toString() 方法，返回该类有意义的内容。 示例：public TopoNodeprivate String nodeName;public String toString()return NodeName : + nodeName;5 数据库操作、IO操作等需要使用结束close()的对象必须在try -catch-finally 的finally 中close()。 示例：try/ . .catch(IO
