HelloWorld
|
1
2
3
4
5
6
7
|
public class HelloWorld{ public static void main(String args[]) { System.out.println("Hello World!"); //向控制臺輸出一條語句，同時必須以;結尾 } } |
運行上面程序如圖所示
我們通過上面的程序開始分析并學習Java語言的基礎知識；
1、注釋：
Java的注釋分為三種：單行注釋// 多行注釋/*…*/ 文檔注釋
像上面的HelloWorld程序分別用到了多行注釋和單行注釋。
Java還提供了另外一種注釋叫文檔注釋，如果編寫Java源代碼時添加了合適的文檔注釋，然后通過JDK提供的javadoc工具可以直接將源代碼里的文檔注釋提取成一份系統的API文檔。API文檔就是用以說明應用程序接口的文檔。對于Java而言，API文檔通常說細說明了每個類、每個方法的功能及用法。
Java語言的API文檔的下載地址：http://www.oracle.com/technetwork/java/javase/downloads/index.html
關于文檔注釋，我會在后面專門有一篇文章
2、Java的組織形式
|
1
2
3
4
5
6
7
8
9
10
|
//Java程序必須是以類class形式存豐，類class是Java程序的最小程序單位class 類名{ /*Java解釋器規定：如需某個類能被解釋器直接解釋執行，則這個類必須包含main方法，而且main方法必須使用pulbic static void來修飾，且main方法的形參必須是字符串數組類型(String args[]是字符串數組的形式) 也就是說main方法基本上固定不變的*/ public static void main(String args[]) { } } |
3、Java源文件的命名規則
1)Java程序源文件的后綴必須是.java，不能是其他文件后綴名
2）一個Java源文件可以包含多個類定義，但最多只能包含一個public類定義；如果Java源文件里包含public類定義，則該源文件的文件名必須與這個public類的類名相同
3）Java語言是嚴格區分大小寫的語言。因為源文件的文件名保存的時候也應注意大小寫
4）Java程序中的關鍵字全部是小寫的
總結：通過上面的程序簡單地說了一下Java程序的框架結構。
文檔注釋
Java語言提供了一種功能更強大的注釋形式：文檔注釋。如果編寫Java源代碼時添加了合適的文檔注釋，然后通過JDK提供的javadoc工具可以直接將源代碼里的文檔注釋提取成一份系統的API文檔。API是應用程序接口的意思，API是Java提供的基本編程接口，當使用Java語言進行編程時，不可能把所有的Java類、所有方法全部記下來，那么如果我們遇到一個不確定的地方時，必須通過API文檔來查看某個類、某個方法的功能和用法。
Java API文檔的下載地址：http://www.oracle.com/technetwork/java/javase/downloads/index.html
下載完成之后，打開DOCS/api文件夾里面的index.html文件，
1、API文檔首頁如圖
2、類說明區格局如下圖
由于只有以public或protected修飾的內容才是希望暴露給別人使用的內容，而API文檔主要是向使用者提供信息，因此javadoc工具默認只處理public或protected修飾的內容。如果開發者確實希望javadoc工具可以提取private修飾的內容，則可以在使用javadoc工具時增加-private選項來實現
下面我們通過一個演示程序來說明文檔注釋
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
package Gee;/** 網站:<a href="http://www.geeit.me/">作者博客站</a> <br/>這是一個javadoc工具演示的程序 <br/>程序名：javadoc演示程序 <br/>程序文件名:JavaDocDemo @author Gee @version 1.0 */ public class JavaDocDemo { /** 簡單的測試Field */ protected String name; /** 主方法，程序的入口 */ public static void main(String[] args) { System.out.println("Hello World!"); } } |
除此之外，如果我們希望 javadoc工具生成更詳細的文檔信息，例如為方法參數、方法返回值等生成詳細的說明信息，則可利用javadoc標記。常用的javadoc標記如下。
- @author:指定程序的作者
- @version:源文件的版本
- @deprecated:不推薦使用的方法
- @param:方法的參數說明信息
- @return:方法的返回值說明信息
- @see: “參見”用于指定交叉參考的內容
- @exception:拋出異常的類型
- @throws:拋出的異常,和exception同義。
javadoc工具默認不會提取@author和@version兩個標記信息，如果需要提取這兩個標記應該使用javadoc工具指定的-author和－version兩個版本
