前言：
最近發現很多初級程序員寫代碼時很不規范，比如方法名 類名 等，如果遇到有代碼潔癖的領導肯定會被罵（什么垃圾代碼），下面分享一篇不錯的規范文章
我將按照項目工程目錄結構，從包，類(接口，抽象類，異常類)，方法，變量和常量的順序展開介紹。
本文是 Java 命名規范的介紹，建議收藏轉發。
1. 包命名規范
包(Package)的作用是將功能相似或相關的類或者接口進行分組管理，便于類的定位和查找，同時也可以使用包來避免類名的沖突和訪問控制，使代碼更容易維護。通常，包命使用小寫英文字母進行命名，并使用“.”進行分割，每個被分割的單元只能包含一個名詞。
一般地，包命名常采用頂級域名作為前綴，例如com，net，org，edu，gov，cn，io等，隨后緊跟公司/組織/個人名稱以及功能模塊名稱。下面是一些包命名示例：
|
1
2
3
4
5
6
7
8
|
package org.springframework.boot.autoconfigure.cloudpackage org.springframework.boot.utilpackage org.hibernate.actionpackage org.hibernate.cfgpackage com.alibaba.druidpackage com.alibaba.druid.filterpackage com.alibaba.nacos.client.configpackage com.ramostear.blog.web |
下面是Oracle Java的一些常見包命名例子：
|
1
2
3
4
5
6
|
package java.beanspackage java.iopackage java.langpackage java.netpackage java.utilpackage javax.annotation |
2. 類命名規范
類(Class)通常采用名詞進行命名，且首字母大寫，如果一個類名包含兩個以上名詞，建議使用駝峰命名(Camel-Case)法書寫類名,每個名詞首字母也應該大寫。一般地，類名的書寫盡量使其保持簡單和描述的完整性，因此在書寫類名時不建議使用縮寫(一些約定俗成的命名除外。
例如 Internationalization and Localization 縮寫成i18n，Uniform Resource Identifier縮寫成URI，Data Access Object縮寫成DAO，JSON Web Token縮寫成JWT，HyperText Markup Language縮寫成HTML等等)。下列是一些常見的類命名示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
public class UserDTO{}class EmployeeService{ }class StudentDAO{ }class OrderItemEntity{ }public class UserServiceImpl{ }public class OrderItemController{ } |
下面是 Oracle Java 中的一些標準命名示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
public class HTMLEditorKit{ }public abstract class HttpContext{ }public interface ImageObserver{ }public class ArrayIndexOutOfBoundsException{ }public class enum Thread.State{ } |
2.1 接口命名規范
首先，接口(Interface)是一種表述某一類型對象動作的特殊類；簡單來說，接口也是類(不太嚴謹)，所以，接口的名稱的書寫也應該符合類名書寫規范，首字母應該大寫，與普通類名不同的是，接口命名時通常采用形容詞或動詞來描述接口的動作行為。下列是Oracle Java中一些標準庫的接口使用形容詞命名示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
public interface Closeable{ }public interface Cloneable{ }public interface Runnable{ }public interface Comparable<T>{ }public interface CompletionService<V>{ }public interface Iterable<T>{ }public interface EventListener{ } |
在Spring Framework標準庫中，通常采用名詞+動詞/形容詞的組合方式來命名接口，下列是Spring Framework中一些接口命名示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
public interface AfterAdvice{ }public interface TargetClassAware{ }public interface ApplicationContextAware{ }public interface MessageSourceResolvable{ } |
2.2 抽象類命名規范
抽象類(Abstract Class)是一種特殊的類，其命名與普通類的命名規范相當。一般地，為了將抽象類與普通類和接口做出區別，提高抽象類的可讀性，在命名抽象類時，會以“Abstract”/“Base”作為類命的前綴。下面是編程中一些常規的命名示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
public abstract class AbstractRepository<T>{ }public abstract class AbstractController{ }public abstract class BaseDao<T,ID>{ }public abstract class AbstractCommonService<T>{ } |
以下是Spring Framework中常見的抽象類示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
public abstract class AbstractAspectJAdvice{ }public abstract class AbstractSingletonProxyFactoryBean{ }public abstract class AbstractBeanFactoryPointcutAdvisor{ }public abstract class AbstractCachingConfiguration{ }public abstract class AbstractContextLoaderInitializer{ } |
2.3 異常類命名規范
異常類(Exception Class)也是類的一種，但與普通類命名不同的是，異常類在命名時需要使用“Exception”作為其后綴。下面是常見的異常類命名示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
public class FileNotFoundException{ }public class UserAlreadyExistException{ }public class TransactionException{ }public class ClassNotFoundException{ }public class IllegalArgumentException{ }public class IndexOutOfBoundsException{ } |
另外，在Java中還有另外一類異常類，它們屬于系統異常，這一類異常類的命名使用“Error”作為其后綴，以區分Exception(編碼，環境，操作等異常)。下面是系統異常(非檢查異常)的命名示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
public abstract class VirtualMachineError{ }public class StackOverflowError{ }public class OutOfMemoryError{ }public class IllegalAccessError{ }public class NoClassDefFoundError{ }public class NoSuchFieldError{ }public class NoSuchMethodError{ } |
3.方法命名規范
方法(Method)命名時,其首字母應該小寫，如果方法簽名由多個單詞組成，則從第二個單詞起，使用駝峰命名法進行書寫。一般地，在對方法進行命名時，通常采用動詞/動詞+名詞的組合，下面是方法命名的一些常見示例。
3.1 表述獲取
如果一個方法用于獲取某個值，通常使用“get”作為其前綴，例如：
|
1
2
3
4
5
6
7
8
9
|
public String getUserName(){ }public List<Integer> getUserIds(){ }public User getOne(){ } |
3.2 表述查詢
如果方法需要通過查詢或篩選的方式獲取某個數據，通常使用“find”/“query”作為其前綴，例如：
|
1
2
3
4
5
6
7
8
9
|
public List<User> findOne(Integer id){ }public List<Integer> findAll(){ }public List<String> queryOrders(){ } |
3.3 表述條件
如果一個方法需要一些條件參數，則可以使用“by”/“with”等字符作為方法名中條件的連接符，例如：
|
1
2
3
4
5
6
7
8
9
|
public User findByUsername(String username){ }public List<Integer> getUserIdsWithState(boolean state){ }public List<User> findAllByUsernameOrderByIdDesc(String username){ } |
3.4 表述設置
如果一個方法是要設置，插入，修改，刪除等操作，應該將對應的動詞(set,insert,update,delete)作為其名詞的前綴，例如：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
public void setName(String name){ }public User insert(User user){ }public void update(User user){ }public void clearAll(){ } |
3.5 其他規范
如果一個方法用于獲取某組數據的長度或數量，則該方法應該使用length或size命名；如果方法的返回值為布爾類型(Boolean)，則該方法應該使用“is”或”has”作為前綴；
如果方法用于將一種類型的數據轉換為另一種數據數類型，則可以使用“to”作為前綴。下面是綜合示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
public long length(){ }public int size(){ }public boolean isOpen(){ }public boolean isNotEmpty(){ }public boolean hasLength(){ }public Set<Integer> mapToSet(Map map){ }public UserDto convertTo(User user){ }public String toString(Object obj){ } |
4. 變量命名規范
變量(Variable)命名包括參數名稱，成員變量和局部變量。變量命名通常以小寫字母開頭，如果變量名由多個單詞構成，則從第二個單詞起首字母需要大寫，在變量命名過程中，不建議使用“_”作為前綴或者單詞之間的分割符號。下面是一些常見的變量命名示例：
|
1
2
3
4
5
6
|
private String nickName;private String mobileNumber;private Long id;private String username;private Long orderId;private Long orderItemId; |
5. 常量命名規范
一般地，常量名稱采用全部大寫的英文單詞書寫，如果常量名稱由多個單詞組成，則單詞之間統一使用“_”進行分割，下面是常量命名示例：
|
1
2
3
4
5
6
|
public static final String LOGIN_USER_SESSION_KEY = "current_login_user";public static final int MAX_AGE_VALUE = 120;public static final int DEFAULT_PAGE_NO = 1;public static final long MAX_PAGE_SIZE = 1000;public static final boolean HAS_LICENSE = false;public static final boolean IS_CHECKED = false; |
6. 枚舉命名規范
枚舉(Enum)類是一種特殊的類，其命名規范遵循普通類的命名約束條件，首字母大寫，采用駝峰命名法；枚舉類中定義的值的名稱遵循常量的命名規范，且枚舉值的名稱需要與類名有一定的關聯性，下面是枚舉的一些示例：
|
1
2
3
4
5
6
|
public enum Color{ RED,YELLOW,BLUE,GREEN,WHITE;}public enum PhysicalSize{ TINY,SMALL,MEDIUM,LARGE,HUGE,GIGANTIC;} |
下面是Oracle Java標準庫中的一個示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
|
public enum ElementType{ TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, ANNOTATION_TYPE, PACKAGE, TYPE_PARAMETER, TYPE_USE;} |
7. 其他命名規范
7.1 數組
在定義數組時，為了便于閱讀，盡量保持以下的書寫規范：
|
1
2
3
4
5
6
7
8
9
10
11
|
int[] array = new int[10];int[] idArray ={1,2,3,4,5};String[] nameArray = {"First","Yellow","Big"}public List<String> getNameById(Integer[] ids){ }public List<String> getNameById(Integer...ids){ } |
7.2 表述復數或者集合
如果一個變量用于描述多個數據時，盡量使用單詞的復數形式進行書寫，例如：
|
1
2
3
|
Collection<Order> orders;int[] values;List<Item> items; |
另外，如果表述的是一個Map數據，則應使用“map”作為其后綴，例如：
|
1
2
|
Map<String,User> userMap;Map<String,List<Object>> listMap; |
7.3 泛型類
在書寫泛型類時，通常做以下的約定：
-
E表示
Element，通常用在集合中； - ID用于表示對象的唯一標識符類型
-
T表示
Type(類型)，通常指代類； -
K表示
Key(鍵),通常用于Map中； -
V表示
Value(值),通常用于Map中，與K結對出現； -
N表示
Number,通常用于表示數值類型； - ？表示不確定的Java類型；
- X用于表示異常；
- U,S表示任意的類型。
下面時泛型類的書寫示例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
public class HashSet<E> extends AbstractSet<E>{ }public class HashMap<K,V> extends AbstractMap<K,V>{ }public class ThreadLocal<T>{ }public interface Functor<T,X extends Throwable>{ T val() throws X;}public class Container<K,V>{ private K key; private V value; Container(K key,V value){ this.key = key; this.value = value; } }public interface BaseRepository<T,ID>{ T findById(ID id); void update(T t); List<T> findByIds(ID...ids);}public static <T> List<T> methodName(Class<T> clz){ List<T> dataList = getByClz(clz); return dataList;} |
7.4 接口實現類
為了便于閱讀，在通常情況下，建議接口實現類使用“Impl作為后綴”，不建議使用大寫的“I”作為接口前綴，下面是接口和接口實現類的書寫示例。
推薦寫法：
|
1
2
3
4
5
6
|
public interface OrderService{ }public class OrderServiceImpl implements OrderService{ } |
不建議的寫法：
|
1
2
3
4
5
6
|
public interface IOrderService{ }public class OrderService implements IOrderService{ } |
7.5 測試類和測試方法
在項目中，測試類采用被測試業務模塊名/被測試接口/被測試類+“Test”的方法進行書寫，測試類中的測試函數采用“test”+用例操作_狀態的組合方式進行書寫，例如：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
public class UserServiceTest{ public void testFindByUsernameAndPassword(){ } public void testUsernameExist_notExist(){ } public void testDeleteById_isOk(){ }} |
8 擴展：速記 Java 開發中的各種O
最后，通過一張表和圖快速對Java中的BO,DTO,DAO,PO,POJO,VO之間的含義，區別以及聯系進行梳理。
| 名稱 | 使用范圍 | 解釋說明 |
|---|---|---|
| BO | 用于Service,Manager,Business等業務相關類的命名 | Business Object業務處理對象，主要作用是把業務邏輯封裝成一個對象。 |
| DTO | 經過加工后的PO對象，其內部屬性可能增加或減少 | Data Transfer Object數據傳輸對象，主要用于遠程調用等需要大量傳輸數據的地方，例如，可以將一個或多個PO類的部分或全部屬性封裝為DTO進行傳輸 |
| DAO | 用于對數據庫進行讀寫操作的類進行命名 | Data Access Object數據訪問對象，主要用來封裝對數據庫的訪問，通過DAO可以將POJO持久化為PO，也可以利用PO封裝出VO和DTO |
| PO | Bean,Entity等類的命名 | Persistant Object持久化對象，數據庫表中的數據在Java對象中的映射狀態，可以簡單的理解為一個PO對象即為數據庫表中的一條記錄 |
| POJO | POJO是DO/DTO/BO/VO的統稱 | Plain Ordinary Java Object 簡單Java對象，它是一個簡單的普通Java對象，禁止將類命名為XxxxPOJO |
| VO | 通常是視圖控制層和模板引擎之間傳遞的數據對象 | Value Object 值對象，主要用于視圖層，視圖控制器將視圖層所需的屬性封裝成一個對象，然后用一個VO對象在視圖控制器和視圖之間進行數據傳輸。 |
| AO | 應用層對象 | Application Object，在Web層與Service層之間抽象的復用對象模型，很少用。 |
下面將通過一張圖來理解上述幾種O之間相互轉換的關系：
到此這篇關于Java 命名規范(非常全面)的文章就介紹到這了,更多相關Java 命名規范內容請搜索服務器之家以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持服務器之家！
原文鏈接：https://segmentfault.com/a/1190000040744977
