Window --Preferences-Java-Editor-Templates ,
在札達等地區(qū),都構(gòu)建了全面的區(qū)域性戰(zhàn)略布局,加強發(fā)展的系統(tǒng)性、市場前瞻性、產(chǎn)品創(chuàng)新能力,以專注、極致的服務(wù)理念,為客戶提供成都網(wǎng)站建設(shè)、成都網(wǎng)站設(shè)計 網(wǎng)站設(shè)計制作按需制作,公司網(wǎng)站建設(shè),企業(yè)網(wǎng)站建設(shè),品牌網(wǎng)站建設(shè),全網(wǎng)營銷推廣,外貿(mào)網(wǎng)站制作,札達網(wǎng)站建設(shè)費用合理。
在這里new一個自己的插入注釋的快捷方式名稱,具體設(shè)置如下:
Name處輸入 remark (任意你喜歡的名稱)
context處選 java 后邊勾選Automatically insert復(fù)選框
Description 這里可以任意輸入描述
Pattern :(自定義格式)
/**
* @author ${user}
* @date : ${date} ${time}
*/
到這里全部設(shè)置完畢,下面 OK,找個java類,找個空白處測試一下, 輸入remark(前面寫的那個Name名稱),
再alt+/ 應(yīng)該按一下就能看到剛才的Description的內(nèi)容。
寫代碼的時候,有時候,你需要寫一些注釋,把內(nèi)容相互關(guān)聯(lián)起來,方便自己或別人看的時候,可以直接找到你關(guān)聯(lián)的代碼類或者啥的。
這個時候,{@link}與@see,這2個javadoc注解就派上用場了,
不管他具體有什么功能,咱就只管一個,他可以鏈接代碼,讓注釋看的更清楚易懂。方便你我他。
@see 標(biāo)簽允許用戶引用其他類的文檔。具體使用方式如下:
@see classname
@see fully-qualified-classname
@see fully-qualified-classname#方法名稱
@see fully-qualified-classname#屬性名稱
我在使用的時候,發(fā)現(xiàn)這個只能單獨一行頂頭寫,如果不頂頭寫就不管用了,沒了鏈接的效果。
但是,{@link}這個卻可以隨便放。
具體使用方法和上面那個@see是一樣的。
實際效果,看下面的圖
eclipse設(shè)置創(chuàng)建一個java文件后自動加入注釋的方法:
1、通過菜單 Window-Preference 打開參數(shù)設(shè)置面板,然后選擇:
Java - Code Style - Code ?Templates
2、在右側(cè)選擇Comments,將其中的Files項,然后選右邊的"Edit",進入編輯模式: ??
3、進入編輯模式后就可以自定義注釋了。另外可以插入一些變量,如年、日期等等。
4、最后,確保 Code - New Java files 中有:"${filecomment}"
1、單行(single-line)--短注釋://…… 單獨行注釋:在代碼中單起一行注釋, 注釋前最好有一行空行,并與其后的代碼具有一樣的縮進層級。如果單行無法完成,則應(yīng)采用塊注釋。 注釋格式:/* 注釋內(nèi)容 */ 行頭注釋:在代碼行的開頭進行注釋。主要為了使該行代碼失去意義。 注釋格式:// 注釋內(nèi)容 行尾注釋:尾端(trailing)--極短的注釋,在代碼行的行尾進行注釋。一般與代碼行后空8(至少4)個格,所有注釋必須對齊。 注釋格式:代碼 + 8(至少4)個空格 + // 注釋內(nèi)容
2、塊(block)--塊注釋:/*……*/ 注釋若干行,通常用于提供文件、方法、數(shù)據(jù)結(jié)構(gòu)等的意義與用途的說明,或者算法的描述。一般位于一個文件或者一個方法的前面,起到引導(dǎo)的作用,也可以根據(jù)需要放在合適的位置。這種域注釋不會出現(xiàn)在HTML報告中。注釋格式通常寫成: /* * 注釋內(nèi)容 */
3、文檔注釋:/**……*/ 注釋若干行,并寫入javadoc文檔。每個文檔注釋都會被置于注釋定界符 /**......*/ ...
ctrl + / 是注釋當(dāng)前行的,不是多行的
單行注釋:[ // ] ctrl + / 再次使用取消注釋
多行注釋:[ /* */ ] ctrl + shift + / ,ctrl + shift + \ 取消注釋
doc注釋: [ /** */ ] 輸入/** 回車以后即可,適用于方法或者類的注釋,這個注釋非常好用
如果快捷鍵不能使用的話,請找目錄“window”→“Preferences”→General→Keys
注釋是用來給開發(fā)者或者是軟件后續(xù)的維護者來看的。一般是用來描述這一段代碼或者是程序做了些什么樣的事情。實現(xiàn)了哪些功能,java里面注釋代碼,可以分為行注釋和塊注釋,方法注釋等。
行注釋就是在需要注釋的代碼前加 //
塊注釋則是用 /* 和 */ 把文本段落框起來即可