www.久久久久|狼友网站av天堂|精品国产无码a片|一级av色欲av|91在线播放视频|亚洲无码主播在线|国产精品草久在线|明星AV网站在线|污污内射久久一区|婷婷综合视频网站

當前位置:首頁 > 單片機 > 架構(gòu)師社區(qū)
[導(dǎo)讀]1、引言: 這個標準是衡量代碼本身的缺陷,也是衡量一個研發(fā)人員本身的價值。華為作為一家全球化的 IT 公司,十幾萬員工,無論是人事管理,還是代碼管理,都是一件不容易的事情,沒有規(guī)范的約束,想想都是件可怕的事情。下面挑選了一些網(wǎng)上流傳的編程規(guī)范,一

1、引言:

這個標準是衡量代碼本身的缺陷,也是衡量一個研發(fā)人員本身的價值。華為作為一家全球化的 IT 公司,十幾萬員工,無論是人事管理,還是代碼管理,都是一件不容易的事情,沒有規(guī)范的約束,想想都是件可怕的事情。下面挑選了一些網(wǎng)上流傳的編程規(guī)范,一起來學習下,以下內(nèi)容不涉及基礎(chǔ)的語法規(guī)范(請見 Refer),更側(cè)重于一些編程習慣,如何提高程序的健壯性、可維護性等。(PS:以下內(nèi)容未經(jīng)官方考證,如閱讀者出現(xiàn)不適,請選擇立即關(guān)閉本頁 -_-||| )

2、軍規(guī)簡介:

軍規(guī)一:【避免在程序中使用魔鬼數(shù)字,必須用有意義的常量來標識。】

軍規(guī)二:【明確方法的功能,一個方法僅完成一個功能。】

軍規(guī)三:【方法參數(shù)不能超過5個】

軍規(guī)四:【方法調(diào)用盡量不要返回null,取而代之以拋出異常,或是返回特例對象(SPECIAL CASE object,SPECIAL CASE PATTERN);對于以集合或數(shù)組類型作為返回值的方法,取而代之以空集合或0長度數(shù)組?!?/span>

軍規(guī)五:【在進行數(shù)據(jù)庫操作或IO操作時,必須確保資源在使用完畢后得到釋放,并且必須確保釋放操作在finally中進行?!?/span>

軍規(guī)六:【異常捕獲不要直接catch (Exception ex) ,應(yīng)該把異常細分處理。】

軍規(guī)七:【對于if ? else if ?(后續(xù)可能有多個else if …)這種類型的條件判斷,最后必須包含一個else分支,避免出現(xiàn)分支遺漏造成錯誤;每個switch-case語句都必須保證有default,避免出現(xiàn)分支遺漏,造成錯誤?!?/span>

軍規(guī)八:【覆寫對象的equals()方法時必須同時覆寫hashCode()方法?!?/span>

軍規(guī)九:【禁止循環(huán)中創(chuàng)建新線程,盡量使用線程池?!?/span>

軍規(guī)十:【在進行精確計算時(例如:貨幣計算)避免使用float和double,浮點數(shù)計算都是不精確的,必須使用BigDecimal或?qū)⒏↑c數(shù)運算轉(zhuǎn)換為整型運算?!?nbsp;

3、軍規(guī)說明


軍規(guī)一:【避免在程序中使用魔鬼數(shù)字,必須用有意義的常量來標識。】

說明:是否是魔鬼數(shù)字要基于容易閱讀和便于全局替換的原則。0、1作為某種專業(yè)領(lǐng)域物理量枚舉數(shù)值時必須定義常量,嚴禁出現(xiàn)類似NUMBER_ZERO的“魔鬼常量”。 

軍規(guī)二:【明確方法的功能,一個方法僅完成一個功能。】

說明:方法功能太多,會增加方法的復(fù)雜度和依賴關(guān)系,不利于程序閱讀和將來的持續(xù)維護,無論是方法還是類設(shè)計都應(yīng)符合單一職責原則。 

