【正文】 tlabel: {}// statementlabelBody of the document. 性能優(yōu)化常識. 前提首先讓程序運行起來，再考慮變得更快——但只有在自己必須這樣做、而且經(jīng)證實在某部分代碼中的確存在一個性能瓶頸的時候，才應(yīng)進(jìn)行優(yōu)化。}. synchronized語句synchronized (expression) {statements。} catch ( exceptiondeclaration) {statements。} finally {statements。} catch (exceptiondeclaration) {statements。break。break。}while (condition)。}如使用無限循環(huán)，那么建議使用：while (true) {statements。 update) {statements。}. for語句for (initialization。}if (condition) {statements。注：有些IDE工具的默認(rèn)設(shè)置“{”是在行尾，請修改IDE工具設(shè)置，使“{”換行顯示。 //NOT GOOD, “{” 和 “}” 在同一行 l 在 {} 中的復(fù)合語句應(yīng)該有層次。所有的復(fù)合語句建議采用如下的花括號形式：{} 中的語句應(yīng)該單獨作為一行。 // RIGHTreturn (() + )。例如：return(true)。 // NOT GOODchar[] buf。在“[”之前不能有空格。 // ACCEPTABLEint i, j = 4, k。例如：int j = 4。 count++。 // RIGHTcount++。. 語句. 簡單語句. 賦值和表達(dá)式每行只包含一條語句。. 接口體的組織接口體的聲明按照建議按如下順序：接口的字段聲明，接口方法聲明。接口的聲明采用如下的格式：[public] interface InterfaceName [extends SuperInterfaces] {InterfaceBody}SuperInterfaces是可用逗號分隔的接口列表（如果超過一個接口），按照字母的順序排列。}有必要時，須加上final修飾符，表示本方法不可被覆蓋。 (r1, 0, r3, 0, )。 (r2, 0, r4, 0, )。}. 類方法(靜態(tài)方法)下面開始寫類方法：/** * Set the packet counters * (such as when restoring from a database) */protected static void setArray(int[] r1, int[] r2, int[] r3, int[] r4) throws IllegalArgumentException{ // Ensure the arrays are of equal size if ( != || != || != ) throw new IllegalArgumentException(Arrays must be of the same size)。 }. 構(gòu)造函數(shù) 接下來是構(gòu)造函數(shù)，它應(yīng)該用遞增的方式寫（比如：參數(shù)多的寫在后面）。}public int[] getPackets() { return packets。. 類成員變量(字段/屬性)的存取方法接下來是類變量的存取的方法。多余的類包可以直接刪除。若在測試或者維護(hù)的過程中需要為類添加新的功能，往往需要引入新的類包。注釋符號的選擇參照 代碼修改的注釋。說明：這種注釋主要是針對以下幾種情況而言的：l 嚴(yán)重bug的修改l 版本相對穩(wěn)定后代碼的修改l 修改別人的代碼. 冗余代碼的注釋若在測試或者維護(hù)的過程中發(fā)現(xiàn)冗余的程序代碼，請注釋冗余的代碼行。WangGang 20011218//String showMessage = null。在下一行添加更新的代碼。. 其它的注釋. 代碼修改的注釋若要修改單行代碼，請在上一行使用單行注釋，寫明修改原因，人員姓名和日期。而“說明”（同樣可以延續(xù)到下面的行）告訴我們?yōu)槭裁催@種特殊類型的違例會在方法調(diào)用中出現(xiàn)。所有這些違例都需要說明。exception當(dāng)方法中發(fā)生異常時，“扔出”對象。return格式如下：return 說明其中，“說明”是指返回值的含義。一旦遇到一個新文檔標(biāo)記，就認(rèn)為前一個說明結(jié)束。如下：/** * 方法的功能描述。 */ public static final double MAX_VALUE = +308。如下：/** * codedouble/code 型數(shù)值的最大值。. 成員注釋只有 public 和 protected 類型的類成員的注釋可以被 javadoc 提取到文檔中，而 private 型和“友好”（沒有限定符）的類成員將被忽略。該標(biāo)記的作用是建議用戶不必再使用一種特定的功能，因為未來改版時可能摒棄這一功能。deprecated這是Java 。可為一系列作者使用多個這樣的標(biāo)記，但它們必須連續(xù)放置。author格式如下：author 作者信息其中，“作者信息”包括作者的姓名、電子函件地址或者其他任何適宜的資料。version格式如下：version 版本信息其中，“版本信息”代表任何適合作為版本說明的資料。格式如下：see 類名 see 完整類名see 完整類名方法名每一格式都會在生成的文檔里自動加入一個超鏈接的“See Also”（參見）條目。 * * see * see getDeclaredMethod(String, Class[]) * author Frank * version , 20011218 * author Mary * deprecated */解釋：see：引用其他類所有三種類型的注釋文檔都可包含see標(biāo)記，它允許我們引用其他類里的文檔。如下：/** * 類功能介紹。/p */ . 類注釋類注釋通常放在類定義的前面（類實體以外）。以下將詳細(xì)介紹注釋的編寫規(guī)范：. 版權(quán)信息注釋版權(quán)信息必須在 java 文件的開頭，比如：/** * pCopyright 174。例如：// temporary note: Change this to call sort() when the bugs in it are fixed listmySort()。l 錯誤的注釋還不如不做注釋。}while (long_logical_test_1 || long_logical_test2 || long_expression3){}. 注釋l 一般來說，注釋的使用應(yīng)按照以下原則：l 注釋應(yīng)該能夠幫助讀者理解代碼的功能和作用，應(yīng)該有助于讀者理解程序的流程。//縮進(jìn)后與上一行l(wèi)ong_expression1對齊// 好的折行方式foo(long_expression1, long_expression2,// 縮進(jìn)后與上一行l(wèi)ong_expression1對齊 long_expression3)。一條語句換行后, 應(yīng)該比原來的語句有所縮進(jìn)，縮進(jìn)的具體格數(shù)要依據(jù)該語句的類型。建議修改各管理工具的設(shè)置將Tab字符擴(kuò)展成4個空格。 //NOT GOOD. 縮進(jìn)行的縮進(jìn)要求是四個空格。//NOT GOOD下列情況不建議使用空格左括號和后一個字符之間不應(yīng)該出現(xiàn)空格，例如：if (i== 42)；//RIGHTif( i==42)。例如 foo(long_expression1, long_expression2, long_expression3)。在任何關(guān)鍵字和它所用的參數(shù)之間?？捎糜谌缦碌年P(guān)鍵字：cat