【正文】 on) {statements。break。}如使用無限循環(huán)，那么建議使用：while (true) {statements。}. for語句for (initialization。注：有些IDE工具的默認(rèn)設(shè)置“{”是在行尾，請修改IDE工具設(shè)置，使“{”換行顯示。所有的復(fù)合語句建議采用如下的花括號形式：{} 中的語句應(yīng)該單獨(dú)作為一行。例如：return(true)。在“[”之前不能有空格。例如：int j = 4。 // RIGHTcount++。. 接口體的組織接口體的聲明按照建議按如下順序：接口的字段聲明，接口方法聲明。}有必要時(shí)，須加上final修飾符，表示本方法不可被覆蓋。 (r2, 0, r4, 0, )。 }. 構(gòu)造函數(shù) 接下來是構(gòu)造函數(shù)，它應(yīng)該用遞增的方式寫（比如：參數(shù)多的寫在后面）。. 類成員變量(字段/屬性)的存取方法接下來是類變量的存取的方法。若在測試或者維護(hù)的過程中需要為類添加新的功能，往往需要引入新的類包。說明：這種注釋主要是針對以下幾種情況而言的：l 嚴(yán)重bug的修改l 版本相對穩(wěn)定后代碼的修改l 修改別人的代碼. 冗余代碼的注釋若在測試或者維護(hù)的過程中發(fā)現(xiàn)冗余的程序代碼，請注釋冗余的代碼行。在下一行添加更新的代碼。而“說明”（同樣可以延續(xù)到下面的行）告訴我們?yōu)槭裁催@種特殊類型的違例會(huì)在方法調(diào)用中出現(xiàn)。exception當(dāng)方法中發(fā)生異常時(shí)，“扔出”對象。一旦遇到一個(gè)新文檔標(biāo)記，就認(rèn)為前一個(gè)說明結(jié)束。 */ public static final double MAX_VALUE = +308。. 成員注釋只有 public 和 protected 類型的類成員的注釋可以被 javadoc 提取到文檔中，而 private 型和“友好”（沒有限定符）的類成員將被忽略。deprecated這是Java 。author格式如下：author 作者信息其中，“作者信息”包括作者的姓名、電子函件地址或者其他任何適宜的資料。格式如下：see 類名 see 完整類名see 完整類名方法名每一格式都會(huì)在生成的文檔里自動(dòng)加入一個(gè)超鏈接的“See Also”（參見）條目。如下：/** * 類功能介紹。以下將詳細(xì)介紹注釋的編寫規(guī)范：. 版權(quán)信息注釋版權(quán)信息必須在 java 文件的開頭，比如：/** * pCopyright 174。l 錯(cuò)誤的注釋還不如不做注釋。//縮進(jìn)后與上一行l(wèi)ong_expression1對齊// 好的折行方式foo(long_expression1, long_expression2,// 縮進(jìn)后與上一行l(wèi)ong_expression1對齊 long_expression3)。建議修改各管理工具的設(shè)置將Tab字符擴(kuò)展成4個(gè)空格。//NOT GOOD下列情況不建議使用空格左括號和后一個(gè)字符之間不應(yīng)該出現(xiàn)空格，例如：if (i== 42)；//RIGHTif( i==42)。在任何關(guān)鍵字和它所用的參數(shù)之間。 bookAuthor = null。 private String bookName。l 在類中聲明最后一個(gè)屬性之后，聲明第一個(gè)方法之前。}} //label_two}. 空白的使用. 空行空行的使用有益于將代碼按照邏輯分段，以提高代碼的可讀性。例如：for (int i = 0。例如：getHeight（），setHeight（）用于判斷類的布爾屬性的方法建議顯式的命名為 isProperty（），property是指類的屬性的名字。例如：MIN_VALUE，MAX_BUFFER_SIZE，OPTION_FIEL_NAME. 方法命名方法命名采用大小寫混合的形式。名字應(yīng)為名詞或者名詞短語。例如：//好的類命名： LayoutManager，ArrayIndexOutOfBoundsException //不好的類命名： ManageLayout //動(dòng)詞短語，建議用名詞短語awtException //awt是專有名詞，都應(yīng)該大寫array_index_out_of_bounds_exception //不能有下劃線接口的命名Interface的名字取決于Interface的主要功能和用途。package 。例如：import import .*//NOT GOOD. 類或者接口的聲明每個(gè)源程序至少會(huì)有一個(gè)class或者interface的聲明。 2002 金質(zhì)工程版權(quán)所有/p* ppany： neusoft/p* ptime： /p* * author Brunce* version ver */. 包的聲明每一個(gè)源程序若包含一個(gè)包的聲明，則必須是非注釋的第一行，并用一個(gè)空格分隔package關(guān)鍵字和package的名字。通常包的擴(kuò)展名有 *.jar(推薦使用)或者 *.zip、*.ear、*.war等。按照此規(guī)范來開發(fā)Java程序可帶來以下益處：l 代碼的編寫保持一致性，l 提高代碼的可讀性和可維護(hù)性，l 在團(tuán)隊(duì)開發(fā)一個(gè)項(xiàng)目的情況下，程序員之間可代碼共享，l 易于代碼的回顧。在開發(fā)周期中越早使用恰當(dāng)?shù)木幋a規(guī)定，將會(huì)最大程度的提高項(xiàng)目的生產(chǎn)率。. 引言. 簡介 所有的程序開發(fā)手冊都包含了各種規(guī)則。統(tǒng)一規(guī)范的格式有利于項(xiàng)目的交付和后續(xù)維護(hù)。良好的編碼習(xí)慣有助于標(biāo)準(zhǔn)化程序的結(jié)構(gòu)和編碼風(fēng)格，使源代碼對于自己和別人都易讀和易懂。. 目的本文是一套面向Java programmer 和Java developer進(jìn)行開發(fā)所應(yīng)遵循的開發(fā)規(guī)范。. 供發(fā)布的文件如果文件編譯后，需要用打包的形式發(fā)布，那么這個(gè)包的名字應(yīng)該是有代表性的（例如應(yīng)該是這個(gè)模塊或者這個(gè)文件所在單元的名字）。例如：/*** papplication name： sample1/p* papplication describing： this class handels the request of the client/p* pcopyright： Copyright 174。引用時(shí)應(yīng)保證所有引入類都被使用，即減少引入*的使用，因?yàn)槿绻氩淮_切的類將很難理解當(dāng)前類的上下文關(guān)系及相關(guān)性。例如：package 。類的命名Class的名字建議使用名詞或者名詞短語。以小寫字母開頭，名字中其他單詞或者只取首字母的縮寫單詞以大寫字母開頭，所有其它的單詞都為小寫字母，不要使用下劃線分隔單詞。. 常量命名 常量的命名建議都為大寫字母，并用下劃線分隔單詞。例如：//好的方法命名：showStatus（），drawCircle（），addLayoutComponent（）//不好的方法命名：mouseButton（） //名詞短語，不能描繪出方法的功能DrawCircle（） //首字母不應(yīng)該大寫add_layout_ponent（） //不應(yīng)該使用下劃線serverRunning（）//動(dòng)詞短語，但不是祈使動(dòng)詞 獲取或者設(shè)置類的某種屬性的方法建議顯式的命名為 getProperty（）或者 setProperty（），其中property是指類的屬性的名字。雖然語言允許，但也不要在同一個(gè)方法中多次使用同一個(gè)標(biāo)簽名。}}//label_onelable_two:{ if (node[i].name == name){break label_two。l 在方法的聲明之間。public class BookView{ private String bookID。 bookName = null。下列關(guān)鍵字的后面請不要跟隨空格：super ，this 。//RIGHT foo(long_expression1,long_expression2,lon