Java编程风格与命名规范整理

基本命名规范

包命名

包名按照域名的范围从大到小逐步列出，恰好和Internet上的域名命名规则相反。

由一组以“.”连接的标识符构成，通常***个标识符为符合网络域名的两个或者三个英文小写字母。

 
 
 
    
  
  
  
  1. People  
    2.   
  
  
  2. TestPage  
    3.   
  
  
  3. XMLExample 
    4.

类，接口命名

类的名字必须由大写字母开头而单词中的其他字母均为小写；如果类名称由多个单词组成，则每个单词的首字母均应为大写例如TestPage；如果类名称中包含单词缩写，则这个所写词的每个字母均应大写，如：XMLExample,还有一点命名技巧就是由于类是设计用来代表对象的，所以在命名类时应尽量选择名词。

 
 
 
    
  
  
  
  1. People  
    2.   
  
  
  2. TestPage  
    3.   
  
  
  3. XMLExample 
    4.

方法名

方法的名字的***个单词应以小写字母作为开头，后面的单词则用大写字母开头。可以为动词或动词+名词组合。

设置/获取某个值的Method，应该遵循setV/getV规范

返回长度的Method，应该命名为length

测试某个布尔值的Method，应该命名为isV

将对象转换为某个特定类型的Mehod应该命名为toF

 
 
 
    
  
  
  
  1. getDate();  
    2.   
  
  
  2. length();  
    3.   
  
  
  3. isReady();  
    4.   
  
  
  4. toOracleFormat(); 
    5.

变量名

1.普通变量命名应该采用首字母小写，其他字母首字母大写的方式。

2.final static变量的名字应该都大写，并且指出完整含义。如果一个常量名称由多个单词组成，则应该用下划线来分割这些单词如。

 
 
 
    
  
  
  
  1. NUM_DAYS_IN_WEEK  
    2.   
  
  
  2. MAX_VALU 
    3.

3. 如果需要对变量名进行缩写时，一定要注意整个代码中缩写规则的一致性

 
 
 
    
  
  
  
  1. context=ctx  
    2.   
  
  
  2. message=msg 
    3.

4. 通过在结尾处放置一个量词，就可创建更加统一的变量

 
 
 
    
  
  
  
  1. First（一组变量中的***个）  
    2.   
  
  
  2. Last（一组变量中的***一个）  
    3.   
  
  
  3. Next（一组变量中的下一个变量）  
    4.   
  
  
  4. Prev（一组变量中的上一个）  
    5.   
  
  
  5. Cur（一组变量中的当前变量） 
    6.

5. 无论什么时候，均提倡应用常量取代数字、固定字符串。也就是说，程序中除0，1以外，尽量不应该出现其他数字。

6. 索引变量：i、j、k等只作为小型循环的循环索引变量。

7. 逻辑变量：避免用flag来命名状态变量，用is来命名逻辑变量。

 
 
 
    
  
  
  
  1. if(isClosed){  
    2.   
  
  
  2. dosomeworks;  
    3.   
  
  
  3. return;  
    4.   
  
  
  4. } 
    5.

数组

总是使用以下方式定义数组：

 
 
 
    
  
  
  
  1. int[] arr = new int[10]; 
    2.

禁止使用C语言的是形式：

 
 
 
    
  
  
  
  1. 禁止  
    2.   
  
  
  2. int arr[] = new int[10]; 
    3.

集合

数组或者容器推荐命名方式为名词+s的方式，例如：

 
 
 
    
  
  
  
  1. List persons = getPerson();  
    2.   
  
  
  2. for(Person person : persons){  
    3.   
  
  
  3. dosomeworks;  
    4.   
  
  
  4. } 
    5.

泛型

应该尽量简明扼要（***是一个字母），以利于与普通的class或interface区分

Container中的Element应该用E表示；Map里的key用K表示，value用V；Type用T表示；异常用X表示

