Java后臺開發(fā)規(guī)范

1.Java編程規(guī)范

1.1.命名風(fēng)格

• 代碼中的命名均不能以下劃線或美元符號開始，也不能以下劃線或美元符號結(jié)束。

• 類名使用 UpperCamelCase 風(fēng)格，必須遵從駝峰形式，但以下情形例外：DO / BO / DTO / VO / AO

• 接口類中的方法和屬性不要加任何修飾符號，保持代碼的簡潔性，并加上有效的 Javadoc 注釋。盡量不要在接口里定義變量，如果一定要定義變量，肯定是與接口方法相關(guān)，并且是整個應(yīng)用的基礎(chǔ)常量。

• Service/DAO 層方法命名規(guī)約

  • 1） 獲取單個對象的方法用 get 做前綴。
  • 2） 獲取多個對象的方法 list 命名。
  • 3） 獲取統(tǒng)計值的方法用 count 做前綴。
  • 3） 分頁的方法用 page 做后綴。
  • 4） 插入的方法用 save 做前綴。
  • 5） 刪除的方法用 delete 做前綴。
  • 6） 修改的方法用 update 做前綴。

• 領(lǐng)域模型命名規(guī)約

  • 1） 數(shù)據(jù)傳輸對象：xxxDTO，xxx 為業(yè)務(wù)領(lǐng)域相關(guān)的名稱。
  • 2） 展示對象：xxxVO，xxx 一般為實體名稱。
  • 3） POJO 是 DO/DTO/BO/VO 的統(tǒng)稱，禁止命名成 xxxPOJO

• 分層領(lǐng)域模型規(guī)約

  • DO(Data Object):與數(shù)據(jù)庫表結(jié)構(gòu)一一對應(yīng)，通過 DAO 層向上傳輸數(shù)據(jù)源對象。
  • DTO(Data Transfer Object):數(shù)據(jù)傳輸對象，Service 或 Manager 向外傳輸?shù)膶ο蟆?/li>
  • BO(Business Object):業(yè)務(wù)對象。由 Service 層輸出的封裝業(yè)務(wù)邏輯的對象。
  • AO(ApplicationObject):應(yīng)用對象。在Web層與Service層之間抽象的復(fù)用對象模型，極為貼近展示層，復(fù)用度不高。
  • VO(View Object):顯示層對象，通常是 Web 向模板渲染引擎層傳輸?shù)膶ο蟆?/li>
  • Query:數(shù)據(jù)查詢對象，各層接收上層的查詢請求。注意超過 2 個參數(shù)的查詢封裝，禁止使用 Map 類來傳輸。

1.2.代碼格式化規(guī)范

每次編輯完一個類后使用idea的格式化功能，格式化代碼和去掉無用導(dǎo)入的包，win快捷鍵為 Ctrl+Alt+l 和 Ctrl+Alt+o，Mac為ctrl+option+o 和 option+command+l。

項目的代碼格式統(tǒng)一為UTF-8。

1.3.API命名規(guī)范

GET（SELECT）：從服務(wù)器取出資源（一項或多項）。

POST（CREATE）：在服務(wù)器新建一個資源。

PUT（UPDATE）：在服務(wù)器更新完整的資源（客戶端提供改變后的完整資源）。

DELETE（DELETE）：從服務(wù)器刪除資源。

基本規(guī)范

• 使用'/'表示層級關(guān)系
• url 不能以'/'結(jié)尾
• url 中不能包含空格
• url 中不能以文件后綴結(jié)尾
• url 中字母小寫，單詞間加下劃線
• 不要再url中添加CRUD

1.4.異常處理規(guī)范

• 異常不要用來做流程控制，條件控制，因為異常的處理效率比條件分支低。

• 對大段代碼進(jìn)行 try-catch，這是不負(fù)責(zé)任的表現(xiàn)。catch 時請分清穩(wěn)定代碼和非穩(wěn) 定代碼，穩(wěn)定代碼指的是無論如何不會出錯的代碼。對于非穩(wěn)定代碼的 catch 盡可能進(jìn)行區(qū)分 異常類型，再做對應(yīng)的異常處理。

• 捕獲異常是為了處理它，不要捕獲了卻什么都不處理而拋棄之，如果不想處理它，請 將該異常拋給它的調(diào)用者。最外層的業(yè)務(wù)使用者，必須處理異常，將其轉(zhuǎn)化為用戶可以理解的 內(nèi)容。

• 有 try 塊放到了事務(wù)代碼中，catch 異常后，如果需要回滾事務(wù)，一定要注意手動回 滾事務(wù)。

• finally 塊必須對資源對象、流對象進(jìn)行關(guān)閉，有異常也要做 try-catch。

