QQ登录

只需要一步,快速开始

 注册地址  找回密码
查看: 5117|回复: 6
打印 上一主题 下一主题

[转帖]JAVA编程规范

[复制链接]
字体大小: 正常 放大
god        

206

主题

2

听众

882

积分

升级  70.5%

该用户从未签到

新人进步奖

跳转到指定楼层
1#
发表于 2005-3-31 01:32 |只看该作者 |倒序浏览
|招呼Ta 关注Ta
定义这个规范的目的是让项目中所有的文档都看起来像一个人写的,增加可读性,减少项目组中因为换人而带来的损失。(这些规范并不是一定要绝对遵守,但是一定要让程序有良好的可读性)  
9 S  J7 L; g1 j2 X0 n/ Z- b( m) G( x' J/ _" t$ H
5 i( _. n$ G# q% ^
Package 的命名  
' T1 s/ ?1 ~% d9 ]. l1 uPackage 的名字应该都是由一个小写单词组成。  4 W% s! W/ b* `
Class 的命名  - X' M5 c: B, N7 z
Class 的名字必须由大写字母开头而其他字母都小写的单词组成  
" R( Y6 y4 z3 `% z! _5 e7 n; W' sClass 变量的命名  , r# O2 d3 F1 p$ t. S5 h  A9 a9 z
变量的名字必须用一个小写字母开头。后面的单词用大写字母开头。  
1 g: c  ?6 `9 M1 \  TStatic Final 变量的命名  
+ W; e# v% x6 QStatic Final 变量的名字应该都大写,并且指出完整含义。  0 ~8 Y/ |6 H+ S9 P  f
参数的命名  
  a2 G. F" y+ n8 }7 C! ]& R参数的名字必须和变量的命名规范一致。  . }" Z3 k+ m/ k8 f9 q
数组的命名  9 h4 C2 C" m/ Q  |6 x8 c/ C% C+ A! O
数组应该总是用下面的方式来命名:  , R1 F( I( G- k$ f  C$ n/ |
( j# v' O% t! }
byte[] buffer;
+ N3 |) d; ]4 ?/ u8 c" ^" o9 l2 _* I% L8 M# o

, R  \& G8 [4 k+ ^  p1 X4 I1 t而不是:  1 s$ c$ E% y1 R+ b9 R: ^/ @

5 v' z, W2 x: z% r# F4 Kbyte buffer[]; 3 @  Z( R8 t2 [& _0 O
6 y, s( v8 `' G2 p$ T
' s: j4 f6 H$ G# O
, t8 A$ I5 Q! @4 _# u
方法的参数  
: T; \+ F5 w6 p1 J& E$ ?: D/ X使用有意义的参数命名,如果可能的话,使用和要赋值的字段一样的名字:  " f! `9 V" G: z8 @: n& W% i

' v, t' N0 C, e  S" nSetCounter(int size){
8 L8 Q, y% m8 j$ @1 f0 |" Fthis.size = size; 3 s# u: I4 h8 w, T5 E" F
}
7 h6 ?; v6 ]3 l( e5 C. V; v" f& V+ o9 I5 {( Z
5 |# J) e$ H; k

2 \+ I2 i( P- v+ B+ f$ o( C* e' `. [# E7 {4 y7 g
Java 文件样式  3 ]6 z+ G0 g7 L: O) w! T8 Y
所有的 Java(*.java) 文件都必须遵守如下的样式规则  
" M) e1 k% q5 \  J! ?  W- \  C  o( N+ ~% M3 \- N5 o5 s

2 I0 t0 O7 m4 ~2 P; C版权信息  1 G/ U. b  P6 A8 O$ k
版权信息必须在 java 文件的开头,比如:  - b3 E9 z5 f+ {& s6 V

; N; ^2 a( J8 A: q/ w8 r/**   W& B1 r# H2 }1 `5 y
* Copyright ® 2000 Shanghai XXX Co. Ltd. 1 q  n) o. }! _9 X! z! K5 o
* All right reserved. 9 \$ d7 R9 J% t/ P5 K
*/ 4 @  I& B" d8 X
, u* _- g, ^2 m6 n) A& _
, A: p9 _/ D/ j9 ?
其他不需要出现在 javadoc 的信息也可以包含在这里。 ; R: K& Q6 W2 w+ b
2 f4 c* C( o: ?- T, y$ R2 `. }

7 {- {7 ?- T- U2 o! HPackage/Imports  4 O+ {. B0 e: k: |
package 行要在 import 行之前,import 中标准的包名要在本地的包名之前,而且按照字母顺序排列。如果 import 行中包含了同一个包中的不同子目录,则应该用 * 来处理。  
, H* A+ w* W' T+ u4 ?2 D$ f- z8 z
package hotlava.net.stats; - Y* x, m, g: I' p

4 B& U$ z( A2 T3 V5 I; mimport java.io.*; 6 M' k9 _) e4 ~
import java.util.Observable; ; L4 ?$ ?6 O+ B1 I8 s
import hotlava.util.Application; 3 g, P# P8 B1 Z* m$ j

1 t  \! W: N3 S, h9 e2 j
( C! f0 h- i2 M6 Z& N7 z这里 java.io.* 使用来代替InputStream and OutputStream 的。 " h# ]" [5 ?5 t6 ?- M, C7 c4 G1 Q

- t% u( F" R( _  c& k
+ g2 Y3 \, _* c" n6 \3 A% dClass  
  j9 l3 E( p5 t3 \4 T, k' [% t接下来的是类的注释,一般是用来解释类的。  
  Z$ Y% K$ \/ R5 S' V$ C1 _2 a7 u9 _) y$ v+ R2 A" v4 C( v( Z, K
/** 7 B, `) S' w0 i
* A class representing a set of packet and byte counters
6 s/ o3 ?+ v) U$ H1 S  h* It is observable to allow it to be watched, but only ' c. H) J5 ?0 \3 r" R: h
* reports changes when the current set is complete
- {2 L9 ?$ o+ n*/
( `! F3 E- F# ?2 t  w& P
$ u! n+ x& r1 P0 ]  C" S' ]1 E# F. u" D4 W% k
接下来是类定义,包含了在不同的行的 extends 和 implements  
' e4 b" I- P# V1 r
1 K' [& }4 X$ hpublic class CounterSet # w5 h3 N' C  l# o; A! z
extends Observable : S8 [9 o2 i  r
implements Cloneable 6 [' F% i" m7 ~4 b
. f- P6 W2 A" E) S

' @( A' o+ x' a6 F1 D% t) [  W
Class Fields  ( J$ A2 H! {* _9 N+ n! m! S5 a6 g
接下来是类的成员变量:  
) [" A' j$ Q2 H4 T7 ]: b" u) N7 [! A7 ^, a: a
/**
: }8 n' u# g3 S/ r( Y* Packet counters
6 e, j: p8 G1 n( K  g; W5 Z( @) Y*/ 5 a# N# D; x9 s9 f9 ]: i
protected int[] packets; & f. j# M3 N8 e, O
8 G- b8 v! t9 V4 T5 b
: G6 c! U! o- s; e7 z1 p/ f
public 的成员变量必须生成文档(JavaDoc)。proceted、private和 package 定义的成员变量如果名字含义明确的话,可以没有注释。
! ]  a2 R2 X# e' B" t* q5 G4 Z
. A7 M" u: W" x. R7 v- N
, j; [  c% A0 R* q存取方法  ( F( J8 P0 [1 w' ^5 X* g4 D
接下来是类变量的存取的方法。它只是简单的用来将类的变量赋值获取值的话,可以简单的写在一行上。  
, y9 r: O& {5 W  y/ y
: Y+ [$ I- U0 A/** + P/ z/ ~. t7 C, y+ e
* Get the counters
- A+ c4 j' S9 k' A2 F+ \* @return an array containing the statistical data. This array has been
' S7 r3 w& M( t* freshly allocated and can be modified by the caller.
5 g1 ]2 \! G; \1 n*/
3 ~5 R6 U& \' s3 |$ T( g+ q: Dpublic int[] getPackets() { return copyArray(packets, offset); }
& \7 e8 c/ v5 }, H- Ipublic int[] getBytes() { return copyArray(bytes, offset); }
( D7 k9 }% k# x, D5 v6 ~0 b; r! S1 f% r" d
public int[] getPackets() { return packets; }
# d4 [6 ?. y6 I2 H; \! }* Z3 Dpublic void setPackets(int[] packets) { this.packets = packets; }
0 B# j, ~7 C4 e" Q8 J; }其它的方法不要写在一行上 9 |6 w6 v* S6 q) m; V) g# `
构造函数  
  u4 d! B& s8 @- s: i接下来是构造函数,它应该用递增的方式写(比如:参数多的写在后面)。  
) g$ g0 e& B+ p访问类型 ("public", "private" 等.) 和 任何 "static", "final" 或 "synchronized" 应该在一行中,并且方法和参数另写一行,这样可以使方法和参数更易读。  
) p% @2 P" Q/ M4 b' R% u) M9 ]3 U1 q/ E0 i" U, c: |
public
4 \( X2 w4 I1 I& J0 d3 ^. i" A- r& ]: JCounterSet(int size){
' A: I6 R1 r8 z4 Y# a8 ?( q: Vthis.size = size; % B5 }# [- ~1 o& B  {( G* F8 ]
} 7 u6 D0 R$ U2 I4 U" i. d2 `! X
$ e! l+ J- k/ E9 T) E( U

! g( x2 B: z/ y4 ~- ?
( T6 r9 p! d. s3 y7 a7 f0 x克隆方法  * G4 W/ o/ a4 w6 e- o4 U3 p
如果这个类是可以被克隆的,那么下一步就是 clone 方法:  # o  i3 S8 H7 i$ z0 @

+ e% J0 S% v: T, ~3 S2 ]2 G" dpublic
5 d( H6 u( R, h) z1 s. }. cObject clone() { * b0 G. o; f* r$ q, h1 U
try { 6 S2 J! r. ?. u$ U
CounterSet obj = (CounterSet)super.clone();
% \5 q+ u( ?& ^! q4 Mobj.packets = (int[])packets.clone();
* `9 _+ t$ L: f5 K+ Zobj.size = size;
( H6 M& a( c, E1 Z% |7 g- qreturn obj; . n2 l7 A0 ^3 h
}catch(CloneNotSupportedException e) { 8 b2 a- ^$ H9 X* F, g) f
throw new InternalError("Unexpected CloneNotSUpportedException: " + e.getMessage()); 9 a4 Y. E/ R( _) N) u) ~' C
} - Q/ S; Y9 ~& `6 R+ ?7 J- I, n+ w
} $ r# X) X# t% ~& \* Z

7 L) |, @$ g& {% v2 ^
+ ?" \' Q, Y# \  X
2 J9 S  [% M! _/ e  q1 w类方法  3 y% e; u  Q& g% G/ n  f
下面开始写类的方法:  
8 }; E8 }  Y' R# |& r9 T$ ]2 P+ o0 u2 i5 M2 t* ]
/**
& B# k3 ~" x% o" m$ f5 z- X* ^( ~% x. f* Set the packet counters
. S. Y2 U; R* O8 Y% v$ O) q* (such as when restoring from a database) ; _+ X7 `1 t! F: y; f3 Y
*/ 5 u& N2 D" L5 e) F1 W* \& f* f% i
protected final
1 t1 |. _4 e2 A% g/ p' Jvoid setArray(int[] r1, int[] r2, int[] r3, int[] r4)
  s4 H$ ~  e1 f5 U" P6 @throws IllegalArgumentException 4 d5 S  B7 D+ a1 D0 B* V
{
6 t( i% o" {. [6 s6 [8 L* s// / D" O. q5 ^/ U2 F/ U8 D2 `" G9 q. n
// Ensure the arrays are of equal size
) O, J) `7 K3 q# h  U( S//
; B% M, `$ A7 I4 d& `% D4 Sif (r1.length != r2.length || r1.length != r3.length || r1.length != r4.length) & \. o( ]9 B* K! |
throw new IllegalArgumentException("Arrays must be of the same size"); 8 q' U0 [9 f2 w4 E/ Z, q2 G
System.arraycopy(r1, 0, r3, 0, r1.length); 3 o) K  U5 ]5 C" \7 J5 w
System.arraycopy(r2, 0, r4, 0, r1.length); & s/ @3 V2 {  R6 Y4 x
}
$ u8 l4 w) M. @
9 c) P8 a8 Y2 H2 b
1 R7 {" e& @4 t1 S8 d5 P7 |8 q. K& r
- U* T6 m- m) J" L  N; {
. b. Q- q3 N" X0 E- [9 MtoString 方法  
+ b5 u, n5 ?3 J  j4 @; H' J1 Q无论如何,每一个类都应该定义 toString 方法:  2 b5 s" T( Q8 A4 J

" w: m9 M0 _0 bpublic
9 |0 j2 m8 A8 R6 E0 f( jString toString() {
/ n; L: _0 N+ [  |String retval = "CounterSet: ";
0 X/ `! c8 o. g0 z; g, s, bfor (int i = 0; i < data.length(); i++) {
$ g9 q$ S) o, J! u7 w) Jretval += data.bytes.toString();
! J; Q% K2 o- b" G' }/ r6 dretval += data.packets.toString(); . o! Z1 v3 H7 A
}
$ g+ R/ }+ t* ]+ T0 V% ^return retval;
' {4 R- t; J( {" Z% {8 R  Z: a9 G: D}
+ V! ~/ h/ @9 \: ~  Q7 I0 }}
3 g  Z, E% m3 S5 a4 {0 I8 {' s4 z2 y

& p; w# G! r9 p: D6 v/ ^. `( ]4 E, \5 `4 E5 |! @" |
main 方法  # ^4 U- d7 M1 J, X
如果main(String[]) 方法已经定义了, 那么它应该写在类的底部.  / j( P% L/ Q. o5 k
) D. y' T; `7 ?' U1 `6 O
代码编写格式  
$ m, A* v9 f( j  B- n
) n1 M" P; A' r/ @8 J; V+ Q5 G1 X/ g2 ]2 L" z# J
代码样式  : P, V7 R1 Z! c  \
代码应该用 unix 的格式,而不是 windows 的(比如:回车变成回车+换行)  5 r' |3 k; j/ B, E% M- `5 Y
文档化  6 u2 @# N) x0 n3 e0 k4 p
必须用 javadoc 来为类生成文档。不仅因为它是标准,这也是被各种 java 编译器都认可的方法。使用 @author 标记是不被推荐的,因为代码不应该是被个人拥有的。  * z! L5 }5 x' @! ^/ f# q
缩进  , T5 }( S, h9 ]7 X3 X* Z- f' A: _
缩进应该是每行2个空格. 不要在源文件中保存Tab字符. 在使用不同的源代码管理工具时Tab字符将因为用户设置的不同而扩展为不同的宽度.  ( X6 ~  M  Q/ N6 Y
如果你使用 UltrEdit 作为你的 Java 源代码编辑器的话,你可以通过如下操作来禁止保存Tab字符, 方法是通过 UltrEdit中先设定 Tab 使用的长度室2个空格,然后用 Format|Tabs to Spaces 菜单将 Tab 转换为空格。  
, Y& I. K' ^3 j3 r页宽  ! J0 e' v: C5 I6 j! j% v% O; n
页宽应该设置为80字符. 源代码一般不会超过这个宽度, 并导致无法完整显示, 但这一设置也可以灵活调整. 在任何情况下, 超长的语句应该在一个逗号或者一个操作符后折行. 一条语句折行后, 应该比原来的语句再缩进2个字符.  
. I2 n7 n! z8 j% W{} 对  
4 S- B6 j- L" j1 i+ v. k+ ^{} 中的语句应该单独作为一行. 例如, 下面的第1行是错误的, 第2行是正确的:  
6 A: R" c* ^: w9 o! M
: f% B, K. b) o& r% fif (i>0) { i ++ }; // 错误, { 和 } 在同一行  
5 m# @5 p& C: P& D! m) _3 X" s
if (i>0) {  
- J. F0 x% ?# D8 ?; }* Z- }i ++  : l( @" H# _* Y! C8 `; n/ Z
}; // 正确, { 单独作为一行  
) ~, ]- Q( G+ A
, V! l2 a: F5 b: c( I4 _. u* ], ?& [
} 语句永远单独作为一行.  
( }# G/ b0 f3 j# G  w1 P2 E! N; g9 R6 p! F% @8 v3 Q/ g3 g  \
- w4 r3 ?% F) [% R9 S$ d% s
如果 } 语句应该缩进到与其相对应的 { 那一行相对齐的位置。 ) P. ?  R, `+ E1 @1 D! i' a
: J: {; k$ O( M) B3 P! l

7 r5 d9 ~9 @' q$ M  l8 B) L括号  0 ?0 W# M/ ]2 T, p; J; I- h+ C" Y
左括号和后一个字符之间不应该出现空格, 同样, 右括号和前一个字符之间也不应该出现空格. 下面的例子说明括号和空格的错误及正确使用:  
8 N0 I0 p7 Q6 M. B8 L" C, ?3 s) K# b% b9 g1 ]; s+ M
CallProc( AParameter ); // 错误  ' E, z+ K6 ~8 ~
CallProc(AParameter); // 正确  
) T% ?, b  f" E& S
/ ~+ W6 U. p) P: _不要在语句中使用无意义的括号. 括号只应该为达到某种目的而出现在源代码中。下面的例子说明错误和正确的用法:  
$ ?% q$ h  ?+ k/ M$ A$ B$ l
( t; i+ g9 @" d  f* [if ((I) = 42) { // 错误 - 括号毫无意义  ) {' z( R2 e) z" ^. Y6 }
if (I == 42) or (J == 42) then // 正确 - 的确需要括号  - f# J$ l5 Q1 N, ~

8 F/ M/ J* @" D程序编写规范  
; x' [$ |, J3 L8 Q
1 ~$ E6 g% x' \' t3 y. H$ L
6 Y5 f4 Y6 f' O2 h2 N9 ~; Cexit()  & @. m$ U0 I2 z' `
exit 除了在 main 中可以被调用外,其他的地方不应该调用。因为这样做不给任何代码代码机会来截获退出。一个类似后台服务地程序不应该因为某一个库模块决定了要退出就退出。  
% @2 K( j7 ?0 e" M7 d异常  0 t3 T5 k& O! e( \+ ~  Z
申明的错误应该抛出一个RuntimeException或者派生的异常。  ; e- `9 {( d, H- J/ Y$ i3 ]% `
顶层的main()函数应该截获所有的异常,并且打印(或者记录在日志中)在屏幕上。  - U+ V4 j/ p; i+ I$ D
垃圾收集  
' w6 I# `! R7 rJAVA使用成熟的后台垃圾收集技术来代替引用计数。但是这样会导致一个问题:你必须在使用完对象的实例以后进行清场工作。比如一个prel的程序员可能这么写:  
& d' J9 `; r5 x1 G
$ W% G6 Q) o& C# [7 K...
  `, _1 {* |! Q/ [  b{ ) E1 V% W' ?) Z, c, Q
FileOutputStream fos = new FileOutputStream(projectFile);
+ p7 V+ v, P6 o+ G& M* n; q/ Tproject.save(fos, "IDE Project File");  
9 G' v* ]+ N. I' H6 A}
) H7 ~: r. ^$ w% p# p: h5 ^  y...
3 u, ]: W, e7 D! b# [% {) {5 m: Y6 i  p+ g- j; r# f9 e
, O. r1 M6 |+ |" ~( q$ h5 j( u
除非输出流一出作用域就关闭,非引用计数的程序语言,比如JAVA,是不能自动完成变量的清场工作的。必须象下面一样写:  : t. N4 J6 C) z( b9 e- @. _
+ z3 b, @" F6 B; _, O9 {$ Q7 M
FileOutputStream fos = new FileOutputStream(projectFile);
$ ^* J# B% I. \" Kproject.save(fos, "IDE Project File");  2 B/ D# D8 E4 q' P: J- h: M
fos.close(); 6 S1 r! Q4 ^6 C8 R- a; k
& c- @& P4 [3 M, y/ f
" L1 R  ]* Q' t
% c) N' f/ s' O, r) W' ?0 ~
Clone  ' M8 ^5 u2 t  Y( [2 F$ W
下面是一种有用的方法:  
2 N1 P+ P3 e8 M/ u# q& o0 ]" L- J$ l* ], v! d4 z; z# b
implements Cloneable
$ {, m! r0 m' z, v5 k' H* G  j8 F6 G" z9 a  }1 K
public + {" V. a) Y( t$ g; o; V0 U, I
Object clone() ( _( b9 F+ e! V  ?+ @
{
: \- [; [2 L5 x! Jtry { # o0 ?1 t5 G3 a$ E3 g/ g
ThisClass obj = (ThisClass)super.clone(); 2 {( W1 y1 y# `& g- @- k
obj.field1 = (int[])field1.clone(); / d* b$ @+ |6 U
obj.field2 = field2;
" T  E* q/ v: Zreturn obj; 9 L& z$ _: F3 R" \" P3 c, D
} catch(CloneNotSupportedException e) { . e$ `$ v; e! O" M# i
throw new InternalError("Unexpected CloneNotSUpportedException: " + e.getMessage()); 1 v4 k- G) \) V
} 5 w# R- q* G: V! _& W) T
}
" J2 _, {: U9 P4 K1 t3 U
: e6 j" t  ^# ~* I% P/ I* w' X, O
8 F7 F+ q( R8 g. Y( P
7 L$ t- S7 o; \7 T$ Z6 U. Ufinal 类  $ N+ ]$ _& M& B$ @
绝对不要因为性能的原因将类定义为 final 的(除非程序的框架要求)  
% W9 S& h+ z; M) B如果一个类还没有准备好被继承,最好在类文档中注明,而不要将她定义为 final 的。这是因为没有人可以保证会不会由于什么原因需要继承她。  , t4 n& u4 D" W
访问类的成员变量  
6 J- P2 ?" G+ ]; E: n大部分的类成员变量应该定义为 protected 的来防止继承类使用他们。  ) p2 @, o0 c4 D4 `
注意,要用"int[] packets",而不是"int packets[]",后一种永远也不要用。  ; M: F; s; M  A9 \8 G
. @% [; ?4 m9 E. [
public void setPackets(int[] packets) { this.packets = packets; } * g( {2 D4 e: l! _" W7 C

  r( N# @  a( u- j! @CounterSet(int size) 0 G3 U2 |5 _( l! @7 X9 Q, r; D" \# f
{
8 R) @0 K. k. ]1 rthis.size = size;
# |3 ~* {1 l1 N}
zan
转播转播0 分享淘帖0 分享分享1 收藏收藏0 支持支持0 反对反对0 微信微信
如果我没给你翅膀,你要学会用理想去飞翔!!!
wangyu249        

1

主题

3

听众

54

积分

升级  51.58%

该用户从未签到

新人进步奖

回复

使用道具 举报

loooog12 实名认证       

1

主题

3

听众

412

积分

升级  37.33%

  • TA的每日心情

    2013-8-16 10:51
  • 签到天数: 1 天

    [LV.1]初来乍到

    回复

    使用道具 举报

    loooog12 实名认证       

    1

    主题

    3

    听众

    412

    积分

    升级  37.33%

  • TA的每日心情

    2013-8-16 10:51
  • 签到天数: 1 天

    [LV.1]初来乍到

    回复

    使用道具 举报

    andy long 实名认证    中国数模人才认证   

    11

    主题

    6

    听众

    533

    积分

  • TA的每日心情
    无聊
    2018-9-10 16:14
  • 签到天数: 59 天

    [LV.5]常住居民I

    2013挑战赛参赛者

    邮箱绑定达人

    群组B题讨论群

    群组物联网工程师培训

    回复

    使用道具 举报

    Paul_Sing 实名认证       

    0

    主题

    4

    听众

    43

    积分

    升级  40%

  • TA的每日心情
    开心
    2014-10-14 13:54
  • 签到天数: 3 天

    [LV.2]偶尔看看I

    自我介绍
    软件工程硕士
    回复

    使用道具 举报

    4

    主题

    3

    听众

    656

    积分

  • TA的每日心情
    开心
    2011-11-21 14:38
  • 签到天数: 41 天

    [LV.5]常住居民I

    群组数学建模培训课堂1

    群组数学建模培训课堂2

    群组2011年第一期数学建模

    群组科技写作基础培训

    回复

    使用道具 举报

    您需要登录后才可以回帖 登录 | 注册地址

    qq
    收缩
    • 电话咨询

    • 04714969085
    fastpost

    关于我们| 联系我们| 诚征英才| 对外合作| 产品服务| QQ

    手机版|Archiver| |繁體中文 手机客户端  

    蒙公网安备 15010502000194号

    Powered by Discuz! X2.5   © 2001-2013 数学建模网-数学中国 ( 蒙ICP备14002410号-3 蒙BBS备-0002号 )     论坛法律顾问:王兆丰

    GMT+8, 2026-4-21 16:41 , Processed in 0.463009 second(s), 85 queries .

    回顶部