日韩性视频-久久久蜜桃-www中文字幕-在线中文字幕av-亚洲欧美一区二区三区四区-撸久久-香蕉视频一区-久久无码精品丰满人妻-国产高潮av-激情福利社-日韩av网址大全-国产精品久久999-日本五十路在线-性欧美在线-久久99精品波多结衣一区-男女午夜免费视频-黑人极品ⅴideos精品欧美棵-人人妻人人澡人人爽精品欧美一区-日韩一区在线看-欧美a级在线免费观看

歡迎訪問 生活随笔!

生活随笔

當前位置: 首頁 > 编程语言 > java >内容正文

java

Java代码注释规约

發布時間:2025/3/19 java 75 豆豆
生活随笔 收集整理的這篇文章主要介紹了 Java代码注释规约 小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

1、類、類屬性、類方法的注釋必須使用Javadoc規范,使用/**內容*/格式,不得使用 //內容 的方式。

說明:在IDE編輯窗口中,Javadoc方式會提示相關注釋,生成Javadoc可以正確輸出相應注釋;在IDE中,工程調用方法時,不進入方法即可懸浮提示方法,參數,返回值的意義,提高閱讀效率。

/** * 類名稱,作用,作者,時間 */ public class Test{/*** 這個字段是id*/private Long id;/*** 保存方法*/public void save(){}}

2、所有抽象方法(包括接口中的方法)必須使用Javadoc注釋,除了返回值、參數、異常說明外,還必須指出該方法做什么,實現什么。對子類的實現或調用注意事項也需要說明。

3、所有類都必須添加創建者信息。

4、方法內部單行注釋,在被注釋語句上方另起一行,使用//注釋。方法內部多行注釋使用/**內容*/,注意代碼對齊。

5、所有枚舉類型字段或是靜態屬性必須有注釋,說明每個數據項的用途。

6、代碼修改的同時,注釋也要修改,尤其是參數、返回值、異常核心邏輯等。

7、注釋掉的代碼盡量配合說明,而不是簡單的注釋掉。如果是以后不用的代碼建議直接刪除。

總結

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

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