程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> JAVA編程 >> 關於JAVA >> java開辟定名標准總結

java開辟定名標准總結

編輯:關於JAVA

java開辟定名標准總結。本站提示廣大學習愛好者:(java開辟定名標准總結)文章只能為提供參考,不一定能成為您想要的結果。以下是java開辟定名標准總結正文


應用前留意事項:
1、因為Java面向對象編程的特征, 在定名時應盡可能選擇名詞

2、駝峰定名法(Camel-Case): 當變量名或函式名是由一個或多個單字貫穿連接在一路,而組成的獨一辨認字時,首字母以小寫開首,每一個單詞首字母年夜寫(第一個單詞除外)。

如:myFirstName

一 包名的書寫標准 (Package)
推舉應用公司或機構的頂級域名為包名的前綴,目標是包管各公司/機構內所應用的包名的獨一性。包名全體為小寫字母,且具有現實的辨別意義。

1.1 普通請求
1、選擇成心義的名字,能疾速地轉達該類的用處。

2、一切包的定名必需采取小寫英文字母。

1.2 現實運用
運用體系中常常運用分層,Dao層(數據庫拜訪)、Service層(營業處置)、Web層(頁面掌握action類)。

1、包名的前幾個為固命名稱, 假如是網站的話,采取網站的域名的反寫,假如域名還沒有肯定的話,采取公司固定的幾個稱號。如:net.vschool

2、在包名的接上去一個單詞為模塊的稱號。如:用戶模塊,包名為net.vschool.user

3、關於模塊的拜訪操作,采取分層情勢,普通分為:

Dao層操作:普通界說在net.vschool.xxx.dao 中,個中xxx為模塊稱號。

Service層操作:普通界說在net.vschool.xxx.servie中。

web層操作:普通界說在 net.vschool.xxx.action中。

以下關於用戶模塊的例子:

net.vschool.user

net.vschool.user.dao

net.vschool.user.action

net.vschool.user.service

二 類名的書寫標准 (Class)
類名必需應用名詞,假如一個類名內含多個單詞,那末各個單詞第一個字母年夜寫,後續字母小寫,升沉呈駝峰狀,人稱駝峰式定名。給類名定名時,必需包管精確、簡練且輕易懂得。盡可能應用完全單詞,防止應用縮寫詞(除年夜家公認的)

2.1 類的定名
2.1.1 普通請求
1、選擇成心義的名字,能疾速地轉達該類的用處。

2、參照java駝峰定名法,類名的首字母必需采取年夜寫的情勢,假如類名為多詞組合而成的話,那末每一個詞的首字母必需采取年夜寫。如:StudentAnswer.java

3、當要差別接口類和完成類的時刻,可以在類的前面加上“Impl”。

如:接口類:UserInterface.java   接話柄現類:UserInterfaceImp

4、推舉實體類沒有後綴名。

2.1.2 現實運用
運用體系中常常運用分層,Dao層(數據庫拜訪)、Service層(營業處置)、Web層(頁面掌握action類),每層的類的稱號盡可能帶上該層後綴。

1、Dao層

a、接口類:采取JavaBean+Interface+Dao的情勢來界說,即,實體對象+Interface+Dao。  

如:用戶對象接口類: UserInterfaceDao,個中xxx為模塊稱號。

b、完成類:采取JavaBean+Interface+Impl+Dao的情勢來界說,即,實體對象        

+Interface+Impl+Dao。 如:用戶對象完成類:UserInterfaceImplDao

2、Service層

a、接口類:采取Xxx+Interface+Service的情勢來界說,即,模塊+Interface+Service。    

如:用戶治理接口類:UserMsgInterfaceServiec

b、完成類:采取Xxx+Interface+Impl+Service的情勢來界說,即,模塊+Interface+

Impl+Service。如:用戶治理完成類:UserMsgInterfaceImplServiec

3、Web層(action類)

a、完成類:采取縣 Xxx+Operator+Action的情勢來界說,即,模塊+操作+Action。如       

用戶模塊User+刪除操作Delete+Action = UserDeleteAction

2.1 變量的定名
2.2.1 通俗變量
2.2.2.1 普通請求
1、選擇成心義的名字,能疾速地轉達該變量的用處。

2、參照java駝峰定名法,首字母以小寫開首,每一個單詞首字母年夜寫(第一個單詞除外)。

2.2.2.2 現實運用
1、變量定名采取根本構造為typeVariableName,應用3字符前綴來表現數據類型。

例如,界說一個整形變量:intDocCount,個中int注解數據類型,前面為表意的英文名,每一個單詞首字母年夜寫。

數據類型或對象類型

變量前綴

備注

byte

bye

1、做數組用時,再加前綴-a,如字符串數組:astr,

2、自界說類型的變量可以采取自己的稱號,把首字母改成小寫。

3、采取稱號要能代表在辦法中的意義。假如員工列表:employeeList

char

chr

float

flt

boolean

bln

Integer/int

int

short

sht

Long/long

lng

Double/double

dbl

string

str


2、變量應用技能:

