JAVA代码编程规范 5YeM%%-S
类的成员变量定义 'h|DO/X~L
P2#XKG
大部分类的成员变量应该定义为protected来防止继承类使用他们。 K8GP@yD]M
P-y jN
数组标识 <7/R,\Wg~
5m&9"T. w
要用"int[]packets",而不是"intpackets[]",后一种永远也不要用。 `ZyI!"
4;yKOQD|
成员变量与函数内局部变量用this keL&b/@
l5!|I:/*;
publicvoidsetPackets(int[]packets){this.packets=packets;}//一般函数 eD?tLj
k@ RDvn
CounterSet(intsize){this.size=size;}//构造函数 jaII r06
v3~? ;f,l
可读性 'vbsv T
n|9-KTe7|*
避免使用不易理解的数字,用有意义的标识来替代。不要使用难懂的技巧性很高的语句。 :LF?
{?}E^5Z*g
源程序中关系较为紧密的代码应尽可能相邻。 0zmE>/O+
r1 !@hT
可移植性 `yrB->|vG
f
e\$@-
BorlandJbulider不喜欢synchronized这个关键字,如果你的断点设在这些关键字的作用域内的话,调试的时候你会发现的断点会到处乱跳,让你不知所措。除非必须,尽量不要使用。 G\2CR*
/Kql>$I
换行 gY/"cq
h-q3U%R4}@
如果要换行的话,尽量用println来代替在字符串中使用"\n"。 [9evz}X
%[Wh [zZy
你不要这样:System.out.print("Hello,world!\n"); \XCe22x]
J\twZ>w~0
要这样:System.out.println("Hello,world!"); 6-N?mSQU
'3/4?wi
或者构造一个带换行符的字符串,至少要象这样: O_oPh] x)
"l3_=Gua
Stringnewline=System.getProperty("line.separator"); H1|?t+oP
N{9v1`B
System.out.print("Helloworld"+newline); gc_:%ki
il4^zj82
PrintStream [B\h$IcRv
xHvZV<#
PrintStream已经被不赞成(deprecated)使用,用PrintWrite来代替她。 B+P(M!m3
4gI/!,J(b
排版规范 jS]ru-5.
p& y<I6a,
关键词和操作符之间加适当的空格。 AYqX|
;DqWh0
相对独立的程序块与块之间加空行。 !;q&NHco
`i3NG1
v0
较长的语句、表达式等要分成多行书写。 q9KHmhUD
BO~0ON0
划分出的新行要进行适应的缩进,使排版整齐,语句可读。 HVR /7&g
x
nsLf?>]
长表达式要在低优先级操作符处划分新行,操作符放在新行之首。 AifWf2$S
4KhV|#-;k
循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分。 i1ixi\P{0
6tgt>\y
若函数或过程中的参数较长,则要进行适当的划分。 ]sf7{lVT
:%tU'w
不允许把多个短语句写在一行中,即一行只写一条语句。 ~7*.6YnI
6iVxc|Ia
函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格。 !JHL\M>A5
Ra)3+M!x
编写程序块时‘{’和‘}’应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 ]#)()6)2v
?PuBa`zDE
性能 '}ptj@,
]
{RDV A=]
在写代码的时候,从头至尾都应该考虑性能问题。这不是说时间都应该浪费在优化代码上,而是我们时刻应该提醒自己要注意代码的效率。比如:如果没有时间来实现一个高效的算法,那么我们应该在文档中记录下来,以便在以后有空的时候再来实现她。 ;w{tv($$
!"?#6-,Xn
不是所有的人都同意在写代码的时候应该优化性能这个观点的,他们认为性能优化的问题应该在项目的后期再去考虑,也就是在程序的轮廓已经实现了以后。 '.IW.{;$
#++lg{
不要在循环中构造和释放对象 sEp"D+f
b[r8e
使用StringBuffer对象 PCHu#5j_a
w1Nm&}V
在处理String的时候要尽量使用StringBuffer类,StringBuffer类是构成String类的基础。String类将StringBuffer类封装了起来,(以花费更多时间为代价)为开发人员提供了一个安全的接口。当我们在构造字符串的时候,我们应该用StringBuffer来实现大部分的工作,当工作完成后将StringBuffer对象再转换为需要的String对象。比如:如果有一个字符串必须不断地在其后添加许多字符来完成构造,那么我们应该使用StringBuffer对象和她的append()方法。如果我们用String对象代替StringBuffer对象的话,会花费许多不必要的创建和释放对象的CPU时间。 g0xuxK;9c
ZQ4p(6a
避免太多或不必要的使用synchronized关键字 kj#?whK6~
v|XTr,#
,应该在必要的时候再使用她,这是个避免死锁的好方法。 GFj{K
=)0,#9k U]
代码测试、维护 OcR$zlgs[v
%<\vGqsM
1.单元测试要求至少达到语句覆盖。 [\^n=
h]IxXP?h[
2.单元测试开始要跟踪每一条语句,并观察数据流及变量的变化。 1OGx>J6
|s7s6k)mm
3.清理、整理或优化后的代码要经过审查及测试。 ^bGNq
X
LM:vsG
4.代码版本升级要经过严格测试。