javacoding規(guī)范基準(zhǔn)集-資料下載頁
2025-08-12 14:00本頁面
【導(dǎo)讀】1. JAVAcoding規(guī)范
【正文】 ： } if (a amp。amp。 b){ ： } 系運算符前后加空格。 關(guān)系運算符（“ ”、“ ”、“ =”、“ =”、“ ==”、“ !=”）的前后須加空格。 例） if (a = b){ ： } if (a == b){ ： } if (a != b){ ： } 。 算術(shù)運算符（“ +”、“ ”、“ *”、“ /”、“ %”）的前后須加空格。 例） if (a + b){ ： } if (a % b){ ： } 10 if (a / b){ ： } 。 請不要在 return 語句中使用不必要的括號 。 例） return a + b。 return (int) a。 （“ ”、“ =”）。 不等號的方向請統(tǒng)一為左向。 例） if( a i ){ ： }else if( i a ){ ： }else{ ： } 11 JavaDoc ment。 在 class、 method 里如下所示請加注 JavaDoc ment。 特別是 public 以及 default 里的聲明是必須的 。 【 JavaDoc ment 樣式 】 ? 以 「 /**」 開始 。 ? 自第 2 行起以 「 *」 開始 、 在后記的 JavaDoc tag中記述本文 。 ? 在本文中出現(xiàn) “ 。 ” (句號 ) 還有 “ ． ” (句點 )之前請詳細(xì)記述概略。 ? 在本文中不可使用半角的 “ ” 及 ” ” 。 ? 在本文較長的情況下，可根據(jù)實際情況插入 “ br” 改行。 ? 以 「 */」 結(jié)束 。 【 class】 @author [作者 ] 記述 class 的作者及更新者。 在復(fù)數(shù)記述的情況下每人都要記述 tag。 @version [版本 ] 記述 class 的版本。 例） /** * 關(guān)于 Javadoc ment記述的說明 sample class。 * @version * @author Tsuyoshi Wakahara */ public class JavadocSample { 【 method】 @param [名稱 ] [說明 ] 參數(shù)的名稱和說明按照聲明的順序記述。 @return [說明 ] 如果有返回值、記述返回值的說 明。 @exception [名稱 ] [說明 ] 方法被調(diào)用時記述可能被拋出的異常名及其說明。 例） /** * sampleMethod 的說明 12 * @param value 參數(shù)的說明 * @return 返回值的說明 * @exception SampleException 異常的說明 */ public String samleMethod(String value) throws SampleException{ ment。 機能追加、 bug對應(yīng)中修改 code時，請按照 以下的規(guī)則記述 ment。 詳細(xì)內(nèi)容請參照 [修正歷史 ment交付規(guī)約 ]。 機能追加 /*. */ /*.e. 機能番號 */ ? bug對應(yīng) （ 變更 ） /*.s. 機能番號 [問處番號 ] */ ： 修正內(nèi)容 ： /*.e機能番號 [問處番號 ] */ ? bug對應(yīng) （ 刪除 ） /*.d. 機能番號 [問處番號 ] */ class final聲明 不想使之被繼承的類用 final 聲明，有以下的方法。 ? 因為通知編譯器不要繼承 class及覆蓋 method，所以更優(yōu)化 code。 ? 用 final聲明可表明該類不能被繼承，可讀性提高。 field的順序規(guī)則。 聲明 field 時，按照 public(+)、 protected()、 default(~)、 private()的順序聲明。 Constructor default constructor 要按照原則做成。 明示準(zhǔn)備 default constructor，有以下可能。 使用 ()動態(tài)生成實例。 決定 instance的 default 值 ， instance 生成時 用該值初始化。 例外）在用有引參的 constructor 生成 instance 作為前提的類中，不必生成 default 13 constructor。 method 不想使之被覆蓋的方法用 final聲明 。 不 能 使之被覆蓋的方法用 final聲明 有以下優(yōu)點 。 因為通知編譯器不要覆蓋 method，所以更優(yōu)化 code。 用 final聲明可表明該類不能被繼承，可讀性提高。 只有一個功能 如果在一個方法中執(zhí)行多個處理，會給可讀性、可維護(hù)性、擴(kuò)展性、可利用性帶來壞影響。method請按機能分割。 盡可能用局部變量 頻繁訪問變量時，對 class 變量、 instance 變量的訪問比對局部變量的訪問更耗時。 頻繁訪問變量時，請使用局部變量。 “｛｝”不可省略。 條件語句 （ if, else, while, for, do while ） 中請一定加上 “｛｝”。
環(huán)評公示相關(guān)推薦
鄂ICP備17016276號-1