寫代碼的時(shí)候,有時(shí)候,你需要寫一些注釋,把內(nèi)容相互關(guān)聯(lián)起來,方便自己或別人看的時(shí)候,可以直接找到你關(guān)聯(lián)的代碼類或者啥的。
十余年的淮上網(wǎng)站建設(shè)經(jīng)驗(yàn),針對設(shè)計(jì)、前端、開發(fā)、售后、文案、推廣等六對一服務(wù),響應(yīng)快,48小時(shí)及時(shí)工作處理。全網(wǎng)營銷推廣的優(yōu)勢是能夠根據(jù)用戶設(shè)備顯示端的尺寸不同,自動(dòng)調(diào)整淮上建站的顯示方式,使網(wǎng)站能夠適用不同顯示終端,在瀏覽器中調(diào)整網(wǎng)站的寬度,無論在任何一種瀏覽器上瀏覽網(wǎng)站,都能展現(xiàn)優(yōu)雅布局與設(shè)計(jì),從而大程度地提升瀏覽體驗(yàn)。成都創(chuàng)新互聯(lián)公司從事“淮上網(wǎng)站設(shè)計(jì)”,“淮上網(wǎng)站推廣”以來,每個(gè)客戶項(xiàng)目都認(rèn)真落實(shí)執(zhí)行。
這個(gè)時(shí)候,{@link}與@see,這2個(gè)javadoc注解就派上用場了,
不管他具體有什么功能,咱就只管一個(gè),他可以鏈接代碼,讓注釋看的更清楚易懂。方便你我他。
@see 標(biāo)簽允許用戶引用其他類的文檔。具體使用方式如下:
@see classname
@see fully-qualified-classname
@see fully-qualified-classname#方法名稱
@see fully-qualified-classname#屬性名稱
我在使用的時(shí)候,發(fā)現(xiàn)這個(gè)只能單獨(dú)一行頂頭寫,如果不頂頭寫就不管用了,沒了鏈接的效果。
但是,{@link}這個(gè)卻可以隨便放。
具體使用方法和上面那個(gè)@see是一樣的。
實(shí)際效果,看下面的圖
試想一下,一個(gè)沒有一句注釋的程序源碼,怎么讀,一個(gè)程序要上萬條代碼不可能全部記得住哪一塊是什么用,而且一個(gè)項(xiàng)目也不會(huì)是一個(gè)人獨(dú)自完成,那樣效率太低,多人合作就要給別人說明,每一塊是什么用,方便他人使用,方便自己更正,而這些說明文字就是注釋,注釋不會(huì)被執(zhí)行,不影響運(yùn)行結(jié)果。
Java中代碼的注釋有三種:
// 注釋一行?
/* ...... */ 注釋若干行?
/** ...... */ 注釋若干行,并寫入 javadoc 文檔
前兩種比較容易理解,至于第三種,你學(xué)習(xí)Java看的api文檔就是javadoc程序根據(jù)第三種的注釋生成的。
擴(kuò)展資料
注釋就是對代碼的解釋和說明,其目的是讓人們能夠更加輕松地了解代碼。注釋是編寫程序時(shí),寫程序的人給一個(gè)語句、程序段、函數(shù)等的解釋或提示,能提高程序代碼的可讀性。
注釋是用來給開發(fā)者或者是軟件后續(xù)的維護(hù)者來看的。一般是用來描述這一段代碼或者是程序做了些什么樣的事情。實(shí)現(xiàn)了哪些功能,java里面注釋代碼,可以分為行注釋和塊注釋,方法注釋等。
行注釋就是在需要注釋的代碼前加 //
塊注釋則是用 /* 和 */ 把文本段落框起來即可