一般原則
東安網站制作公司哪家好,找創(chuàng)新互聯(lián)公司!從網頁設計、網站建設、微信開發(fā)、APP開發(fā)、成都響應式網站建設公司等網站項目制作,到程序開發(fā),運營維護。創(chuàng)新互聯(lián)公司從2013年成立到現在10年的時間,我們擁有了豐富的建站經驗和運維經驗,來保證我們的工作的順利進行。專注于網站建設就選創(chuàng)新互聯(lián)公司。
- 盡量使用完整的英文描述符
- 采用適用于相關領域的術語
- 采用大小寫混合增強可讀性
- 盡量少用縮寫,但如果用了,要明智地使用,且在整個工程中統(tǒng)一
- 避免使用長的名字
- 避免使用類似的名字,或者僅僅是大小寫不同的名字
- 避免使用下劃線(除靜態(tài)常量等)
命名的字母大小寫問題
- 包名: 字母全小寫 例如: cn.coderstory.Activity.Main
- 類,接口 :首字母大寫,其他全小寫 例如: class Container
- 方法,變量 :第二個單詞開始首字母大寫 例如: seedMessage
- 常量: 大寫,單詞用“_”分割 例如: final static MIN_WIDTH = 4
- 接口 :首字母大寫 ,后綴Impl 例如: class ContainerImpl
- 異常類: 首字母大寫, 后綴Exception 例如: DataNotFoundException
- 抽象類 :首字母大寫, 前綴Abstract 例如: AbstractBeanDefinition
- Test類: 首字母大寫, 后綴Test 例如: public Location newLocation()
方法的命名
- 類中獲取值方法,一般要求被方法名使用被訪問字段名,前面加上前綴get,如getLastUser(), getUserCount()
- 返回布爾型的判斷方法一般要求方法名使用單詞 is 做前綴,如isPersistent(),isString()?;蛘呤褂镁哂羞壿嬕饬x的單詞,例如equal 或equals
- 用于修改某些設置的方法(一般返回類型為void):被訪問字段名的前面加上前綴 set,如setFirstName(),setLastName(),setWarpSpeed()。
- 已辦的方法一般采用完整的英文描述說明成員方法功能,第一個單詞盡可能采用一個生動的動詞,第一個字母小寫,如 openFile(), addAccount()。
- 接口 :首字母大寫 ,后綴Impl 例如: class ContainerImpl
- 異常類: 首字母大寫, 后綴Exception 例如: DataNotFoundException
- 抽象類 :首字母大寫, 前綴Abstract 例如: AbstractBeanDefinition
- Test類: 首字母大寫, 后綴Test 例如: public Location newLocation()
Java注釋約定
- 類的整體注釋:遵循JavaDoc的規(guī)范,在每一個源文件的開頭注明該CLASS的作用, 作簡要說明, 并寫上源文件的作者, 編寫日期。如果是修改別人編寫的源文件,要在修改信息上注明修改者和修改日期。
例如:
/**
* @(#):CLASSNAME.java
* @description: Description of this java
* @author: PROGRAMMER'S NAME YYYY/MM/DD
* @version: Version No.
* @modify:
* @Copyright: 版權由擁有
*/
- 類中方法的注釋:遵循JavaDoc的規(guī)范,在每個方法的前部用塊注釋的方法描述此方法的作用,以及傳入,傳出參數的類型和作用,以及需要捕獲的錯誤。
例如:
/**
* 方法的描述
*
*
*@param 參數的描述
*@return 返回類型的描述
*@exception 出錯信息的描述
*/
- 行注釋:使用//…的注釋方法來注釋需要表明的內容。并且把注釋的內容放在需要注釋的代碼的前面一行或同一行。
- 塊注釋:使用/**和*/注釋的方法來注釋需要表明的內容。并且把注釋的內容放在需要注釋的代碼的前面。
- 注釋哪些部分:類的目的(即類所完成的功能)、設置接口的目的以及應如何被使用、成員方法注釋(對于設置與獲取成員方法,在成員變量已有說明的情況下,可以不加注釋;普通成員方法要求說明完成什么功能,參數含義是什么?返回什么?)、普通成員方法內部注釋(控制結構、代碼做了些什么以及為什么這樣做,處理順序等)、實參和形參的含義以及其他任何約束或前提條件、字段或屬性描述。而對于局部變量,如無特別意義的情況下不加注釋。
JAVA文件聲明順序
類或接口應該按以下順序聲明(其實是加載順序的問題):
- 包的定義
- impot類(輸入包的順序、避免使用*)輸入包應該按照java.*.*,javax.*.*,org.*.* ,com.*.*的順序import在import的時候不應該使用* (例如: java.util.*)
- 類或接口的定義
- 靜態(tài)變量定義,按public,protected,private順序
- 實例變量定義,按public,protected,private順序
- 構造方法
- 方法定義順序按照public方法(類自己的方法),實現接口的方法,重載的public法,受保護方法,包作用域方法和私有方法。建議:類中每個方法的代碼行數不要超過100行。
- 內部類的定義
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持創(chuàng)新互聯(lián)。
網頁名稱:JAVA代碼書寫規(guī)范匯總詳解
地址分享:
http://weahome.cn/article/pihddd.html