• 不能在 finally 塊中使用 return，finally 塊中的 return 返回后方法結(jié)束執(zhí)行，不 會再執(zhí)行 try 塊中的 return 語句。

• 方法的返回值可以為 null，不強制返回空集合，或者空對象等，必須添加注釋充分 說明什么情況下會返回 null 值。調(diào)用方需要進(jìn)行 null 判斷防止 NPE 問題。

1.5.模塊化開發(fā)規(guī)范

模塊化開發(fā)是指公司共有的基礎(chǔ)模塊的開發(fā)如：短信、權(quán)限、支付、公共工具、郵件等。

模塊化開發(fā)的pom模版

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.domain.module</groupId>
    <artifactId>domain-module</artifactId>
    <version>1.0.0.RELEASE</version>

    <dependencies>
        <dependency>
            <groupId>org.apache.shiro</groupId>
            <artifactId>shiro-spring</artifactId>
            <version>1.4.0</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.7.0</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <distributionManagement>
        <repository>
            <id>releases</id>
            <name>Nexus release Repository</name>
            <url>http://192.168.0.110:8081/repository/maven-releases/</url>
        </repository>

        <snapshotRepository>
            <id>snapshots</id>
            <name>Nexus snapshots Repository</name>
            <url>http://192.168.0.110:8081/repository/maven-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>

</project>

• 模塊化定義 GAV 遵從以下規(guī)則:

  • GroupID格式:com.{域名}.業(yè)務(wù)線.[子業(yè)務(wù)線]，最多4級。
  • ArtifactID格式:產(chǎn)品線名-模塊名。語義不重復(fù)不遺漏，先到中央倉庫去查證一下。

• 模塊化命名方式:主版本號.次版本號.修訂號

  • 主版本號:產(chǎn)品方向改變，或者大規(guī)模API不兼容，或者架構(gòu)不兼容升級。
  • 次版本號:保持相對兼容性，增加主要功能特性，影響范圍極小的API不兼容修改。 3) 修訂號:保持完全兼容性，修復(fù)BUG、新增次要功能特性等。

2.前后端對接規(guī)范

• 后端返回格式統(tǒng)一為json格式數(shù)據(jù)。

{"code":20000,"message":"success","data":null}

• 后端返回的code字段，以4開頭則為前端請求有誤，以5開頭則是后端接口問題。2開頭則表示成功。

• 后端返回的message字段表示請求的信息，成功是success，錯誤則會提示相應(yīng)的異常信息或返回error。

• 后端返回的data字段則是本次請求的數(shù)據(jù)，無數(shù)據(jù)則返回null。

• 后端返回的時間格式統(tǒng)一為時間戳

3.數(shù)據(jù)庫設(shè)計規(guī)范

3.1.建表規(guī)約

• 表名、字段名必須使用小寫字母或數(shù)字，禁止出現(xiàn)數(shù)字開頭，禁止兩個下劃線中間只出現(xiàn)數(shù)字。數(shù)據(jù)庫字段名的修改代價很大，因為無法進(jìn)行預(yù)發(fā)布，所以字段名稱需要慎重考慮。

• 表達(dá)是與否概念的字段，必須使用 is_xxx 的方式命名，數(shù)據(jù)類型是 tinyint (1表示是，0表示否)。

• 表名不使用復(fù)數(shù)名詞。

• 禁用保留字，如 desc、range、match、delayed 等，請參考 MySQL 官方保留字。

• 主鍵索引名為 pk_字段名;唯一索引名為 uk_字段名;普通索引名則為 idx_字段名。

• 小數(shù)類型為 decimal，禁止使用 float 和 double。

• 如果存儲的字符串長度幾乎相等，使用 char 定長字符串類型。

• varchar 是可變長字符串，不預(yù)先分配存儲空間，長度不要超過 5000，如果存儲長 度大于此值，定義字段類型為 text，獨立出來一張表，用主鍵來對應(yīng)，避免影響其它字段索 引效率。

• 表必備三字段:id, gmt_create, gmt_modified。

• 表的命名最好是加上"業(yè)務(wù)名稱_表的作用"。

• 庫名與應(yīng)用名稱盡量一致。

• 單表行數(shù)超過 500 萬行或者單表容量超過 2GB，才推薦進(jìn)行分庫分表。

3.2.索引規(guī)約

• 業(yè)務(wù)上具有唯一特性的字段，即使是多個字段的組合，也必須建成唯一索引。

• 超過三個表禁止 join。需要 join 的字段，數(shù)據(jù)類型必須絕對一致;多表關(guān)聯(lián)查詢時，保證被關(guān)聯(lián)的字段需要有索引。

