1.添加注釋的位置
(1)類,接口
這一部分注釋是必須的。在這里,我們需要使用javadoc注釋,需要標明,創(chuàng)建者,創(chuàng)建時間,版本,以及該類的作用。
(2)方法
在方法中,我們需要對入?yún)ⅲ鰠ⅲ约胺祷刂担獦嗣鳌?/p>
(3)常量
對常量,我們需要使用多行注釋,進行標明該常量的用途,如下所示:
(4)關鍵算法上
在關鍵算法上,添加注釋并且按照順序依次標明,寫明白該方法為什么這么做。
2.添加注釋的原則
(1)注釋形式統(tǒng)一
在整個應用程序中,使用具有一致的標點和結構的樣式來構造注釋。如果在其它項目中發(fā)現(xiàn)它們的注釋規(guī)范與這份文檔不同,按照這份規(guī)范寫代碼,不要試圖在既成的規(guī)范系統(tǒng)中引入新的規(guī)范。
(2)注釋內(nèi)容準確簡潔
內(nèi)容要簡單、明了、含義準確,防止注釋的多義性,錯誤的注釋不但無益反而有害。
在之前的文章中學習了不少關于java注釋的方式以及快捷操作,有些人還不清楚應該注釋的位置,以及注釋時需要注意的原則。注釋位置為類,接口、方法、常量、關鍵算法,原則有注釋形式統(tǒng)一和注釋內(nèi)容準確簡潔。以上就是我們在Java基礎中注釋添加位置以及原則的詳解,學會了的小伙伴在使用java注釋時一定要時時牢記,本篇內(nèi)容到這里就結束啦。
推薦操作環(huán)境:windows7系統(tǒng)、java10版,DELL G3電腦。
更多關于“Java培訓”的問題,歡迎咨詢千鋒教育在線名師。千鋒已有十余年的培訓經(jīng)驗,課程大綱更科學更專業(yè),有針對零基礎的就業(yè)班,有針對想提升技術的好程序員班,高品質(zhì)課程助力你實現(xiàn)java程序員夢想。