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

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

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