資源描述:
《java程序設計programming in java》由會員上傳分享,免費在線閱讀,更多相關(guān)內(nèi)容在教育資源-天天文庫。
1、Java程序設計ProgramminginJava雍俊海清華大學軟件學院SchoolofSoftware,TsinghuaUniversityyongjunhai@tsinghua.org.cn6/29/20211教材雍俊海.Java程序設計.北京:清華大學出版社,2008.6/29/20212輔助教材雍俊海.Java程序設計教程(第2版).北京:清華大學出版社,2007.6/29/20213習題集雍俊海.Java程序設計習題集(含參考答案).北京:清華大學出版社,2006.6/29/20214參考文獻本
2、課件的參考文獻與下列書的參考文獻相同雍俊海.Java程序設計.北京:清華大學出版社,2008.雍俊海.Java程序設計教程(第2版).北京:清華大學出版社,2007.雍俊海.Java程序設計習題集(含參考答案).北京:清華大學出版社,2006.雍俊海.Java程序設計.北京:清華大學出版社,2004.6/29/20215第10章編程規(guī)范雍俊海(Jun-HaiYong)清華大學軟件學院SchoolofSoftware,TsinghuaUniversityyongjunhai@tsinghua.org.cn6
3、/29/20216本章總體綱要編程規(guī)范文檔注釋6/29/20217Java編程風格的指導方針指導方針是可以被打破,但要求是確實所需要的,例如增加可讀性沒有標準可以做到完美無缺,也沒有標準可以做到適用于所有的應用指導方針一般是為了:增加可讀性、程序的可理解性,從而提高程序的可維護性以及程序代碼質(zhì)量6/29/20218命名規(guī)范良好的命名規(guī)范可以增強程序的可讀性可以給標識符提供功能/屬性上的一些額外信息—例如:是否是常量、類、包等。這些信息對理解程序非常有幫助6/29/20219問題?命名規(guī)范應當包含哪些內(nèi)容?
4、6/29/202110命名規(guī)范內(nèi)容包文件類/接口方法變量常量6/29/202111包的命名規(guī)范包的名稱一般全部采用小寫包名的前綴一般是域名單詞序列的逆序示例com.sun.engcom.apple.quicktimeedu.cmu.cs.bovik.cheese6/29/202112文件的命名規(guī)范Java源程序文件的命名規(guī)范必須與該文件中public類的類名同名后綴必須是.java6/29/202113類/接口的命名規(guī)范類名一般是名詞/名詞詞組:每個單詞的首字母大寫,其它字母小寫類名應當盡量簡單,而且其含
5、義能夠盡量準確地刻畫該類的含義一般采用全稱—盡量少用縮寫詞(除非該縮寫詞被廣泛使用)示例J_ClockJ_CircleTimeImageSprite(圖版精靈)6/29/202114方法的命名規(guī)范方法名一般是/動詞/動詞性詞組,首字母小寫中間單詞的首字母大寫,其它字母小寫示例:run();getBackground();getTime();6/29/202115盡量應用常用詞盡量應用簡單的、常用的單詞示例:get/setfirst/lastadd/removeup/downcreate/destroymi
6、n/maxstart/stopnext/previousinsert/deleteold/newincrement/decrementopen/closeold/newshow/hidebegin/end6/29/202116變量的命名規(guī)范變量名的首字母小寫中間單詞的首字母大寫,其它字母小寫變量名的首字母盡量不要用字符:_或$變量名應當簡短、有含義、且便于記憶示例:inti;charc;doublewidthBox;6/29/202117變量的命名規(guī)范變量名常常由表示其所扮演的角色與數(shù)據(jù)類型組成示例:Po
7、intstartingPoint,centerPoint;NameloginName;6/29/202118常量的命名規(guī)范常量名一般全大寫,單詞之間用下劃線分隔(“_”)示例:staticfinalintMIN_WIDTH=4;staticfinalintMAX_WIDTH=999;6/29/202119編輯方法特殊字符行數(shù)/每行的字符數(shù)縮排方式(Indentation)空白符/行6/29/202120語句書寫——關(guān)鍵保證代碼的簡單性6/29/202121文件組織源程序文件一般采用如下的組織順序:最開始一
8、般是注釋package和import語句類和接口的定義6/29/202122本章總體綱要編程規(guī)范文檔注釋6/29/202123javadocJavadoc是一種從文檔注釋生成HTML幫助文件的工具文檔注釋介于/**和*/之間示例/**SortsintegerarrayusingMySortalgorithm*/6/29/202124文檔注釋的一般格式示例:/***Thisisthedescriptionpar