java编程规范之java命名规范

来源:互联网 发布:java integer.valueof 编辑:程序博客网 时间:2024/04/30 17:27

想要成为一个优秀的程序员,首先要培养良好的编程习惯,为了提高代码的可读性,必须有好的命名规范。
这篇文章是小编结合网上的很多资料整理出来的,若有不当或错误的地方,欢迎大家指正

在文章开始前,为方便阅读,先简单介绍一点知识
驼峰命名法:驼峰命名法就是当变量名或函数名是由一个或多个单字连结在一起,而构成的一识别字时,第一个单字以小写字母开始,第  二个单字的首字母大写或每一个单字 的首字母都采用大写字母例如:myFirstProject。

 

java命名规范:

项目名
          1:一部分人采用简写,然后全部大写;
           2:一部分人使用首字母大写+驼峰命名法

包名:[全部小写,域名起头]
      1:包名全部小写;
      2:Package第一部分通常是顶级域名之一,如com、edu、gov、mil、net、org,后续部分由各组织内部命名规则决定,内部命名规则 指定了各组件的目录名,所属部名    

          项目名等。例如:com.frontfree.javagroup;
      3:关于j2ee中包的命名习惯,我在网上看到一篇博客,很详细的汇总了j2中各个方面包的命名规范,给大家个网址:                

         http://blog.csdn.net/yilvqingtai/article/details/7989618

类名:[首字母大写+驼峰命名法]
        根据约定,Java类名通常以大写字母开头,如果类名称由多个单词组成,则每个单词的首字母均应为大 写例如TestDemo;如果类名称中  包含单词缩写,则这个所写词

        的每个字母均应大写,例如DOMDemo。

接口:[首字母大写+驼峰命名法]
        1:接口名的命名规范与类名一致;
        2:使用完整的英文描述命名接口。

方法:[驼峰命名+顾名思义]
       1:首字母小写,其他单词首字母大写,如:getName();
       2: 使用完整的描述来准确描述方法名,看到方法名就该知道这个方法的功能,例如:getNameByIdFromDB() 一看就知道是通过id   从数据库中获取name,虽然有点长,但 对后期理解和维护提供了极大方便,当然,为了防止代码冗长,还是应该尽量缩短名称长度,可以使用缩写的地方尽量使用缩写;
       3:方法名应该是一个动词+名词,例如getName();
      4: 前缀问题
           I:类的获取方法(有返回值的方法)的方法名一般加前缀get,如:getRootNode();
           II:类的布尔型判断方法一般以is为前缀,如isEmopty();
          III:类的设置方法加前缀set,如setName();
          IV:一般方法,使用完整的英文描述说明方法功能,以单词开头,如:openFile();

方法的参数
        1:使用有特定意义的词定义方法参数,如果可能的话使用与被赋值变量相同的名字;
        2;首字母小写,其他单词首字母大写

普通变量:[驼峰命名+顾名思义+前缀]
      1:采用驼峰命名;
      2:变量名要尽量简短,并且可以顾名思义,避免使用a,b,c等;
      3:避免相似或只在大小写上有区别,例如:flag和Flag,避免同时使用;
      4: 循环计数变量使用i,j,k
      5:前缀问题:
            I:可以在变量名前加2到3个字母的前缀表示变量的数据类型,例如:strClassName(以此表示String型)、intStudentAge(表示int型)等等;
           II:可以通过加前缀区分全局变量和局部变量,用g_表示全局变量,如g_strClassName。鉴 于全局变量难以维护,应该尽少全局变量的使用。
     6:后缀问题:
          I:为了创建统一的变量,通常在变量名后加一个量词后缀,例如strStudentFirst,strStudentLast,而不要使用strFirstStudent
            常用的量词后缀有First,Next,Prev,Last,Cur(一组变量中的当前变量)     

静态变量:[全部大写,常加下划线]
      1:全部大写,单词间用"_"连接,例如 static int THREAD_FLAG
      2:其他规则参照普通变量的规则2,3,5,6

常量:[全部大写,常加下划线]
      1:全部大写,单词间用"_"连接;
      2:常量本身要用有意义的单词定义;
   
xml
     1:xml文件名全小写;  

jsp/js等普通文件
     1:与class命名规则一致;

 


 

 

0 0