如果需要接收多个Type类型的参数，应该用邻接T的大写字母——例如S——来依次表示，当然也可以用T1, T2这样的方式

 
 
 
    
  
  
  
  1. public 
    2.   
  
  
  2. class HashSet extends AbstractSet {…}  
    3.   
  
  
  3.  
    4.   
  
  
  4. public 
    5.   
  
  
  5. class HashMap extends AbstractMap {…}  
    6.   
  
  
  6.  
    7.   
  
  
  7. public 
    8.   
  
  
  8. class ThreadLocal {…}  
    9.   
  
  
  9.  
    10.   
  
  
  10. public 
    11.   
  
  
  11. interface Functor {  
    12.   
  
  
  12.  
    13.   
  
  
  13.     T val() throws X;  
    14.   
  
  
  14.  
    15.   
  
  
  15. } 
    16.

推荐的命名

1.当要区别接口和实现类的时候，可以在类的后面加上“Impl”。

 
 
 
    
  
  
  
  1. interface Container  
    2.   
  
  
  2. class ContainerImpl 
    3.

2.Exception类***能用“Exception”做为类命名的结尾

 
 
 
    
  
  
  
  1. DataNotFoundException  
    2.   
  
  
  2. InvalidArgumentException 
    3.

3.抽象类***能用“Abstract”做为类命名的开头

 
 
 
    
  
  
  
  1. AbstractBeanDefinition  
    2.   
  
  
  2. AbstractBeanFactory 
    3.

4. Test类***能用“Test”做为类命名的结尾

 
 
 
    
  
  
  
  1. ContainerTest 
    2.

5.简称与缩写（不推荐使用）

 
 
 
    
  
  
  
  1. cp代表colorPoint  
    2.   
  
  
  2.  
    3.   
  
  
  3. buf代表buffer  
    4.   
  
  
  4.  
    5.   
  
  
  5. off代表offset  
    6.   
  
  
  6.  
    7.   
  
  
  7. len代表length 
    8.

除非是在循环中，否则一般不推荐使用单个字母作为变量名，不过也有例外，即约定俗成的单个字母

 
 
 
    
  
  
  
  1. b代表byte 
    2.   
  
  
  2.  
    3.   
  
  
  3. c代表char 
    4.   
  
  
  4.  
    5.   
  
  
  5. d代表double 
    6.   
  
  
  6.  
    7.   
  
  
  7. e代表Exception  
    8.   
  
  
  8.  
    9.   
  
  
  9. f代表float 
    10.   
  
  
  10.  
    11.   
  
  
  11. i, j, k代表整数  
    12.   
  
  
  12.  
    13.   
  
  
  13. l代表long 
    14.   
  
  
  14.  
    15.   
  
  
  15. o代表Object  
    16.   
  
  
  16.  
    17.   
  
  
  17. s代表String  
    18.   
  
  
  18.  
    19.   
  
  
  19. v代表某些类型的特定值 
    20.

代码风格

花括号

花括号统一采用以下格式：

 
 
 
    
  
  
  
  1. if(bool experssion){  
    2.   
  
  
  2. dosomework;  
    3.   
  
  
  3. } 
    4.

除非花括号中为空，不然任何情况下不能省略花括号，并且花括号必须换行，例如：

 
 
 
    
  
  
  
  1. if(i==0){  
    2.   
  
  
  2. return;  
    3.   
  
  
  3. }  
    4.   
  
  
  4. while(true) {} 
    5.

以下写法禁止出现：

 
 
 
    
  
  
  
  1. 禁止  
    2.   
  
  
  2. if(i != 0) return;  
    3.   
  
  
  3. 禁止  
    4.   
  
  
  4. if(i !=0) {return;} 
    5.

括号

括号的前，后一个字符不需要空格，例如：

 
 
 
    
  
  
  
  1. Person p = new Person(“Jack”, 17); 
    2.

空格

逗号之后紧跟一个空格。

 
 
 
    
  
  
  
  1. Person p = new Person(“Jack”, 16, “China”); 
    2.

2.　二元操作符前后跟空格。

 
 
 
    
  
  
  
  1. int i = a + b – c * d; 
    2.

3. 一元操作符不需要空格,for语句分号后有空格。

 
 
 
    
  
  
  
  1. for(int i = 0; I < 10; i++){  
    2.   
  
  
  2. dosomework;  
    3.   
  
  
  3. } 
    4.

4. 括号前后不需要空格

类

类的定义结构按照顺序为：

1) 常量

2) 成员变量

3) 构造函数

4) 成员函数

5) get和set方法

各个部分之间留出一个空行。

例如：

