在進行Java代碼敲寫的時候,我們知道是有很多的Java代碼規范是需要遵守的,但是有的Java學員就老是忘記,還有的Java學員是不屑遵守的,內心想著是只要我的Java代碼OK,遵不遵守Java代碼規范,有什么問題呢?其實是存在問題的,為什么要遵守Java代碼規范?
成都創新互聯堅持“要么做到,要么別承諾”的工作理念,服務領域包括:網站制作、網站設計、企業官網、英文網站、手機端網站、網站推廣等服務,滿足客戶于互聯網時代的金州網站設計、移動媒體設計的需求,幫助企業找到有效的互聯網解決方案。努力成為您成熟可靠的網絡建設合作伙伴!
為什么要遵守Java代碼規范?當你第一次接觸到Java代碼規范的時候,你是不是覺得很麻煩呢?比如關于統一的原則,一再的強調,但是你一再的忘記,或者壓根就不想照做,會出現什么樣的后果呢?今天云南java培訓將借Java代碼規范中的統一來說說,自己對為什么要遵守Java代碼規范,發表自己簡單的看法。
Java代碼規范中的統一是指,對于同一個概念,在程序中用同一種表示方法,比如對于供應商,既可以用supplier,也可以用provider,但是我們只能選定一個使用,至少在一個Java項目中保持統一。統一是作為重要的,如果對同一概念有不同的表示方法,會使代碼混亂難以理解。即使不能取得好的名稱,但是只要統一,閱讀起來也不會太困難,因為閱讀者只要理解一次。
而如果你在一個項目中不遵守已經制定好的統一規范,那么不僅是給自己帶來麻煩,也是給其他工作人員帶來不便,在要進行整理的時候,你的不同,會帶來不必要的交流麻煩。作為一個Java程序員,你一般是屬于團隊中的一員,你不遵守制定好的Java代碼規范,其他人也不遵守那么你們的團隊就得亂套了,所以面對Java代碼規范的學習,不要覺得無趣,還是得用心記住,并且予以遵守。
對于程序員來說,養成良好的代碼寫作能力是非常重要的。
今天,我們就一起來了解一下,規范化的代碼編寫都有哪些要求。
希望通過對本文的閱讀,能夠提高大家對于代碼規范的認識。
1.保證代碼壓縮后不出錯對于大型的JSP項目,一般會在產品發布時對項目包含的所有JSP文件進行壓縮處理,比如可以利用GoogleClosureCompilerService對代碼進行壓縮,新版jQuery已改用這一工具對代碼進行壓縮,這一般會去掉開發時寫的注釋,除去所有空格和換行,甚至可以把原來較長的變量名替換成短且無意義的變量名,這樣做的目的是加快文件的下載速度,同時也減小網站訪問帶來的額外數據流量,另外在代碼保護上也起到了一點點作用,至少壓縮后的代碼即使被還原還是沒那么容易一下讀懂的。
要想代碼能正確通過壓縮,一般要求語句都要以分號正常結束,大括號也要嚴格結束等,具體還要看壓縮工具的要求。
所以如果一開始沒有按標準來做,等壓縮出錯后再回去找錯誤那是浪費時間。
2.保證代碼能通過特定IDE的自動格式化功能一般較為完善的開發工具(比如AptanaStudio)都有代碼"自動格式"化功能,這一功能幫助實現統一換行、縮進、空格等代碼編排,你可以設置自己喜歡的格式標準,比如左大括號{是否另起一行。
達到這個要求的目的在于方便你的開發團隊成員拿你代碼的一個副本用IDE自動格式化成他喜歡或熟悉的風格進行閱讀。
你同事需要閱讀你的代碼,可能是因為你寫的是通用方法,他在其它模塊開發過程中也要使用到,閱讀你的代碼能深入了解方法調用和實現的細節,這是簡單API文檔不能達到的效果。
3.使用標準的文檔注釋這一要求算是基本的,這有利于在方法調用處看到方法的具體傳參提示,也可以利用配套文檔工具生成html或其它格式的開發文檔供其他團隊成員閱讀,你可以嘗試使用jsdoc-toolkit。
如果你自動生成的API是出自一個開放平臺,就像facebook.com應用,那么你的文檔是給天下所有開發者看的。
另外編寫完整注釋,也更方便團隊成員閱讀你的代碼,通過你的參數描述,團隊成員可以很容易知道你編寫的方法傳參與實現細節。
當然也方便日后代碼維護,這樣即使再大的項目,過了很長時間后,回去改點東西也就不至于自己都忘記了當時自己寫的代碼是怎么一回事了。
4.使用規范有意義的變量名使用規范有意義的變量名可以提高代碼的可讀性,作為大項目開發成員,自己寫的代碼不僅僅要讓別人容易看懂。
電腦培訓認為開發大項目,其實每個人寫的代碼量可能都比較大,規范命名,日后自己看回自己的代碼也顯的清晰易懂,比如日后系統升級或新增功能,修改起代碼來也輕松多了。
如果到頭發現自己當初寫的代碼現在看不太懂了,那還真是天大的笑話了。
對于每個程序員來說,養成良好的代碼編寫方法是非常關鍵的。
在編寫代碼的過程中,每個人的方法是不同的,那么應該如何規范自己代碼編寫的方法呢?規范編寫代碼有哪些要求呢?下面電腦培訓帶大家認識代碼編寫的方法。
一、保證代碼壓縮后不會出錯對于大的JavaScript項目,一般來說,包含在項目中的所有JavaScript文件在產品公開時都會被壓縮。
為了正確壓縮代碼,通常需要考慮壓縮工具的必要條件,如句子用分號正常結束,中括號結束等。
因此,IT培訓發現當編寫代碼沒有按照標準進行時,在發生壓縮錯誤后再次尋找錯誤是浪費時間的。
二、保證代碼能夠通過自動格式化功能一般情況下需要使用完善的開發工具進行自動化格式功能,這個功能能夠進行換行、縮進和空格等方法的代碼編排,并且還可以設置自己喜歡的格式。
別人在閱讀你的代碼時需要使用IDE進行格式轉換,以滿足個人的閱讀風格。
江蘇北大青鳥認為閱讀代碼能夠更加深入的了解代碼調用和細節的實現,這是簡單的文檔不能實現的。
三、使用標準的文檔注釋這是編寫代碼中最基本的要求,能夠很好的了解代碼的提示,并且還可以利用配套的文檔工具生產其他格式讓別人閱讀。
北大青鳥認為編寫完整的注釋還可以使團隊成員更容易閱讀您的代碼。
通過您的參數描述,團隊成員很容易了解您想要傳遞參與實現細節和編寫的方法。