良好的命名规则以及代码风格可以看出来一个程序员的功底,好多公司也会注重这方面,他们招聘员工在有些时候往往就是根据一个人的代码风格来招人,所以下面就就我知道的代码风格作简要的说明一下。Java命名一般为选择有意义的名字,能快速地传达该类的用途,同时参照java驼峰命名法来命名。

 

project)都是小写,不加点,不加下划线,不用特殊符号就行了,但千万不要用中文,后果严重会乱码或错误的!

 

(package):用于将完成不同功能的类分门别类,放在不同的目录(包)下,包的命名规则:对于包名:每个字母都需要小写,每一个公司都有自己公司的特有的包,所以公司就将公司域名反转作为包名。比如 www.sohu.com 包名com.sohu;该包下的Test类的全名是:com.sohu.Test.java 。

package,那么java就认为我们所定义的类位于默认包里面(default package)。另外,package 行要在import 行之前,import 中标准的包名要在本地的包名之前,而且按照字母顺序排列。如果import 行中包含了同一个包中的不同子目录,则应该用 * 来处理。例如:

package hotlava.net.stats;
import java.io.*;
import java.util.Observable;
import hotlava.util.Application;

这里 java.io.* 是用来代替InputStream and OutputStream 的。

 

     3:类( class ):首字母大写,如果一个类由多个单词构成,那么每个单词的首字母都大写,而且中间不使用任何的连接符。尽量使用英文。如 class ConnectionFactory....

 

Interface):采用完整的英文描述符说明接口封装,所有单词的第一个字母大写。习惯上,名字后面加上后缀 able, ible 或者 er。例如:Contactable,Prompter。当要区别接口类和实现类的时候,可以在类的后面加上“Impl”。如:接口类:UserInterface.java   接口实现类:UserInterfaceImpl.java

 

  5:属性、方法:首单词全部小写,如果一个方法由多个单词构成,那么从第二个单词开始首字母大写,不使用连接符。命名时应该使其简短而又有特定含义,简洁明了的向使用者展示其使用意图。如:addPerson , ageOfPerson

 

  6:常量:所有单词的字母都是大写,如果有多个单词,那么使用下划线链接即可。

如:

public static final int AGE_OF_PERSON = 20; //通常加上static

 

:约定变量(临时变量):通常i、j、k、m和n代表整型变量;c、d和e代表字符型变量。循环计数变量通常采用字母 i,j,k 或者 counter。

 

Component):使用完整的英文描述来说明组件的用途,末端应接上组件类型。例如:okButton,customerList,fileMenu。

 

:类中常用方法的命名:

 

get,例如getFirstName(), getLastName()。

 

is 做前缀,如isPersistent(),isString()。或者使用具有逻辑意义的单词,例如equal 或equals

 

void):被访问字段名的前面加上前缀 set,例如

setFirstName(),setLastName(),setWarpSpeed()
 
openFile(), addAccount()。

 

   e)、 构造方法应该用递增的方式写(比如:参数多的写在后面)。例如:

public CounterSet(){}               public CounterSet(int size){ this.size = size;}

 

方法:一般情况下,每一个类都应该定义toString 方法,其格式为:public String toString() {…}

 

main()方法,其中包含用于测试那个类的代码,如果包含了main() 方法, 那么它应该写在类的底部。

 

c/c++影响大多人习惯用这种方式命名:byte buffer[]; 但实际上数组应该总是用下面的方式来命名:

:其他代码中注意部分:

 

软工Java命名规则属性命名规则 java工程命名_软工Java命名规则属性命名规则

、如果需要对变量名进行缩写时,一定要注意整个代码中缩写规则的一致性。例如,如果在代码的某些区域中使用intCnt,而在另一些区域中又使用 intCount,就会给代码增加不必要的复杂性。建议变量名中尽量不要出现缩写。

c、对于枚举全大写,用下划线分割,如:

public enum Events { ORDER_PAID, ORDER_CREATED }

d、对于下列代码

if(a > b) {
  return true;
}else{
  return false;
}

这样看着多此一举何不直接用

return a > b;
 
if(a > b){
  return a;
}else{
  return b;
}

何不直接这样让人看着简单明了

return a > b ? a : b;

   

、空格的使用

如下: a + b = c; b - d = e; return a == b ? 1 : 0;

不要如下: a+b=c; b-d=e; return a==b?1:0;

、逗号的使用

如下: call(a, b, c); 不要如下: call(a,b,c);

、注释的使用

//, 多行时用 /* .. */。这样让人看着简直就能明白你的代码表达出来的意思。让别人能够读懂你的代码。

、每个if while for等语句,都不要省略大括号{}

看下面的代码: if (a > b) a++; 如果在以后维护的时候,需要在a > b 时,把b++,一步小心就会写成: if (a > b) a++; b++; 这样就错了,因为无论a和b是什么关系,b++都会执行。 如果一开始就这样写: if (a > b) { a++; } 相信没有哪个笨蛋会把b++添加错的。而且,这个大括号使作用范围更明显,尤其是后面那行很长要折行时。

、善用TODO:

在代码中加入 //TODO: ,大部分的ide都会帮你提示,让你知道你还有什么事没有做。比如:

、不要再对boolean值做true false判断

比如: if (order.isPaid() == true) { // Do something here } 不如写成: if (order.isPaid()) { //Do something here }

、减少代码嵌套层次

代码嵌套层次达3层以上时,一般人理解起来都会困难。下面的代码是一个简单的例子:

public void demo(int a, int b, int c) {
   if (a > b) {
     if (b > c) { 
      doJobA(); 
    } else if (b < c) {
       doJobB() 
    }
   } else {
     if (b > c) {
       if (a < c) { 
        doJobC(); 
      }
     } 
  } 
}

减少嵌套的方法有很多:

  • 合并条件
  • 利用 return 以省略后面的else
  • 利用子方法

比如上例,合并条件后成为:

public void demo(int a, int b, int c) {
  if (a > b && b > c) {
    doJobA();
  }
  if (a > b && c > b) {
    doJobB();
  }
   if (a <= b && c < b && a < c) {
    doJobC();
  }
}

如果利用return 则成为:

public void demo(int a, int b, int c) {
   if (a > b) {
     if (b > c) {
      doJobA();
      return;
    }
    doJobB()
    return;
  }
  if (b > c) {
     if (a < c) {
     doJobC();
         }
   }
}

利用子方法,就是将嵌套的程序提取出来放到另外的方法里。