程序开发规范性文档

《程序开发规范性文档》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、开发规范性文档目录第1章命名规范11.1JavaPackage命名规则11.2类、接口命名21.3方法名21.4变量名31.5数组31.6集合41.7泛型41.7.1泛型命名要点41.7.2推荐的命名41.8符号51.8.1花括号51.8.2括号61.8.3空格61.8.4类结构61.8.5构造函数71.8.6成员变量71.8.7方法7第2章注释规范82.1注释形式统一82.2注释内容准确简洁82.3注释条件82.4注释格式9第3章代码风格12第1章第1章命名规范1.1JavaPackage命名规则包名按照域名的范围从大到小逐步列出，恰好和Intern

2、et上的域名命名规则相反。Java包的名字都是由小写单词组成。但是由于Java面向对象编程的特性，每一名Java程序员都可以编写属于自己的Java包，为了保障每个Java包命名的唯一性，在最新的Java编程规范中，要求程序员在自己定义的包的名称之前加上唯一的前缀。由于互联网上的域名称是不会重复的，所以程序员一般采用自己在互联网上的域名称作为自己程序包的唯一前缀。根据项目的所属可以分为如下几类：1)indi：个体项目，指个人发起，但非自己独自完成的项目，可公开或私有项目，copyright主要属于发起者。包名为“indi.发起者名.项目名.模块名.……”

3、。2)pers：个人项目，指个人发起，独自完成，可分享的项目，copyright主要属于个人。包名为“pers.个人名.项目名.模块名.……”。3)priv：私有项目，指个人发起，独自完成，非公开的私人使用的项目，copyright属于个人。包名为“priv.个人名.项目名.模块名.……”。4)onem：与“indi”相同，推荐使用“indi”。另外，我为了区分团队项目和前面所说项目的区分，还有了一下扩展：5)team：团队项目，指由团队发起，并由该团队开发的项目，copyright属于该团队所有。名为“team.团队名.项目名.模块名.……”。6)c

4、om：11公司项目，copyright由项目发起的公司所有。包名为“com.公司名.项目名.模块名.……”。在公司，我们开发人员统一使用公司项目的命名方式。一般分到三层或四层即可。比如：com.toroot.crawlermaster.dao1.2类、接口命名　统一采用骆驼式命名法（Camel-Case）又称驼峰命名法。类的名字必须由大写字母开头而单词中的其他字母均为小写;1)如果类名称由多个单词组成，则每个单词的首字母均应为大写例如TestPage;2)如果类名称中包含单词缩写，则这个所写词的每个字母均应大写，如：XMLExample,还有一点命名技

5、巧就是由于类是设计用来代表对象的，所以在命名类时应尽量选择名词。并且在名字中能表现出类、接口的类型，意义。比如：工具类：DateUtils；RowKeyUtils；帮助类：MysqlHelper；HbaseHelper；*具体请参考推荐命名。1.3方法名　方法的名字的第一个单词应以小写字母作为开头，后面的单词则用大写字母开头。可以为动词或动词+名词组合。1)设置/获取某个值的Method，应该遵循setV/getV规范2)返回长度的Method，应该命名为length3)测试某个布尔值的Method，应该命名为isV4)将对象转换为某个特定类型的Met

6、hod应该命名为toF例如：setDate();length();isReady();toOracleFormat();5)。。。。。总之，取方法名时，能让其他开发人员一看就能大概明白方法的作用。可以配合注释使用，效果更佳。111.4变量名1)普通变量命名应该采用首字母小写，其他字母首字母大写的方式。在命名上尽量通过英文表现出变量的含义。2)finalstatic变量的名字应该都大写，并且指出完整含义。如果一个常量名称由多个单词组成，则应该用下划线来分割这些单词如。例如：NUM_DAYS_IN_WEEK；MAX_VALUE3)如果需要对变量名进行缩写时

7、，一定要注意整个代码中缩写规则的一致性。例如：context=ctx；message=msg4)通过在结尾处放置一个量词，就可创建更加统一的变量First(一组变量中的第一个)；Last(一组变量中的最后一个)；Next(一组变量中的下一个变量)；Prev(一组变量中的上一个)；Cur(一组变量中的当前变量)；5)无论什么时候，均提倡应用常量取代数字、固定字符串。也就是说，程序中除0，1以外，尽量不应该出现其他数字。6)索引变量：i、j、k等只作为小型循环的循环索引变量。7)逻辑变量：避免用flag来命名逻辑变量，用is来命名逻辑变量。if(isClo

8、sed){dosomeworks;return;}为了提高易读性，将变量尽量写在使用方法的上面