1，單行(單行)-簡短說明: ///...

單行注釋: 代碼中的單行注釋. 最好在注釋前有一個空行，并在其后加上與代碼相同的縮進級別. 如果無法完成一行，則應使用塊注釋.

評論格式:

在行首注釋: 在代碼行首注釋. 主要是使代碼行毫無意義.

評論格式: //評論內容

在行尾注釋: 尾隨-在代碼行末尾非常簡短的注釋. 通常在代碼行后8個(至少4個)空格，所有注釋必須對齊.

評論格式: 代碼+ 8個(至少4個)空格+ //評論內容

2. 阻止-阻止評論:

注釋幾行，通常用于提供文件，方法，數據結構等的含義和目的的描述，或算法的描述. 通常位于文件或方法的前面，它起著指導作用，也可以根據需要放置在合適的位置. 此域注釋不會出現在HTML報告中. 注釋格式通常寫為:

3. 文件注釋:

注釋幾行并寫入javadoc文檔. 每個文檔注釋都將放置在注釋定界符中

其中，注釋文檔將用于生成HTML格式的代碼報告，因此注釋文本

The

文件必須在定義類，字段，構造函數，方法和字段之前編寫. 注釋文檔由兩部分組成: 描述和塊標記. 批注文檔的格式如下:

公共無效doGet(HttpServletRequest請求，HttpServletResponse響應)

引發ServletException，IOException {

doPost(請求，響應);

}

前兩行的說明. 描述完成后，塊符號以@符號開頭. 更多文檔說明

有關Shihe javadoc的詳細信息，請參閱javadoc主頁:

4. javadoc注釋標記語法

@author對類的描述表示開發該模塊的作者

有關該類的@version的說明表示該類的模塊的版本

通過@see參考轉向(即相關主題)來描述類，屬性和方法

@param對方法的描述方法中的參數說明

@return方法說明該方法返回值的說明

@exception對方法的說明解釋該方法可能引發的異常

六. JAVA注釋的實現

1，源文件注釋

注釋源文件，并且在每個源文件的開頭都需要必要的注釋信息，包括: 文件名；文件編號;版本號；作者;創建時間；文件描述，包括此文件的歷史記錄修改記錄. 中文注釋模板:

2. 類(模塊)注釋:

使用類(模塊)注釋. 在每個類(模塊)的開頭，必須包括必要的注釋信息，包括: 項目名稱；類(模塊)號；命名空間該類可以運行的JDK版本；版本號;作者;創建時間；類(模塊)的功能描述(例如功能，主要算法，內部部件之間的關系，此類與其類之間的關系等)，必要時必須有一些特殊的軟硬件要求等說明；此類(模塊)的主要功能或過程列表以及歷史修改記錄.

英語注釋模板:

如果模塊僅修改少量代碼，則每次修改都必須添加以釋:

//重寫器

//重寫日期: 開始1:

// End1:

注釋掉原始代碼的內容，然后使用以釋添加新代碼:

//添加人

//添加日期: jsp代碼注釋，格式: YYYY-MM-DD>開始2:

// End2:

如果模塊的輸入和輸出參數或功能結構有重大修改，則每次修改都必須添加以下內容

評論:

//日志ID:

//描述:

//作家: 修飾語的中文名稱

//重寫日期:

2. 界面說明:

使用接口注釋. 基于令人滿意的類批注，接口批注應包含有關接口用途，應如何使用以及不應如何使用的描述. 方框標記必須指明作者和版本. 在清除接口注釋的前提下，可以不注釋相應的實現類.

3. 構造說明:

構造函數注釋使用，描述部分指示構造函數的作用，并且不一定有塊標記.

注釋模板1:

評論模板二:

4. 功能說明:

使用功能注釋. 在每個功能或過程之前，必須有必要的注釋信息，包括: 功能或過程名稱；功能說明;輸入，輸出和返回值說明；調用關系和被調用關系描述等. 版本號(@version)可能不會出現在函數注釋中.

注釋模板1:

評論模板二:

5. 方法說明:

采用方法注釋. 對于設置(Set方法)和獲取(Get方法)成員的方法，在解釋了成員變量后，不能添加任何注釋；需要普通的成員方法來說明完成了什么功能，參數的含義是什么，返回值是什么；此外，必須清楚說明該方法的創建時間，以為將來的維護和閱讀提供有價值的線索.

6. 該方法的內部注釋:

控制結構，代碼的功能以及執行的原因，處理順序等. 尤其對于復雜的邏輯處理部分，應盡可能給出詳細的注釋.

7. 全局變量注釋:

更詳細的注釋，包括對其功能，值范圍，訪問的功能或過程的說明，以及訪問期間的注意事項等.

8. 局部(中間)變量注釋:

必須對主要變量進行注釋，如果沒有特殊含義jsp代碼注釋，可以不加注釋.

9. 實際參數/參數說明:

參數含義以及任何其他約束或前提條件.

10. 字段/屬性注釋: 字段描述，屬性描述.

11. 常量: 常量通常具有一定的實際意義，必須定義相應的描述.

本文來自電腦雜談，轉載請注明本文網址：

http://www.pc-fly.com/a/jisuanjixue/article-254359-1.html

總結

以上是生活随笔為你收集整理的java的注释规范_Java代码注释规范的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。