JAVA代码编程规范
]\e zES
类的成员变量定义 X>6a@$Mx P
7A|jnm
大部分类的成员变量应该定义为protected来防止继承类使用他们。 (~GFd7
Mww]l[1'EL
数组标识 FS}z_G|4]
o%5bg(
要用"int[]packets",而不是"intpackets[]",后一种永远也不要用。 p{J_d,JH
~z}au"k
成员变量与函数内局部变量用this aS7zG2R4H
`+o.w#cl
publicvoidsetPackets(int[]packets){this.packets=packets;}//一般函数 1m)/_y~1
k
/fq6-;co+
CounterSet(intsize){this.size=size;}//构造函数 N
[u
Xo
Nw2 bn
可读性 lBdF9F<
K0g:Q*J-
避免使用不易理解的数字,用有意义的标识来替代。不要使用难懂的技巧性很高的语句。 ,H?p9L; qp
>cNXB7]E>
源程序中关系较为紧密的代码应尽可能相邻。 4Dia#1$:J
v^pP&
<G
可移植性 QA(,K}z~^S
&3f.78a
BorlandJbulider不喜欢synchronized这个关键字,如果你的断点设在这些关键字的作用域内的话,调试的时候你会发现的断点会到处乱跳,让你不知所措。除非必须,尽量不要使用。 `[&2K@u
kk'w@Sn.(
换行 (r4VIlap
WLLv a<{
如果要换行的话,尽量用println来代替在字符串中使用"\n"。 72zuI4&
0Y2^}u@5
你不要这样:System.out.print("Hello,world!\n"); N0[I2'^.
Cpcd`y=IN
要这样:System.out.println("Hello,world!"); yp^* TD/J
=7Vl{>*1N
或者构造一个带换行符的字符串,至少要象这样: Z5L1^
i)i)3K2
Stringnewline=System.getProperty("line.separator"); )^Pvm
:(`>bY
System.out.print("Helloworld"+newline); ] <3?=$
<WJ0St
PrintStream 8M9\<k6
Td1ba ^J
PrintStream已经被不赞成(deprecated)使用,用PrintWrite来代替她。 5]l7Z35
!u}3H|6~
排版规范 vCSB8R
pHB35=p28
关键词和操作符之间加适当的空格。 oQ nk+> }%
,nR8l
相对独立的程序块与块之间加空行。 ;Ph )BY<
<]^;/2.B
较长的语句、表达式等要分成多行书写。 V )k, 9=
dMmka
划分出的新行要进行适应的缩进,使排版整齐,语句可读。 m8j-lNu
K]!u@I* K"
长表达式要在低优先级操作符处划分新行,操作符放在新行之首。 oz6+rM6MY
n
E}<e:
循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分。 n qLAby_
(TNY2Ke2 8
若函数或过程中的参数较长,则要进行适当的划分。 OsL%SKs|
zWs*kTtA
不允许把多个短语句写在一行中,即一行只写一条语句。 }K80G~O2<
,/`E|eG1G
函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格。 :LiDJF
S?7V
"LF
编写程序块时‘{’和‘}’应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 - (_e=3$
nH>V Da
性能 eSX[J6
O| J`~Lk
在写代码的时候,从头至尾都应该考虑性能问题。这不是说时间都应该浪费在优化代码上,而是我们时刻应该提醒自己要注意代码的效率。比如:如果没有时间来实现一个高效的算法,那么我们应该在文档中记录下来,以便在以后有空的时候再来实现她。 cia-OVX
Mq:'-`
不是所有的人都同意在写代码的时候应该优化性能这个观点的,他们认为性能优化的问题应该在项目的后期再去考虑,也就是在程序的轮廓已经实现了以后。 V.Ba''E7
3V
Mh)
不要在循环中构造和释放对象 20l_ay
Z1$];Q\cX
使用StringBuffer对象 gO:Z6}3vM
2PR7M.V7
在处理String的时候要尽量使用StringBuffer类,StringBuffer类是构成String类的基础。String类将StringBuffer类封装了起来,(以花费更多时间为代价)为开发人员提供了一个安全的接口。当我们在构造字符串的时候,我们应该用StringBuffer来实现大部分的工作,当工作完成后将StringBuffer对象再转换为需要的String对象。比如:如果有一个字符串必须不断地在其后添加许多字符来完成构造,那么我们应该使用StringBuffer对象和她的append()方法。如果我们用String对象代替StringBuffer对象的话,会花费许多不必要的创建和释放对象的CPU时间。 g"]<J&
noh|/sPMD
避免太多或不必要的使用synchronized关键字 mKq<'t]^k
4Wla&yy
,应该在必要的时候再使用她,这是个避免死锁的好方法。 _TOi
[GT
Ue3B+k9w
代码测试、维护 |Sr\jUIWn
PG6L]o^
1.单元测试要求至少达到语句覆盖。 &cu] vw
+t>*l>[
2.单元测试开始要跟踪每一条语句,并观察数据流及变量的变化。 Vo9>o@FlLM
4" ,
)zDk
3.清理、整理或优化后的代码要经过审查及测试。 nEd
M_JPv
[T 4 pgt'H
4.代码版本升级要经过严格测试。