JAVA代码编程规范 q_-ma_F#s
类的成员变量定义 Kp8fh-4_
IbF4k.J
大部分类的成员变量应该定义为protected来防止继承类使用他们。 Hr(6TLNw
7 n\mj\
数组标识 I%SuT7"Do
E3y6c)<
要用"int[]packets",而不是"intpackets[]",后一种永远也不要用。 Nfr:`$k
_B}9f
成员变量与函数内局部变量用this *U
M!(
+Dd"41
publicvoidsetPackets(int[]packets){this.packets=packets;}//一般函数 <F ew<r2
!IN@i:m
CounterSet(intsize){this.size=size;}//构造函数 9t#P~>:jY}
]Qd{ '}+
可读性 hXNH"0VCV
itw{;j
避免使用不易理解的数字,用有意义的标识来替代。不要使用难懂的技巧性很高的语句。 p7s@%scp
wcwQj Hwd
源程序中关系较为紧密的代码应尽可能相邻。 ` ovgWv
+)zDA:2Wa"
可移植性 :"V ujvFX
+yCTH
BorlandJbulider不喜欢synchronized这个关键字,如果你的断点设在这些关键字的作用域内的话,调试的时候你会发现的断点会到处乱跳,让你不知所措。除非必须,尽量不要使用。 ^/k,
:VJV 5f{
换行 Z{} n8b*
`v~!H\q
如果要换行的话,尽量用println来代替在字符串中使用"\n"。 TiQ^}5~M
W,DZ ;).%
你不要这样:System.out.print("Hello,world!\n"); NIaF 5z
8-ZUS|7B
要这样:System.out.println("Hello,world!"); '[Xl>Z[
3^XVQS***
或者构造一个带换行符的字符串,至少要象这样: Nl
{7
Qo.Uqz.C
Stringnewline=System.getProperty("line.separator"); Q{[@`bZB
N};t<Xev
System.out.print("Helloworld"+newline); pr$~8e=c
)%qtE34`
PrintStream *
MEe,4
f|#8qiUS
PrintStream已经被不赞成(deprecated)使用,用PrintWrite来代替她。 )yrAov\z*
yc[(lq.^n
排版规范 S.W^7Ap
qi&D+~Gv!
关键词和操作符之间加适当的空格。 'PpZ/ry$
XMw.wQ'?
相对独立的程序块与块之间加空行。 a8zZgIV
+;dXDZ2
较长的语句、表达式等要分成多行书写。 (UGol[f<
3{e'YD~hP
划分出的新行要进行适应的缩进,使排版整齐,语句可读。 1%jH^,t/m
ZE
rdt:w
长表达式要在低优先级操作符处划分新行,操作符放在新行之首。 L,$3Yj
R*bmu
循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分。 (ii(yz|
w12}Rn8
若函数或过程中的参数较长,则要进行适当的划分。 =Dk7RKoHF
\(fq8AL?
不允许把多个短语句写在一行中,即一行只写一条语句。 4H-j
.|e
,Kw5Ro`I:
函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格。 76bc]o#
2m" _z
编写程序块时‘{’和‘}’应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 9B=1Yr[
[7.agI@=
性能 _mk5^u/u
41yOXy ;~l
在写代码的时候,从头至尾都应该考虑性能问题。这不是说时间都应该浪费在优化代码上,而是我们时刻应该提醒自己要注意代码的效率。比如:如果没有时间来实现一个高效的算法,那么我们应该在文档中记录下来,以便在以后有空的时候再来实现她。 J633uH}}
OH6n^WKY
不是所有的人都同意在写代码的时候应该优化性能这个观点的,他们认为性能优化的问题应该在项目的后期再去考虑,也就是在程序的轮廓已经实现了以后。 cDeZMsV
]Ik%#l.G_
不要在循环中构造和释放对象 \$pkk6Q3,w
kjE*9bUc
使用StringBuffer对象 L/i(KF{
55m<XC
在处理String的时候要尽量使用StringBuffer类,StringBuffer类是构成String类的基础。String类将StringBuffer类封装了起来,(以花费更多时间为代价)为开发人员提供了一个安全的接口。当我们在构造字符串的时候,我们应该用StringBuffer来实现大部分的工作,当工作完成后将StringBuffer对象再转换为需要的String对象。比如:如果有一个字符串必须不断地在其后添加许多字符来完成构造,那么我们应该使用StringBuffer对象和她的append()方法。如果我们用String对象代替StringBuffer对象的话,会花费许多不必要的创建和释放对象的CPU时间。 {G*OR,HN
u7].}60.'
避免太多或不必要的使用synchronized关键字 =~ jAoOC@
10O$'`
,应该在必要的时候再使用她,这是个避免死锁的好方法。 "U8S81'
78]gtJ
代码测试、维护 CVQB"L
C-w5KW
1.单元测试要求至少达到语句覆盖。 Cj^{9'0
ipjkZG@
2.单元测试开始要跟踪每一条语句,并观察数据流及变量的变化。 Hg+
F^2<y
cj
g.lzYH
3.清理、整理或优化后的代码要经过审查及测试。 }ZzLs/v%X
%|+E48
4.代码版本升级要经过严格测试。