軍規(guī)三:【方法參數(shù)不能超過5個】

說明:參數(shù)太多影響代碼閱讀和使用,為減少參數(shù),首先要考慮這些參數(shù)的合理性,保持方法功能單一、優(yōu)化方法設(shè)計,如果參數(shù)確實無法減少,可以將多個參數(shù)封裝成一個類(對象),同時考慮在新的類(對象)中增加相應(yīng)的行為,以期更符合OOP。 

軍規(guī)四:【方法調(diào)用盡量不要返回null,取而代之以拋出異常,或是返回特例對象(SPECIAL CASE object,SPECIAL CASE PATTERN);對于以集合或數(shù)組類型作為返回值的方法,取而代之以空集合或0長度數(shù)組?!?/strong>

說明:返回null會增加不必要的空指針判斷,遺漏判斷也會導(dǎo)致嚴重的NullPointerException錯誤。

軍規(guī)五:【在進行數(shù)據(jù)庫操作或IO操作時,必須確保資源在使用完畢后得到釋放,并且必須確保釋放操作在finally中進行?!?/strong>

說明:數(shù)據(jù)庫操作、IO操作等需要關(guān)閉對象必須在try -catch-finally 的finally中close(),如果有多個IO對象需要關(guān)閉,需要分別對每個對象的close()方法進行try-catch,防止一個IO對象關(guān)閉失敗其他IO對象都未關(guān)閉。推薦做法如下:

Connection jdbcConnection = null;

       Statement stmt = null;

       try

       {
            ........

       }

       catch(SQLException e)

       {
            ........

       }
 
       finally

       {
           if(stmt != null)

           {
                try
                {
                    stmt.close();
                }

                catch(SQLException e)

                {
                    logger.log(Level.WARNING,"異常說明", e);
 
                }

           }

           if(jdbcConnection != null)

           {
                try

                {
                    jdbcConnection.close();

                }

                catch(SQLException e)

                {
                    logger.log(Level.WARNING,"異常說明", e);

               }

           }

       }

軍規(guī)六:【異常捕獲不要直接 catch(Exception ex) ,應(yīng)該把異常細分處理?!?/strong>

說明:catch (Exception ex)的結(jié)果會把RuntimeException異常捕獲,RuntimeException是運行期異常,是程序本身考慮不周而拋出的異常,是程序的BUG,如無效參數(shù)、數(shù)組越界、被零除等,程序必須確保不能拋出RuntimeException異常,不允許顯示捕獲RuntimeException異常就是為了方便測試中容易發(fā)現(xiàn)程序問題。 

軍規(guī)七:【對于if ? else if ?(后續(xù)可能有多個elseif …)這種類型的條件判斷,最后必須包含一個else分支,避免出現(xiàn)分支遺漏造成錯誤;每個switch-case語句都必須保證有default,避免出現(xiàn)分支遺漏,造成錯誤?!?/strong>


軍規(guī)八:【覆寫對象的equals()方法時必須同時覆寫hashCode()方法?!?/strong>

說明:equals和hashCode方法是對象在hash容器內(nèi)高效工作的基礎(chǔ),正確的覆寫這兩個方法才能保證在hash容器內(nèi)查找對象的正確性,同時一個好的hashCode方法能大幅提升hash容器效率。 

軍規(guī)九:【禁止循環(huán)中創(chuàng)建新線程,盡量使用線程池。】


軍規(guī)十:【在進行精確計算時(例如:貨幣計算)避免使用float和double,浮點數(shù)計算都是不精確的,必須使用BigDecimal或?qū)⒏↑c數(shù)運算轉(zhuǎn)換為整型運算?!?/strong>

說明:浮點運算在一個范圍很廣的值域上提供了很好的近似,但是它不能產(chǎn)生精確的結(jié)果。二進制浮點對于精度計算是非常不適合的,因為它不可能將0.1——或者10的其它任何次負冪精確表示為一個長度有限的二進制小數(shù)。

