更新時(shí)間:2018-01-30 來源:黑馬程序員 瀏覽量:
二、Java中的注釋
Java中的注釋分為三種:
l 單行注釋
l 多行注釋
l 文檔注釋
單行注釋:就是在一行或一行中的后半部分文本前增加雙斜線(//),被注釋的內(nèi)容會(huì)被Java編譯器忽略,例如:
int a = 1; // 定義一個(gè)整型變量
多行注釋:就是在注釋內(nèi)容前面以“/*”開頭,注釋內(nèi)容末尾以“*/”結(jié)束。多行注釋適合文本超過一行時(shí),
例如:
/* int a = 1; // 定義一個(gè)整型變量
int b = 5; */
文檔注釋:是以“/**”開頭,并在注釋內(nèi)容末尾以“*/”結(jié)束。這種方法注釋的內(nèi)容可以被javadoc等工
具用來生成程序的幫助文檔,用以說明該程序的層次結(jié)構(gòu)及其方法調(diào)用。
需要注意的是:
/*…*/”中可以嵌套“//”注釋,但不能嵌套“/*…*/”注釋,因?yàn)榈谝粋€(gè)“/*”會(huì)以它后面第一次出現(xiàn)的“*/”作為與它配對(duì)的結(jié)束注釋符,例如下面的代碼就是錯(cuò)誤的。
/*
/*int a = 1;*/
int b=5;
*/
三、Java中的標(biāo)識(shí)符
在編程過程中,經(jīng)常需要在程序中自定義一些符號(hào)來標(biāo)記一些名稱,如,包名、類名、方法名、參數(shù)名、變量名等,這些符號(hào)被稱為標(biāo)識(shí)符。標(biāo)識(shí)符可以由任意順序的大小寫字母、數(shù)字、下劃線(_)和美元符號(hào)($)組成,但標(biāo)識(shí)符不能以數(shù)字開頭,不能是Java中的保留關(guān)鍵字。
合法的標(biāo)識(shí)符定義:
username
username123
user_name
_userName
$username
非法的標(biāo)識(shí)符定義:
123username
class
100.23
Hello World
為了增強(qiáng)代碼的閱讀性,建議初學(xué)者在命名標(biāo)識(shí)符時(shí)遵循以下規(guī)則:
l 標(biāo)識(shí)符推薦使用全英文形式,為了提高閱讀性,要把標(biāo)識(shí)符定義的有意義。
l 包名所有字母一律小寫。例如:xxx.yyy.zzz。
l 類名、接口名的所有單詞首字母大寫。例如:XxxYyyZzz。
l 常量名所有字母都大寫,單詞之間用下劃線分割。例如:XXX_YYY_ZZZ。
l 變量名、方法名的第一個(gè)單詞首字母小寫,從第二個(gè)單詞開始每個(gè)單詞首字母大寫。例如:xxxYyyZzz。
本文版權(quán)歸黑馬程序員JavaEE學(xué)院所有,歡迎轉(zhuǎn)載,轉(zhuǎn)載請(qǐng)注明作者出處。謝謝!
作者:黑馬程序員JavaEE培訓(xùn)學(xué)院
首發(fā):http://java.itheima.com/