规范类模板：

 
 
 
    
  
  
  
  1.  class Person{  
    2.   
  
  
  2.     private final static int MAX_AGE = 100;  
    3.   
  
  
  3.  
    4.   
  
  
  4.     private String firstname = “Jack”;  
    5.   
  
  
  5.  
    6.   
  
  
  6.     public Person(){}  
    7.   
  
  
  7. public Person(String firstname){  
    8.   
  
  
  8.     this.firstname = firstname;  
    9.   
  
  
  9. }  
    10.   
  
  
  10.  
    11.   
  
  
  11. public void doExercise(){  
    12.   
  
  
  12.     dosomeworks;  
    13.   
  
  
  13.     run();  
    14.   
  
  
  14. }  
    15.   
  
  
  15. private void run(){  
    16.   
  
  
  16.     dosomeworks;  
    17.   
  
  
  17. }  
    18.   
  
  
  18.  
    19.   
  
  
  19. public getFirstname(){  
    20.   
  
  
  20.     return firstname;  
    21.   
  
  
  21. }  
    22.   
  
  
  22. public setFirstname(String firstname){  
    23.   
  
  
  23.     this.firstname = firstname;  
    24.   
  
  
  24. }  
    25.   
  
  
  25. } 
    26.

2.构造函数

1) 参数为空的构造函数出现在最上方

2) 有调用关系的构造函数相邻

3) 参数尽量由少到多从上至下排序

3.使用成员变量

在类的方法内引用成员变量了命名冲突以外，不使用this。非特殊情况在类的方法内都不使用get和set方法存取成员变量。

4.方法

有调用关系的方法尽量放在相邻的位置，public和private方法可以交叉放置。

5.get和set方法，所有需要公开的成员变量都要符合良好的javabean规范，提供get和set方法，尽量使用IDE工具自动生成。

Javadoc注释

在每个程序的最开始部分，一般都用Javadoc注释对程序的总体描述以及版权信息，之后在主程序中可以为每个类、接口、方法、字段添加 Javadoc注释，每个注释的开头部分先用一句话概括该类、接口、方法、字段所完成的功能，这句话应单独占据一行以突出其概括作用，在这句话后面可以跟随更加详细的描述段落。在描述性段落之后还可以跟随一些以Javadoc注释标签开头的特殊段落，例如上面例子中的@auther和@version，这些段落将在生成文档中以特定方式显示

参考文档

 
 
 
    
  
  
  
  1. Java命名规范  
    2.   
  
  
  2.  
    3.   
  
  
  3. http://java.chinaitlab.com/base/834496.html  
    4.   
  
  
  4.  
    5.   
  
  
  5. Java代码规范  
    6.   
  
  
  6.  
    7.   
  
  
  7. http://www.doc88.com/p-733474983375.html  
    8.   
  
  
  8.  
    9.   
  
  
  9. java应用命名规范  
    10.   
  
  
  10.  
    11.   
  
  
  11. http://home.51.com/renjanely/diary/item/10051465.html  
    12.   
  
  
  12.  
    13.   
  
  
  13. 【J2SE系列】Java命名规范  
    14.   
  
  
  14.  
    15.   
  
  
  15. http://my.oschina.net/iblike/blog/34100\  
    16.   
  
  
  16.  
    17.   
  
  
  17. 开发笔记：Java命名规范  
    18.   
  
  
  18.  
    19.   
  
  
  19. http://blog.donews.com/maverick/archive/2005/10/12/585459.aspx 
    20.

原文链接：http://www.cnblogs.com/coolhwm/archive/2012/03/22/2411811.html

本文题目：Java编程风格与命名规范整理
URL链接：http://www.shufengxianlan.com/qtweb/news23/328673.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联

猜你还喜欢下面的内容

商城网站知识

行业网站建设

重庆网站制作　　 　安娜尚美　　 　温江网站建设　　 　四川门窗　　 　微信小程序开发　　 　医药医疗网站建设方案　　 　网站空间　　 　高端网站设计　　 　软文推广公司　　 　成都微信二次开发　　 　三台网站建设　　 　app软件开发　　 　400电话办理　　 　泸州网站建设　　 　温江网站制作　　 　网站建设策划方案　　 　成都网站建设　　 　等级保护测评　　 　王君美油画　　 　内江做网站