《程序开发规范》

1、1.1. 程序开发标准1.1.1. 目的定义这个标准的目的是让工程中所有的文档都看起来像一个人写的， 增加可读性， 减少工程组中因为换人而带来的损失。1.1.2. 命名标准Package 的命名Package 的名字应该都是由一个小写单词组成，如： package com.wholewise.ucss.workflow ；。在UCSS工程中，我们对所有的包做如下规定：package com.wholewise.ucss.*;其中， * 是开发人员根据模块自己定义的。Class 的命名Class 的名字必须由大写字母开头而其他字母都小写的单词组成， 最好用有意义的单词命 名。如： class G

2、etTreeInfo,class TransToXml 等。Class 变量的命名类对象的名字必须用一个小写字母开头。后面的单词用大写字母开头。数据类型的变量第一个字母为变量类型的缩写。如：sPassword,iCount 。关于数据类型标识的说明(弱化该要求，尽量保持)数据类型数据类型标识数据类型数据类型标识整型(int)i浮点型(float)f字符串型(String)s字符型(char)c浮点型(double)d布尔型(boolean)b长整型(Iong)l数组(Array)aStrin gBuffersb二维数组aaStatic Fin al变量的命名Static Final变量的名字应

3、该都大写，并且指出完整含义。女口： private static final int SERVER_PORT=7100；/ 表示效劳器端口号。参数的命名参数的名字必须和变量的命名标准一致。数组的命名数组应该总是用下面的方式来命名：byte aBuffer; 而不是：byte aBuffer;方法的命名使用有意义的参数命名，原那么上是动词+名词。且除第一个单词外其他单词的第一个字母大写。如果可能的话，使用和要赋值的字段一样的名字：public void setSize(int iSize)this.iSize = iSize;public int getSize()return this.iSi

4、ze;1.1.3. Java 文件样式所有的 Java(*.java) 文件都必须遵守如下的样式规那么。信息信息必须在 java 文件的开头，比方：/* Copyright ? 2001 WholeWise Sci.&Tech.Co.,Ltd* All right reserved.* MODIFIED (YYYY-MM-DD)* V1.0.0.0 developer 2000-01-01created * V1.0.0.1 changer 2000-02-01modified*/其他不需要出现在 javadoc 的信息也可以包含在这里。Package/Import而且按照字* 来处理

5、。package 行要在 import 行之前， import 中标准的包名要在本地的包名之前， 母顺序排列。如果 import 行中包含了同一个包中的不同子目录，那么应该用package com.wholewise.ywzx;import java.io.*;import java.util.Observable;import com.wholewise.ucss.tool.UseJolt;这里 java.io.* 使用来代替 InputStream and OutputStream的。如果你能确定你要调用包中的哪一个类，指明具体的类会更好。如：import java.io. InputSt

6、ream;import java.io. OutputStream;import java.util.Observable;import com.wholewise.ucss.tool.UseJolt;这样运行速度会更快些，查错也方便。Class接下来的是类的注释，一般是用来解释类的。定义的成员可以简*/接下来是类定义，public class CounterSetextends Observableimplements Cloneable；Class Fields接下来是类的成员变量：protected int iSize;public 的成员变量必须生成文档( JavaDoc)。 proc

7、eted 、private 和 package 变量如果名字含义明确的话，可以没有注释。构造函数接下来是构造函数，它应该用递增的方式写(比方：参数多的写在后面) 。Public SetSize(int iSize)this.iSize = iSize;存取方法接下来是类变量的存取的方法。 如果它只是简单的用来将类的变量赋值获取值的话， 单的写在一行上。public int getPackets() return copyArray(packets, offset); public int getBytes() return copyArray(bytes, offset); public int getPackets() return aPackets; public void setPackets(int aPackets) this.aPackets = aPackets; 5 / 6其它的方法不要写在一行上类方法下面开始写类的方法：/* 参见 3.7.1 的注释说明*/protected finalString displayTreeInfo(String sNode)方法的注释对于方法注释，一般情况下是对一