本文共 3183 字,大约阅读时间需要 10 分钟。
... { FileOutputStream fos = new FileOutputStream(projectFile); project.save(fos, "IDE Project File"); } ... |
FileOutputStream fos = new FileOutputStream(projectFile); project.save(fos, "IDE Project File"); fos.close(); |
implements Cloneable public Object clone() { try { ThisClass obj = (ThisClass)super.clone(); obj.field1 = (int[])field1.clone(); obj.field2 = field2; return obj; } catch(CloneNotSupportedException e) { throw new InternalError("Unexpected CloneNotSUpportedException: " + e.getMessage()); } } |
public void setPackets(int[] packets) { this.packets = packets; } CounterSet(int size) { this.size = size; } |
关键词和操作符之间加适当的空格。 相对独立的程序块与块之间加空行 较长的语句、表达式等要分成多行书写。 划分出的新行要进行适应的缩进,使排版整齐,语句可读。 长表达式要在低优先级操作符处划分新行,操作符放在新行之首。 循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分。 若函数或过程中的参数较长,则要进行适当的划分。 不允许把多个短语句写在一行中,即一行只写一条语句。 函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格。 C/C++语言是用大括号‘{’和‘}’界定一段程序块的,编写程序块时‘{’和 ‘}’应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体 的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、 switch、case语句中的程序都要采用如上的缩进方式。 注释规范 定义这个规范的目的是让项目中所有的文档都看起来像一个人写的,增加可读性,减少项目组中因为换人而带来的损失。(这些规范并不是一定要绝对遵守,但是一定要让程序有良好的可读性)。 Java 的语法与 C++ 及为相似,那么,你知道 Java 的注释有几种吗?是两种? // 注释一行 /* ...... */ 注释若干行 不完全对,除了以上两种之外,还有第三种,文档注释: /** ...... */ 注释若干行,并写入 javadoc 文档 注释要简单明了。 String userName = null; //用户名 边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。 在必要的地方注释,注释量要适中。注释的内容要清楚、明了,含义准确,防 止注释二义性。保持注释与其描述的代码相邻,即注释的就近原则。 对代码的注释应放在其上方相邻位置,不可放在下面。对数据结构的注释应放在 其上方相邻位置,不可放在下面;对结构中的每个域的注释应放在此域的右方; 同一结构中不同域的注释要对齐。 变量、常量的注释应放在其上方相邻位置或右方。 全局变量要有较详细的注释,包括对其功能、取值范围、哪些函数或过程存取它以 及存取时注意事项等的说明。 在每个源文件的头部要有必要的注释信息,包括:文件名;版本号;作者;生成日 期;模块功能描述(如功能、主要算法、内部各部分之间的关系、该文件与其它文 件关系等);主要函数或过程清单及本文件历史修改记录等。 /** * Copy Right Information : Neusoft IIT * Project : eTrain * JDK version used : jdk1.3.1 * Comments : config path * Version : 1.01 * Modification history :2003.5.1 * Sr Date Modified By Why & What is modified * 1. 2003.5.2 Kevin Gao new **/ 在每个函数或过程的前面要有必要的注释信息,包括:函数或过程名称;功能描 述;输入、输出及返回值说明;调用关系及被调用关系说明等 /** * Description :checkout 提款 * @param Hashtable cart info * @param OrderBean order info * @return String */ public String checkout(Hashtable htCart, OrderBean orderBean) throws Exception{ } javadoc注释标签语法 @author 对类的说明 标明开发该类模块的作者 @version 对类的说明 标明该类模块的版本 @see 对类、属性、方法的说明 参考转向,也就是相关主题 @param 对方法的说明 对方法中某参数的说明 @return 对方法的说明 对方法返回值的说明 @exception 对方法的说明 对方法可能抛出的异常进行说明
转载地址:http://tbmli.baihongyu.com/