一 前言

java編程規約是指在java代碼編寫過程中通俗的約定；通常我們是要遵守這些規范；這好比我們在生活中要遵守的道德準則，如果你做的事情超出了道德的底線，那就有可能會受到社會抨擊；在java編程中也是類似的道理，如果你編寫的代碼不是很規范，盡管功能實現的功能強大，但其他java編程人員都看不懂你的代碼，別人就認為你這是垃圾代碼，后期的維護工作就會很艱難，而且心里肯定對你很不爽；如果在工作中遇見這種情況，你l的eader就有可能讓你重寫編寫代碼；

二 命名規范

良好的代碼命名規則習慣有助于我們快速瀏覽代碼，讓代碼的可讀性強，易于他人閱讀，后期維護工作簡單；

2.1 駝峰命名法

駝峰命名法（Camel-Case）是程序編程的通俗約定，其分為大駝峰寫法和小駝峰寫法；

大駝峰：每一個單詞首字母大寫，隨后的字母小寫；示例：ILoveJavaProgramer

小駝峰： 第一個單詞全小寫，之后的單詞首字母大寫，其余字母小寫；示例：iLoveJavaProgramer

2.2 包名寫法

比如我有個域名是： java.com; 我現在要創建工程的包結構，那么通常包的命名規則是將域名反寫，之后跟具體的包名；所有的包名都統一使用小寫；

示例：com.java.zszxz.service

2.3 類名，接口名，文件名寫法

類名，接口名，文件名寫法統一采用大駝峰寫法；

示例：

類名：FileInputStream

接口名：InputStream

文件名：UserMapper.xml

2.4 方法名,字段名寫法

方法名 和 字段名稱 統一采用小駝峰命名寫法；

示例：

方法名：getUser()

字段名： fieldInfomation

2.4 常量名寫法

常量是特殊的字段，也就是特殊的變量，其約定的寫法跟之前稍有不同，其采用的寫法是所有單詞的字母都大寫，單詞之間使用下劃線隔開；

示例： I_LOVE_JAVA_PROGRAMER

三 代碼注釋

代碼的注釋的作用主要是進行代碼解釋，類似你買了一個硬件設備，你要看說明書才知道怎么用這個設備，注釋就起到了說明書的功能；代碼注釋的第二個功能是能注釋到你當前寫的代碼，但后面又可能用到該代碼，舍不得刪除的情況；

3.1 單行注釋

單行注釋源于c++,其意指能注釋掉一行代碼，使用兩個斜桿（//);

示例： // 我是知識追尋者，你是誰？覺得文章不錯能幫助到你，那還不關注下？

3.2 多行注釋

多行注釋的風格源于c；其是斜桿和星號開頭，中間部分是內容，以星號和斜桿結束（/ ............... /）；

示例： / 今天你的小伙伴來找你了嗎? /

3.3 文檔注釋

文檔注釋是指能夠通過jdk的javadoc命令使注釋生成html幫助文檔，比如開發人員常看的jdk 的 API幫助文檔；使用格式是以斜桿和2個星號開頭，中間是內容，以星號和斜桿結束（/* .................... /）；

通常文檔注釋只對 public 和 protect 級別的的成員進行注釋，內部私有的成員是不提供給外部；

常用標簽介紹：

了解更多標簽示例請看：java文檔注釋

使用示例：

public class Doc {@Deprecatedprivate String buguaiguai;private String love;/*** @see java.lang.Object#toString()* @see java.lang.String* @see String* {@link System}* {@link System#getProperties()}* <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a>* @param love is favorite* @return the love* @deprecated <p>buguaiguai</p>* @throws RuntimeException contribution the java world* @since zszxz* @version 1.0.0* @author lsc/zszxz/youku1327*/public String getLove(String love){return "love";} }

生成doc命令

javadoc -d tagerPath sourcePath/className.java

命令過程：

C:Users林>javadoc -d C:mydatageneratordoc C:javaworkspaceforresourcestudy-01basesrcmainjavacomyouku1327basedocDoc.java 正在加載源文件C:javaworkspaceforresourcestudy-01basesrcmainjavacomyouku1327basedocDoc.java... 正在構造 Javadoc 信息... 正在創建目標目錄: "C:mydatageneratordoc" 標準 Doclet 版本 1.8.0_131 正在構建所有程序包和類的樹... 正在生成C:mydatageneratordoccomyouku1327basedocDoc.html... 正在生成C:mydatageneratordoccomyouku1327basedocpackage-frame.html... 正在生成C:mydatageneratordoccomyouku1327basedocpackage-summary.html... 正在生成C:mydatageneratordoccomyouku1327basedocpackage-tree.html... 正在生成C:mydatageneratordocconstant-values.html... 正在構建所有程序包和類的索引... 正在生成C:mydatageneratordocoverview-tree.html... 正在生成C:mydatageneratordocindex-all.html... 正在生成C:mydatageneratordocdeprecated-list.html... 正在構建所有類的索引... 正在生成C:mydatageneratordocallclasses-frame.html... 正在生成C:mydatageneratordocallclasses-noframe.html... 正在生成C:mydatageneratordocindex.html... 正在生成C:mydatageneratordochelp-doc.html...C:Users林>

生成結果：

四 空行與縮進

4.1 空行

空行是指不同功能的代碼之間要做到空行，以便于區分；

通常類名接口名，與其成員保持2個空行，如果有注釋其也算一個空行；

不同類別的成員之間保持一個空行；

方法邏輯與方法名空一行；

示例：

/* * 類的注釋不需要空行 * / public class zszxz {// 成員與類或者接口包池2個空行，包括注釋；private String love;private Integer age; // 不同類別的成員保持一行private String gender;// 相同類名的成員不用空行public String getLove(){return "love"; // 方法邏輯與方法名空一行}}

4.2 縮進

類和屬性；方法和邏輯；它們之間的縮進都是以4個空格為單位，可以使用制表符來代替多個空格，作者的一個制表符設置的是2個空格；

示例：

/* * 類的開頭不需要空格 * / public class zszxz {// 成員與類或者接口保持4個空格private String love;private Integer age; // 成員與類或者接口保持4個空格private String gender;// 成員與類或者接口保持4個空格public String getLove(){ //成員與類或者接口保持4個空格return "love"; // 方法邏輯與方法名保持4個空格}}

總結

以上是生活随笔為你收集整理的html 注释_java基础- Java编程规范与注释的全部內容，希望文章能夠幫你解決所遇到的問題。

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