a、在一段函數中不應用統一個變量表現前後意義分歧的兩個數值。

b、除非是在輪回中,不然普通不推舉應用單個字母作為變量名,i、j、k等只作為小型輪回的輪回索引變量。

c、防止用Flag來定名狀況變量。

d、用Is來定名邏輯變量,如:blnFileIsFound。經由過程這類給布爾變量確定情勢的定名方法,使得其它開辟人員可以或許更加清晰的懂得布爾變量所代表的意義。 

e、假如須要對變量名停止縮寫時,必定要留意全部代碼中縮寫規矩的分歧性。例如,假如在代碼的某些區域中應用intCnt,而在另外一些區域中又應用intCount,就會給代碼增長不用要的龐雜性。建議變量名中盡可能不要湧現縮寫。  

2.2.2 靜態變量
1、選擇成心義的名字,能疾速地轉達該變量的用處。

2、參照java駝峰定名法,采取全體年夜寫的情勢來書寫,關於采取多詞分解的變量采取“_”來銜接各單詞。如:USER_LIST

2.3 辦法的定名
2.3.1 普通請求
1、選擇成心義的名字,能疾速地轉達該辦法的用處。

2、參照java駝峰定名法,首字母以小寫開首,每一個單詞首字母年夜寫(第一個單詞除外)。

2.3.2 現實運用
1、辦法表現一種行動,它代表一種舉措,最好是一個動詞或許動詞詞組或許第一個單詞為一個動詞。

2、屬性辦法:以get/set開首,厥後跟字段稱號,字段稱號首字母年夜寫。如:getUserName()

3、數據層辦法:只能以insert(拔出),delete(刪除),update(更新),select(查找),count(統計)開首,其他層辦法防止以這個5個單詞開首,以避免形成誤會。

4、辦事層辦法,依據辦法的行動定名,只描寫辦法的意義,而不采取辦法的目標定名。好比體系的添加新用戶,用戶可之前台注冊,也能夠治理員後台添加,辦法會被重用,所以最好不要用應用register,采取add會更好寫。防止應用與web層相干的辦法。

5、Web層辦法最好是切近web的說話,如register,login,logout等辦法。

三 正文的書寫標准 (Javadoc)
Java除可以采取我們罕見的正文方法(//、/* */)以外,Java說話標准還界說了一種特別的正文,也就是我們所說的Javadoc正文,以/**開首,而以*/停止, Javadoc 正文可以被主動轉為在線文檔,省去了零丁編寫法式文檔的費事。 推舉應用。

Javadoc正文重要觸及規模:類、屬性、辦法。

例如:  

package org.ietf.jgss;

import java.net.InetAddress;

import java.util.Arrays;

/**

 * 該類的全體性描寫。

 *

 * @author 作者

 * @version 1.0, 05/22/07

 * @since 1.0

 */

public class ChannelBinding {

/**

 * 對該變量的備注信息

 */

private InetAddress initiator;

/**

 * 對該變量的備注信息

 */

private InetAddress acceptor;

/**

 * 對該變量的備注信息

 */

    private  byte[] appData;

  

    /**

     * 對該類的結構函數的備注信息。

     *

     * @param initAddr 對參數的備注。

     * @param acceptAddr對參數的備注。

     * @param appData對參數的備注。

     */

    public ChannelBinding(InetAddress initAddr, InetAddress acceptAddr,

              byte[] appData) {

         initiator = initAddr;

         acceptor = acceptAddr;

         if (appData != null) {

              this.appData = new byte[appData.length];

              java.lang.System.arraycopy(appData, 0, this.appData, 0,

                   appData.length);

         }

    }

 

    /**

     * 對該類的詳細一函數的備注信息

     *

     * @param obj 參數的備注信息

     * @return 前往值的備注信息

     */

    public boolean equals(Object obj) {

         if (this == obj)

              return true;

         if (! (obj instanceof ChannelBinding))

              return false;

         ChannelBinding cb = (ChannelBinding) obj;

         return Arrays.equals(appData, cb.appData);

    }

}

四 其他書寫標准

4.1 Jsp頁面稱號的書寫標准
1.全體采取小寫的英文字符和”_ ”構成。

2.全體采取模塊名+操作的情勢。如:user_view.jsp

3.Jsp頁面盡量與action的意思對應,如UserListAction 對應者user_list.jsp


接口:

應用駝峰式定名。除用名詞外,還可以用描述詞定名(表現其功效特征)

辦法:

劃定用動詞定名,合適用駝峰式定名,但與類名的最年夜差別在於,首字母必需小寫

變量:

劃定為名詞,其他同“辦法”定名方法一樣。變量名異常症結,應含有詳細意義且易於懂得,普通不許可應用單個字母做變量名。除非一些暫時性變量,像在輪回中應用到的計數器等。在應用單個字母做變量名時,普通I、J、K用來定名整形變量。

常量:

劃定全用年夜寫字母表現,假如名字必需用多個單詞來表現,那末各單詞間用“-“分隔。常量請求必需意義明白,能表達出常量的寄義。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved