注釋是對代碼的解釋和說明,其目的是讓程序員能夠更加快速的理解代碼。它是編寫程序時,寫程序的人給一個語句、程序段等的解釋或提示,能提高程序代碼的可讀性。注釋在編譯的時候不會生成到class字節碼文件當中,它只在java源文件中停留。
/**
* (javadoc注釋,寫在這里的注釋信息會被JDKbin
* 目錄下的javadoc.exe工具提取并生成幫助文檔)
* 以下程序實現打印九九乘法表功能
* @author bjpowernode-dujubin
* @version 1.0
* @since 1.0
*/
public class NineByNine {
/*
這是程序的入口,也稱為主方法(多行注釋)
類加載之后,程序從這里進來開始執行
*/
public static void main(String[] args) {
for( int i = 1 ; i <= 9 ; i ++ ){ //外層循環9次,九九乘法表共9行
for( int j = 1 ; j <= i ; j ++ ){
System.out.print( j + "*" + i + "=" + i * j + " ");
}
System.out.println(); //換行(單行注釋)
}
}
}
養成編寫注釋的好習慣,要有編寫注釋的意識(編寫注釋是程序員最基本的素質),當然,寫注釋也是有技巧的,不是所有位置都寫,不是把寫的代碼原版翻譯過來,高手往往在寫注釋的時候,不多不少,能夠做到恰到好處,幾句話就可以描述清楚程序的核心功能。記住:注釋的作用不在于表示代碼的含義,而在于表示代碼的功能。希望在以后的課程當中通過慢慢的培養,能夠寫一手漂亮的注釋,當然,目前大家只需要掌握注釋有哪幾種,分別寫到什么符號里就行了。
使用注釋對HelloWorld程序進行解釋說明,這里的描述大家先有個印象就行,后面的課程大家會理解的:
//public關鍵字表示公開的
//class關鍵字用來定義類
//HelloWorld是類名
public class HelloWorld {//定義一個公開類,起名HelloWorld
//大括號要成對兒寫
//這里的大括號括起來的是“類體”
//這是程序的入口,從這里進來執行
//static表示靜態的
//void表示main方法執行結束之后不返回任何數據
//以下行代碼除了args可以修改為其它名字之外,剩下的都是固定寫法
//編寫代碼從現在養成好習慣:合理縮進
//(你包含著我,或者說我比你低一級,就要縮進)
public static void main(String[] args) {
//這里的大括號括起來的是“方法體”
//向控制臺輸出一句話
//小括號里面的雙引號必須是半角的,不能采用中文
//這是一條java語句,java語句以“;”結尾,這里的“;”也是半角
System.out.println("動力節點-口口相傳的Java黃埔軍校");
}
//類體中不能直接編寫以下語句
//System.out.println("動力節點-口口相傳的Java黃埔軍校");
}