|
基本命名規(guī)范 Java 程序有兩類注釋：實現注釋(implementationcomments)和文檔注釋(document comments)。實現注釋是使用/*...*/和//界定的注釋。文檔注釋(被稱為"doc comments")由/**...*/界定。文檔注釋可以通過JavaDoc工具轉換成HTML 文件。 2.5.1文件注釋所有的源文件都應該在開頭有一個注釋，其中列出類名、版本信息、日期和版權聲明。 如下： /* * 文件名 * 包含類名列表 * 版本信息，版本號 * 創(chuàng)建日期 * 版權聲明 */ Eclipse中的配置方式： file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image004.gif 需要配置的注釋格式如下： /** * @title:${file_name} * TODO包含類名列表 * Copyright (C) Shenzhen Futuo TechnologyCo.Ltd.All right reserved. * @version：v1.0,${date} */ ${filecomment} ${package_declaration} ${typecomment} /**@name ${type_name} * @description * @author max * @DATE ${date} */ ${type_declaration} 2.5.2類注釋每一個類都要包含如下格式的注釋，以說明當前類的功能等。 /** * @name 類名 * @author 原作者 * @description實現的主要功能。 * @date創(chuàng)建日期 * 修改者，修改日期，修改內容。 */ Eclipse中的配置方式： file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image006.gif 2.5.3方法注釋每一個方法都要包含 如下格式的注釋 包括當前方法的用途，當前方法參數的含義，當前方法返回值的內容和拋出異常的列表。 /** * 方法的一句話概述 * 方法詳述（簡單方法可不必詳述） * @param s 說明參數含義 * @return 說明返回值含義 * @throws IOException 說明發(fā)生此異常的條件 * @throws NullPointerException 說明發(fā)生此異常的條件 */ 2.5.4類成員變量和常量注釋成員變量和常量需要使用java doc形式的注釋，以說明當前變量或常量的含義 /** *XXXX含義 */ 2.5.5其他注釋方法內部的注釋 如果需要多行 使用/*…… */形式，如果為單行是用//……形式的注釋。不要在方法內部使用 java doc 形式的注釋“/**……**/”，簡單的區(qū)分方法是，java doc形式的注釋在 eclipse中為藍色，普通注釋為綠色。 2.5.6 XML注釋如果當前l(fā)ayout 或資源需要被多處調用，或為公共使用的layout（若common_list_item），則需要在xml寫明注釋。要求注釋清晰易懂。 2.6編程規(guī)范2.6.1 方法 一個方法盡量不要超過30行，如果方法太長，說明當前方法業(yè)務邏輯已經非常復雜，那么就需要進行方法拆分，保證每個方法只作一件事。 2.5.2 參數和返回值 一個方法的參數盡可能的不要超過4個！ 如果一個方法返回的是一個錯誤碼，請使用異常??！ 盡可能不要使用null，替代為異?；蛘呤褂每兆兞咳绶祷豅ist則可以使用Collections.emptyList() 2.5.3 神秘的數代碼中不允許出現單獨的數字，字符！如果需要使用數字或字符，則將它們按照含義封裝為靜態(tài)常量?。╢or語句中除外） 2.5.4 控制語句判斷中如有常量，則應將常量置于判斷式的右側。如： if ( true == isAdmin())... 盡量不使用三目條件的嵌套。 所有if 語句必須用{}包括起來,即便是只有一句： if (true){ //do something...... } if (true) i = 0; //不要使用這種 對于循環(huán)： //不推薦方式____________________________________________ while(index < products.getCount()){ //每此都會執(zhí)行一次getCount()方法， //若此方法耗時則會影響執(zhí)行效率 //而且可能帶來同步問題，若有同步需求，請使用同步塊或同步方法 } //推薦方式______________________________________________ //將操作結構保存在臨時變量里，減少方法調用次數 final int count = products.getCount(); while(index < count){ } |
|
|