具體案例請參考:浮點數(shù)加法引發(fā)的問題:浮點數(shù)的二進制表示

http://my.oschina.net/leejun2005/blog/156793

4、有關(guān)開發(fā)效率和協(xié)作的幾點建議與心得體會

今天看到某同學寫給團隊成員的一封郵件,發(fā)現(xiàn)比較通用,分享出來吧:

1. 小提交: 

把大的任務(wù)拆分成多個獨立小任務(wù),每完成小任務(wù)確保無 Bug 后就可以提交合并到主分支甚至發(fā)布;頻繁提交有利于自己把控項目進度、降低風險、同其他人協(xié)作和代碼 Review ; 每天可以提交合并多次。每個小任務(wù)是 1-2 個小時可以完成的粒度,最大的一天完成。并行做多個任務(wù)的時候,優(yōu)先做最短時間能夠?qū)崿F(xiàn)的任務(wù)。

2. 命名規(guī)范: 

盡量避免無意義的字符做變量 比如 a, b, t ??梢灾鸩礁纳疲梢詤⒖?

http://google-styleguide.googlecode.com/svn/trunk/javaguide.html

3. 避免過度設(shè)計: 

能夠用簡單方式實現(xiàn)的功能,不引入復(fù)雜的類,對象,避免不必要的 new 對象,避免引入不必要的泛型、線程。開發(fā)初期冗余大于抽象和依賴。避免自己重新實現(xiàn)比較通用的組件和函數(shù)。調(diào)研多種實現(xiàn)方式的時候,選用做簡單的實現(xiàn)方式。盡量少寫代碼。

4. Web 工程盡量避免在應(yīng)用內(nèi)部保存“狀態(tài)”,這樣可以適應(yīng)頻繁發(fā)布、重啟無影響。

5. 善于用打日志的方式調(diào)試,在程序關(guān)鍵點打日志。盡量少用斷點方式,日志方式可以批量調(diào)試一批功能,效率相對高。

6. 避免一屏顯示不下的超大函數(shù)。

7. 添加必要、簡潔的注釋:

循環(huán)中的 continue, break 盡量加上單行注釋;盡量避免非函數(shù)結(jié)尾的 return,必要的時候加注釋。類自動生成 toString() 方法,方便調(diào)試和打日志。

8. 不把自己局限到做某個功能,每個人都是整個項目的 Owner ,盡量交叉 Review ,交叉開發(fā)。

9. 遇到問題及時和其他人溝通,避免浪費時間。

10. 從最終產(chǎn)品的目標審視自己細小的設(shè)計,熟悉自己負責部分的上下游代碼。時刻關(guān)注最終產(chǎn)品(Web 界面和日志),發(fā)現(xiàn) Bug 和可以改善的地方。


特別推薦一個分享架構(gòu)+算法的優(yōu)質(zhì)內(nèi)容,還沒關(guān)注的小伙伴,可以長按關(guān)注一下:

華為 Java 編程軍規(guī)

華為 Java 編程軍規(guī)

華為 Java 編程軍規(guī)

長按訂閱更多精彩▼

華為 Java 編程軍規(guī)

如有收獲,點個在看,誠摯感謝

免責聲明:本文內(nèi)容由21ic獲得授權(quán)后發(fā)布,版權(quán)歸原作者所有,本平臺僅提供信息存儲服務(wù)。文章僅代表作者個人觀點,不代表本平臺立場,如有問題,請聯(lián)系我們,謝謝!

本站聲明: 本文章由作者或相關(guān)機構(gòu)授權(quán)發(fā)布,目的在于傳遞更多信息,并不代表本站贊同其觀點,本站亦不保證或承諾內(nèi)容真實性等。需要轉(zhuǎn)載請聯(lián)系該專欄作者,如若文章內(nèi)容侵犯您的權(quán)益,請及時聯(lián)系本站刪除。
換一批
延伸閱讀

LED驅(qū)動電源的輸入包括高壓工頻交流(即市電)、低壓直流、高壓直流、低壓高頻交流(如電子變壓器的輸出)等。