• 在 varchar 字段上建立索引時，必須指定索引長度，沒必要對全字段建立索引，根據(jù)實際文本區(qū)分度決定索引長度即可。

• 如果有 order by 的場景，請注意利用索引的有序性。order by 最后的字段是組合索引的一部分，并且放在索引組合順序的最后，避免出現(xiàn) file_sort 的情況，影響查詢性能。

• 利用覆蓋索引來進(jìn)行查詢操作，避免回表。

• SQL 性能優(yōu)化的目標(biāo):至少要達(dá)到 range 級別，要求是 ref 級別，如果可以是 consts 最好。

• 建組合索引的時候，區(qū)分度最高的在最左邊。

3.3.SQL 語句

• 不要使用 count(列名)或 count(常量)來替代 count()，count()是 SQL92 定義的 標(biāo)準(zhǔn)統(tǒng)計行數(shù)的語法，跟數(shù)據(jù)庫無關(guān)，跟 NULL 和非 NULL 無關(guān)。

• count(distinct col) 計算該列除 NULL 之外的不重復(fù)行數(shù)，注意 count(distinct col1, col2) 如果其中一列全為NULL，那么即使另一列有不同的值，也返回為0。

• 當(dāng)某一列的值全是 NULL 時，count(col)的返回結(jié)果為 0，但 sum(col)的返回結(jié)果為 NULL，因此使用 sum()時需注意 NPE 問題。

• 使用 ISNULL()來判斷是否為 NULL 值。

• 在代碼中寫分頁查詢邏輯時，若 count 為 0 應(yīng)直接返回，避免執(zhí)行后面的分頁語句。

• 不得使用外鍵與級聯(lián)，一切外鍵概念必須在應(yīng)用層解決。

• 禁止使用存儲過程，存儲過程難以調(diào)試和擴展，更沒有移植性。

• 數(shù)據(jù)訂正時，刪除和修改記錄時，要先 select，避免出現(xiàn)誤刪除，確認(rèn)無誤才能執(zhí)行更新語句。

• in 操作能避免則避免，若實在避免不了，需要仔細(xì)評估 in 后邊的集合元素數(shù)量，控制在 1000 個之內(nèi)

• 如果有全球化需要，所有的字符存儲與表示，均以 utf-8 編碼，注意字符統(tǒng)計函數(shù)的區(qū)別。

• TRUNCATE TABLE 比 DELETE 速度快，且使用的系統(tǒng)和事務(wù)日志資源少，但 TRUNCATE 無事務(wù)且不觸發(fā) trigger，有可能造成事故，故不建議在開發(fā)代碼中使用此語句。

3.4.ORM 映射

• 在表查詢中，一律不要使用 * 作為查詢的字段列表，需要哪些字段必須明確寫明。

• POJO 類的布爾屬性不能加 is，而數(shù)據(jù)庫字段必須加 is_，要求在 resultMap 中進(jìn)行 字段與屬性之間的映射。

• 不要用 resultClass 當(dāng)返回參數(shù)，即使所有類屬性名與數(shù)據(jù)庫字段一一對應(yīng)，也需 要定義;反過來，每一個表也必然有一個與之對應(yīng)。

• sql.xml 配置參數(shù)使用:#{}，#param# 不要使用${} 此種方式容易出現(xiàn) SQL 注入。

• 不允許直接拿 HashMap 與 Hashtable 作為查詢結(jié)果集的輸出。

• 更新數(shù)據(jù)表記錄時，必須同時更新記錄對應(yīng)的 gmt_modified 字段值為當(dāng)前時間。

• 不要寫一個大而全的數(shù)據(jù)更新接口。傳入為 POJO 類，不管是不是自己的目標(biāo)更新字 段，都進(jìn)行 update table set c1=value1,c2=value2,c3=value3; 這是不對的。執(zhí)行 SQL 時，不要更新無改動的字段，一是易出錯;二是效率低;三是增加 binlog 存儲。

• @Transactional 事務(wù)不要濫用。事務(wù)會影響數(shù)據(jù)庫的 QPS，另外使用事務(wù)的地方需 要考慮各方面的回滾方案，包括緩存回滾、搜索引擎回滾、消息補償、統(tǒng)計修正等。

4.服務(wù)部署規(guī)范

• 在線上生產(chǎn)環(huán)境，JVM的Xms和Xmx設(shè)置一樣大小的內(nèi)存容量，避免在GC 后調(diào)整堆 大小帶來的壓力。

• 給 JVM 設(shè)置-XX:+HeapDumpOnOutOfMemoryError 參數(shù)，讓 JVM 碰到 OOM 場景時輸出 dump 信息。

參考：阿里巴巴Java開發(fā)手冊