(1)單行注釋:以“ // ”開頭后面接所要加的說明的內(nèi)容。如下面所示: //定義變量a int a = 10; //定義變量b int b = 20;上面的語句中,在編譯的過程就會(huì)直接略過注釋,只會(huì)編譯 int a = 10 和 int b = 20這兩句。由此可見注釋只是起著說明的作用。
為壽寧等地區(qū)用戶提供了全套網(wǎng)頁設(shè)計(jì)制作服務(wù),及壽寧網(wǎng)站建設(shè)行業(yè)解決方案。主營業(yè)務(wù)為成都網(wǎng)站制作、成都做網(wǎng)站、壽寧網(wǎng)站設(shè)計(jì),以傳統(tǒng)方式定制建設(shè)網(wǎng)站,并提供域名空間備案等一條龍服務(wù),秉承以專業(yè)、用心的態(tài)度為用戶提供真誠的服務(wù)。我們深信只要達(dá)到每一位用戶的要求,就會(huì)得到認(rèn)可,從而選擇與我們長期合作。這樣,我們也可以走得更遠(yuǎn)!
(2)多行注釋:以“/*”開頭,以“*/”結(jié)尾。 假設(shè)當(dāng)你要說明你所寫的代碼的功能時(shí)。要說明的內(nèi)容有很多。如果全部放在同一行會(huì)顯得很難看。所以一般會(huì)用多行來寫,如下所示// 說明//說明//說明//說明以上是用四個(gè)單行注釋來注釋四行說明。但如果有10行說明就要按十個(gè)“//”這顯示很麻煩,所以這時(shí)就可采用多行注釋。上面的可改成:/*說明說明說明說明*/也可以這樣/* 說明 說明 說明 說明 */
(3)文檔注釋:以“/**”開頭,以“*/”結(jié)尾。文檔注釋主要是生成文檔的。
試想一下,一個(gè)沒有一句注釋的程序源碼,怎么讀,一個(gè)程序要上萬條代碼不可能全部記得住哪一塊是什么用,而且一個(gè)項(xiàng)目也不會(huì)是一個(gè)人獨(dú)自完成,那樣效率太低,多人合作就要給別人說明,每一塊是什么用,方便他人使用,方便自己更正,而這些說明文字就是注釋,注釋不會(huì)被執(zhí)行,不影響運(yùn)行結(jié)果。
Java中代碼的注釋有三種:
// 注釋一行?
/* ...... */ 注釋若干行?
/** ...... */ 注釋若干行,并寫入 javadoc 文檔
前兩種比較容易理解,至于第三種,你學(xué)習(xí)Java看的api文檔就是javadoc程序根據(jù)第三種的注釋生成的。
擴(kuò)展資料
注釋就是對(duì)代碼的解釋和說明,其目的是讓人們能夠更加輕松地了解代碼。注釋是編寫程序時(shí),寫程序的人給一個(gè)語句、程序段、函數(shù)等的解釋或提示,能提高程序代碼的可讀性。
在Java里面主要有三種注釋:行注釋、段落注釋、文檔注釋
1)行注釋:行注釋也成為單行注釋,行注釋使用 “//注釋文字”的格式來對(duì)某一行的代碼進(jìn)行注釋或者加以說明
2)段注釋:段注釋也成為多行注釋,通常是當(dāng)說明文字比較長的時(shí)候的注釋方法
3)文檔注釋:文檔注釋是Java里面的一個(gè)比較厲害的功能,它可以用于注釋類、屬性、方法等說明,而且通過JDK工具javadoc直接生成相關(guān)文檔,文檔注釋的基本格式為“/**...*/”,不僅僅如此,文檔注釋本身還存在語法
Java中三種類型的注釋:
單行注釋:// 注釋內(nèi)容
多行注釋:/*... 注釋內(nèi)容....*/
文本注釋:/**.. 注釋內(nèi)容....*/
代碼注釋是架起程序設(shè)計(jì)者與程序閱讀者之間的通信橋梁,最大限度的提高團(tuán)隊(duì)開發(fā)合作效率。也是程序代碼可維護(hù)性的重要環(huán)節(jié)之一。所以不是為寫注釋而寫注釋。
備注:簡單的代碼做簡單注釋,注釋內(nèi)容不大于10個(gè)字即可,另外,持久化對(duì)象或VO對(duì)象的getter、setter方法不需加注釋。
擴(kuò)展資料:
類(模塊)注釋采用 /** …… */,在每個(gè)類(模塊)的頭部要有必要的注釋信息,包括:工程名;類(模塊)編號(hào);命名空間;類可以運(yùn)行的JDK版本;版本號(hào);作者;創(chuàng)建時(shí)間;類(模塊)功能描述(如功能、主要算法、內(nèi)部各部分之間的關(guān)系、該類與其類的關(guān)系等,必要時(shí)還要有一些如特別的軟硬件要求等說明);主要函數(shù)或過程清單及本類(模塊)歷史修改記錄等。
參考資料來源:百度百科-java注釋
1、單行(single-line)--短注釋://…… 單獨(dú)行注釋:在代碼中單起一行注釋, 注釋前最好有一行空行,并與其后的代碼具有一樣的縮進(jìn)層級(jí)。如果單行無法完成,則應(yīng)采用塊注釋。 注釋格式:/* 注釋內(nèi)容 */ 行頭注釋:在代碼行的開頭進(jìn)行注釋。主要為了使該行代碼失去意義。 注釋格式:// 注釋內(nèi)容 行尾注釋:尾端(trailing)--極短的注釋,在代碼行的行尾進(jìn)行注釋。一般與代碼行后空8(至少4)個(gè)格,所有注釋必須對(duì)齊。 注釋格式:代碼 + 8(至少4)個(gè)空格 + // 注釋內(nèi)容
2、塊(block)--塊注釋:/*……*/ 注釋若干行,通常用于提供文件、方法、數(shù)據(jù)結(jié)構(gòu)等的意義與用途的說明,或者算法的描述。一般位于一個(gè)文件或者一個(gè)方法的前面,起到引導(dǎo)的作用,也可以根據(jù)需要放在合適的位置。這種域注釋不會(huì)出現(xiàn)在HTML報(bào)告中。注釋格式通常寫成: /* * 注釋內(nèi)容 */
3、文檔注釋:/**……*/ 注釋若干行,并寫入javadoc文檔。每個(gè)文檔注釋都會(huì)被置于注釋定界符 /**......*/ ...
ListString list=new ArrayListString();
list.add("abc");
list.add("def");
for(String str:list)
{
System.out.println(str);
}