JAVA代码编程规范 n?oW < &
类的成员变量定义 S_iMVHe
];} Wfl
大部分类的成员变量应该定义为protected来防止继承类使用他们。 Q;MT"=RW
t$+?6E
数组标识 Xk:OL,c
9lTv
要用"int[]packets",而不是"intpackets[]",后一种永远也不要用。 ,K>I%_!1
y6@0O%TDN
成员变量与函数内局部变量用this Q0$8j-1I
T`/AY?#
publicvoidsetPackets(int[]packets){this.packets=packets;}//一般函数 sI43@[
,V'o4]H
CounterSet(intsize){this.size=size;}//构造函数 ,4hJT
he#J|p
可读性 DDvh4<Hk
sJ\BF
避免使用不易理解的数字,用有意义的标识来替代。不要使用难懂的技巧性很高的语句。 HPpR.
SEORSS
源程序中关系较为紧密的代码应尽可能相邻。 S,D8F&bg
"lQ*1.i
可移植性 ?M$.+V{a
3NZK*!@'
BorlandJbulider不喜欢synchronized这个关键字,如果你的断点设在这些关键字的作用域内的话,调试的时候你会发现的断点会到处乱跳,让你不知所措。除非必须,尽量不要使用。 s|@6S8E
-)s qc
P
换行 KTK <gV9:
(w&F/ynO:
如果要换行的话,尽量用println来代替在字符串中使用"\n"。 %/EVUN9=
/TE_W@?^
你不要这样:System.out.print("Hello,world!\n"); UT>s5C
T _M!<J
要这样:System.out.println("Hello,world!"); JgG$?n\
agkA}O
或者构造一个带换行符的字符串,至少要象这样: 5NBV[EP
U6=..K!q
Stringnewline=System.getProperty("line.separator"); \%u3
&9/O!3p)
System.out.print("Helloworld"+newline); b>_o xK
#1J &7F1
PrintStream Yi
.u"sh]
TPVVck-T8
PrintStream已经被不赞成(deprecated)使用,用PrintWrite来代替她。 B!
rTD5a
VzBqjE_
排版规范 ,l%CX.9
c _\YBe]wJ
关键词和操作符之间加适当的空格。 ;V@WtZv
%lL.[8r|
相对独立的程序块与块之间加空行。 ]d55m /(
2*rH?dz8E
较长的语句、表达式等要分成多行书写。 +nUy,S?43
Qg^cf<X{i
划分出的新行要进行适应的缩进,使排版整齐,语句可读。 P
D4Tz!F
$ oTdfb
长表达式要在低优先级操作符处划分新行,操作符放在新行之首。 NHB4y /2
Yj%U
>),8
循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分。 z
MLK7+
'AzDP;6qFI
若函数或过程中的参数较长,则要进行适当的划分。 Y_}mYvJW
uB |Ss
不允许把多个短语句写在一行中,即一行只写一条语句。 `/_o!(Z`
r/& sub"X
函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格。 $Vsk Ew"|M
FE" y\2}
编写程序块时‘{’和‘}’应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 - *F(7$
Kqun^"Df
性能 H|,Oswk~-
zG+R5:
在写代码的时候,从头至尾都应该考虑性能问题。这不是说时间都应该浪费在优化代码上,而是我们时刻应该提醒自己要注意代码的效率。比如:如果没有时间来实现一个高效的算法,那么我们应该在文档中记录下来,以便在以后有空的时候再来实现她。 4!$s}V=6
>Wh}f3C
不是所有的人都同意在写代码的时候应该优化性能这个观点的,他们认为性能优化的问题应该在项目的后期再去考虑,也就是在程序的轮廓已经实现了以后。 U QE qX
vQ<90ZxqB
不要在循环中构造和释放对象 %509\;el
zs%Hb48V
使用StringBuffer对象 vesJEaw7
L{:9Cx!F
在处理String的时候要尽量使用StringBuffer类,StringBuffer类是构成String类的基础。String类将StringBuffer类封装了起来,(以花费更多时间为代价)为开发人员提供了一个安全的接口。当我们在构造字符串的时候,我们应该用StringBuffer来实现大部分的工作,当工作完成后将StringBuffer对象再转换为需要的String对象。比如:如果有一个字符串必须不断地在其后添加许多字符来完成构造,那么我们应该使用StringBuffer对象和她的append()方法。如果我们用String对象代替StringBuffer对象的话,会花费许多不必要的创建和释放对象的CPU时间。 Tskq)NU
u83J@nDQ
避免太多或不必要的使用synchronized关键字 P-`M
"@evXql3`
,应该在必要的时候再使用她,这是个避免死锁的好方法。 OQ8 bI=?[x
m#ZO`W
代码测试、维护 -yR.<KnL
y'FS/=u>0
1.单元测试要求至少达到语句覆盖。 $\b$}wy*
"nm FzN
2.单元测试开始要跟踪每一条语句,并观察数据流及变量的变化。 t(GR)&>.2
pp.6Ex
(R
3.清理、整理或优化后的代码要经过审查及测试。 6)z?f4,
W-Fu -Cz=
4.代码版本升级要经过严格测试。