你可能知道java代碼編寫規範，但是你知道Javadoc文檔注釋規範嗎?

我們編寫一個完整的Java程序，這個程序內容非常簡單，就是列印一下當前日期，示例如下：

import java.util.*;

public class Hello {

public static void main(String[] args){

System.out.println(new Date());

}

}

以上示例中，import主要用來引入額外的類。通常我們需要引入jdk裡面的類，我們可以在sun官網，查找JDK文檔，來查看所有JDK內置的類。

上面我們用到的Date類是位於java.util這個路徑下面的。System.out.println()這個方法主要用來列印數據到控制臺，而且列印完了後換行。

Java類的名稱必須和文件的名稱保持一致，如果這個類要編譯和獨立運行的話，還必須包含main()方法，這裡用到的main方法是public static void main(String[] args){}。其中public的意思是，任意外部類都可以調用這個方法。而且示例中，main方法有一個String數組類型的參數args，這個參數主要用來存儲命令行參數，所以必須有。

System.out.println(new Date());

這句代碼中，當Date對象創建後，它就會被發送到println()，而且當Date對象被使用完後，將被垃圾回收期自動回收，無需我們去清理。

Java有很多標準的類庫集，比如;

public class Hello2 {

public static void main(String[] args){

System.getProperties().list(System.out);

System.out.println(System.getProperty(「java.library.path」));

System.out.println(System.getProperty(「user.name」));

}

}

System.getProperties().list(System.out);這句代碼可以給你提供環境信息，在控制臺輸出所有系統信息。

System.out.println(System.getProperty(「java.library.path」));這句代碼將大約系統屬性java.library.path（java類庫的位置）。

System.out.println(System.getProperty(「user.name」));這句代碼將大約用戶名信息。

我們編寫完Java程序後，我們如果要運行，就必須先大家Java開發環境，首先我們需要在java.sun.com這個網站下載JDK，然後進行安裝，並且配置環境變量信息（具體可以百度），最終我們要確保計算機知道java和javac這兩個文件的位置。然後我們在程序的當前目錄中打開命令行，輸入：

javac Hello.java

就可以執行Hello.java這個程序了。

在java語言中，一般有兩種注釋代碼的方式，一種是/*開頭，*/結尾，中間的地方會被注釋掉。示例如下：

/*

代碼

*/

另一種是//開頭，這個注釋符號會注釋掉當前一整句代碼。示例如下：

//代碼

還有一種特殊的方式，就是說明注釋，開始以 /** ，結束以 */。這種說明注釋允許嵌入程序信息，從而可以使用javadoc等工具生成文檔注釋，一般是HTML格式。

代碼文檔主要用來說明代碼，java中通過javadoc這個工具來提取代碼中的注釋，從而形成文檔。這個工具輸出一個HTML文件，然後我們就可以在瀏覽器中查看文檔內容了。

java文檔注釋會識別一些特殊的標籤，常用的有@author，@exception，@param，@return，@version，@see等等。示例如下:

/** 這個類繪製一個條形圖

* @author runoob

* @version 1.2

*/

上面示例中，第一行/**後面跟著通常是類、欄位和方法的描述信息，之後的@標籤後面跟內容，前面需要加上*號。

eclipse和idea都可以在工具內生成Javadoc注釋文檔。

使用JAVA語言編寫程序，需要注意一些規範，常用的有：

1、 類的名稱首字母需要大寫，如果類名稱由多個單詞組成，需要用駝峰命名法；

2、 欄位和方法的名稱首字母需要小寫，如果名稱由多個單詞組成，也需要使用駝峰命名法。