關(guān)鍵字: 驅(qū)動電源

在工業(yè)自動化蓬勃發(fā)展的當下,工業(yè)電機作為核心動力設(shè)備,其驅(qū)動電源的性能直接關(guān)系到整個系統(tǒng)的穩(wěn)定性和可靠性。其中,反電動勢抑制與過流保護是驅(qū)動電源設(shè)計中至關(guān)重要的兩個環(huán)節(jié),集成化方案的設(shè)計成為提升電機驅(qū)動性能的關(guān)鍵。

關(guān)鍵字: 工業(yè)電機 驅(qū)動電源

LED 驅(qū)動電源作為 LED 照明系統(tǒng)的 “心臟”,其穩(wěn)定性直接決定了整個照明設(shè)備的使用壽命。然而,在實際應(yīng)用中,LED 驅(qū)動電源易損壞的問題卻十分常見,不僅增加了維護成本,還影響了用戶體驗。要解決這一問題,需從設(shè)計、生...

關(guān)鍵字: 驅(qū)動電源 照明系統(tǒng) 散熱

根據(jù)LED驅(qū)動電源的公式,電感內(nèi)電流波動大小和電感值成反比,輸出紋波和輸出電容值成反比。所以加大電感值和輸出電容值可以減小紋波。

關(guān)鍵字: LED 設(shè)計 驅(qū)動電源

電動汽車(EV)作為新能源汽車的重要代表,正逐漸成為全球汽車產(chǎn)業(yè)的重要發(fā)展方向。電動汽車的核心技術(shù)之一是電機驅(qū)動控制系統(tǒng),而絕緣柵雙極型晶體管(IGBT)作為電機驅(qū)動系統(tǒng)中的關(guān)鍵元件,其性能直接影響到電動汽車的動力性能和...

關(guān)鍵字: 電動汽車 新能源 驅(qū)動電源

在現(xiàn)代城市建設(shè)中,街道及停車場照明作為基礎(chǔ)設(shè)施的重要組成部分,其質(zhì)量和效率直接關(guān)系到城市的公共安全、居民生活質(zhì)量和能源利用效率。隨著科技的進步,高亮度白光發(fā)光二極管(LED)因其獨特的優(yōu)勢逐漸取代傳統(tǒng)光源,成為大功率區(qū)域...

關(guān)鍵字: 發(fā)光二極管 驅(qū)動電源 LED

LED通用照明設(shè)計工程師會遇到許多挑戰(zhàn),如功率密度、功率因數(shù)校正(PFC)、空間受限和可靠性等。

關(guān)鍵字: LED 驅(qū)動電源 功率因數(shù)校正

在LED照明技術(shù)日益普及的今天,LED驅(qū)動電源的電磁干擾(EMI)問題成為了一個不可忽視的挑戰(zhàn)。電磁干擾不僅會影響LED燈具的正常工作,還可能對周圍電子設(shè)備造成不利影響,甚至引發(fā)系統(tǒng)故障。因此,采取有效的硬件措施來解決L...

關(guān)鍵字: LED照明技術(shù) 電磁干擾 驅(qū)動電源

開關(guān)電源具有效率高的特性,而且開關(guān)電源的變壓器體積比串聯(lián)穩(wěn)壓型電源的要小得多,電源電路比較整潔,整機重量也有所下降,所以,現(xiàn)在的LED驅(qū)動電源

關(guān)鍵字: LED 驅(qū)動電源 開關(guān)電源

LED驅(qū)動電源是把電源供應(yīng)轉(zhuǎn)換為特定的電壓電流以驅(qū)動LED發(fā)光的電壓轉(zhuǎn)換器,通常情況下:LED驅(qū)動電源的輸入包括高壓工頻交流(即市電)、低壓直流、高壓直流、低壓高頻交流(如電子變壓器的輸出)等。

關(guān)鍵字: LED 隧道燈 驅(qū)動電源
關(guān)閉