1.3.1程序編寫與實現(xiàn)1.3.2代碼規(guī)范與注釋1.3第一個Java程序浙江經貿職業(yè)技術學院Java語言初

識Java語言程序設計Unit1主講胡堅1.3.2代碼規(guī)范與注釋1代碼編寫規(guī)范一個軟件的生命周期中，80%的花費在于維護。但幾乎沒有任何一個軟件，在其整個生命周期中均由最初的開發(fā)人員來維護。因此，任何編程對于代碼編寫的規(guī)范化都很重視，它直接影響到程序的質量。作為Java語言編程的初學者，應該了解Java代碼編寫的基本規(guī)范。1.3.2代碼規(guī)范與注釋1代碼編寫規(guī)范（1）標識符的命名見名知意統(tǒng)一簡潔12標識符的命名力求做到見名知意、統(tǒng)一簡潔。是指標識符能準確的表達出它所代表的意義，比如：HangzhouSupplier,BeijingSupplier明顯比Supplier1,Supplier2描述的更加達意、準確，更不恰當?shù)氖鞘褂肧1,S2等標識。是指于同一個概念在程序中用同一種表示方法，比如對于供應商，既可以用supplier，也可以用provider，但我們只能選定一個使用，簡潔則是指在統(tǒng)一和達意的前提下，用盡量少的標識符，如果不能達意，寧愿不要簡潔。1.3.2代碼規(guī)范與注釋1代碼編寫規(guī)范（1）標識符的命名首字母大寫，如：Teacher。類名首字母小寫，mathScore。變量名首單詞小寫，后續(xù)單詞首字母大寫，如：addSalary()。方法名均大寫，如LENGTH。常量名Java中常見標識命名規(guī)范1.3.2代碼規(guī)范與注釋1代碼編寫規(guī)范（2）代碼的縮排在編碼過程中，代碼的書寫風格很重要，成熟的工業(yè)代碼都具有良好的縮排風格，基本的要求是具有從屬關系的下層語句應該相對于上層語句縮進若干格，這樣可以有效提升程序的可讀性和代碼的可維護性，典型的縮排風格如圖所示。1.3.2代碼規(guī)范與注釋2代碼注釋注釋對于一個程序編寫的質量來說是重要的，對于代碼的可讀性和維護來說是至關重要的。注釋，即對程序內容的解釋，它不屬于正式代碼，會被編譯器忽略而不被編譯。注釋從使用者的角度可以分為實現(xiàn)注釋和文檔注釋，如圖所示。1.3.2代碼規(guī)范與注釋2代碼注釋（1）實現(xiàn)注釋（1）單行文本注釋符“//”這種注釋的屏蔽范圍是從“//”開始一直到本行結束為止。（2）多行文本注釋符“/*...*/”該方法適用添加較長的注釋，可以跨越多行，在“/*”與“*/”之間的所有內容都是注釋。實現(xiàn)注釋的功能是對部分或者某語句進行功能解釋，幫助代碼閱讀者能正確而順暢地理解代碼和實現(xiàn)細節(jié)。基本的方法有兩種：1.3.2代碼規(guī)范與注釋2代碼注釋（2）文檔注釋

文檔注釋的功能是對整個類的功能、類方法和變量等進行完整的說明，文檔注釋是Java獨有的并可以通過javadoc工具轉換成HTML文件。格式如下所示：/***對程序、類和變量等進行解釋*/由/**...*/界定，通?？梢詫Τ绦颉㈩惡妥兞康冗M行說明/*