一、編程規(guī)約
(一)命名規(guī)約
【強(qiáng)制】 代碼中的命名均不能以下劃線或美元符號開始，也不能以下劃線或美元符號結(jié)束。name / $Object / name / name$ / Object$
【強(qiáng)制】 代碼中的命名嚴(yán)禁使用拼音與英文混合的方式，更不允許直接使用中文的方式。
【強(qiáng)制】類名使用 UpperCamelCase 風(fēng)格，必須遵從駝峰形式，但以下情形例外：（領(lǐng)域模型
【強(qiáng)制】方法名、參數(shù)名、成員變量、局部變量都統(tǒng)一使用 lowerCamelCase 風(fēng)格，必須遵從
【強(qiáng)制】常量命名全部大寫，單詞間用下劃線隔開，力求語義表達(dá)完整清楚，不要嫌名字長。
【強(qiáng)制】抽象類命名使用 Abstract 或 Base 開頭；異常類命名使用 Exception 結(jié)尾；測試類
【強(qiáng)制】中括號是數(shù)組類型的一部分，數(shù)組定義如下：String[] args;
【強(qiáng)制】POJO 類中布爾類型的變量，都不要加 is，否則部分框架解析會引起序列化錯(cuò)誤。
【強(qiáng)制】包名統(tǒng)一使用小寫，點(diǎn)分隔符之間有且僅有一個(gè)自然語義的英語單詞。包名統(tǒng)一使用
【強(qiáng)制】杜絕完全不規(guī)范的縮寫，避免望文不知義。
【推薦】如果使用到了設(shè)計(jì)模式，建議在類名中體現(xiàn)出具體模式。
【推薦】接口類中的方法和屬性不要加任何修飾符號（public 也不要加），保持代碼的簡潔
接口和實(shí)現(xiàn)類的命名有兩套規(guī)則：
【參考】枚舉類名建議帶上 Enum 后綴，枚舉成員名稱需要全大寫，單詞間用下劃線隔開。
【參考】各層命名規(guī)約：
(二)常量定義
【強(qiáng)制】不允許出現(xiàn)任何魔法值（即未經(jīng)定義的常量）直接出現(xiàn)在代碼中。
【強(qiáng)制】long 或者 Long 初始賦值時(shí)，必須使用大寫的 L，不能是小寫的 l，小寫容易跟數(shù)字
【推薦】不要使用一個(gè)常量類維護(hù)所有常量，應(yīng)該按常量功能進(jìn)行歸類，分開維護(hù)。如：緩存
【推薦】常量的復(fù)用層次有五層：跨應(yīng)用共享常量、應(yīng)用內(nèi)共享常量、子工程內(nèi)共享常量、包
【推薦】如果變量值僅在一個(gè)范圍內(nèi)變化用 Enum 類。如果還帶有名稱之外的延伸屬性，必須
(三)格式規(guī)約
【強(qiáng)制】大括號的使用約定。如果是大括號內(nèi)為空，則簡潔地寫成{}即可，不需要換行；如果
【強(qiáng)制】 左括號和后一個(gè)字符之間不出現(xiàn)空格；同樣，右括號和前一個(gè)字符之間也不出現(xiàn)空
【強(qiáng)制】if/for/while/switch/do 等保留字與左右括號之間都必須加空格。
【強(qiáng)制】任何運(yùn)算符左右必須加一個(gè)空格。
【強(qiáng)制】縮進(jìn)采用 4 個(gè)空格，禁止使用 tab 字符。
public static void main(String[] args) {
// 縮進(jìn) 4 個(gè)空格
String say = "hello";
// 運(yùn)算符的左右必須有一個(gè)空格
int flag = 0;
// 關(guān)鍵詞 if 與括號之間必須有一個(gè)空格，括號內(nèi)的 f 與左括號，0 與右括號不需要空格
if (flag == 0) {
System.out.println(say);
}
// 左大括號前加空格且不換行；左大括號后換行
if (flag == 1) {
System.out.println("world");
// 右大括號前換行，右大括號后有 else，不用換行
} else {
System.out.println("ok");
// 在右大括號后直接結(jié)束，則必須換行
}
}
【強(qiáng)制】單行字符數(shù)限制不超過 120 個(gè)，超出需要換行，換行時(shí)遵循如下原則：
【強(qiáng)制】方法參數(shù)在定義和傳入時(shí)，多個(gè)參數(shù)逗號后邊必須加空格。
【強(qiáng)制】IDE 的 text file encoding 設(shè)置為 UTF-8; IDE 中文件的換行符使用 Unix 格式，
【推薦】沒有必要增加若干空格來使某一行的字符與上一行的相應(yīng)字符對齊。
【推薦】方法體內(nèi)的執(zhí)行語句組、變量的定義語句組、不同的業(yè)務(wù)邏輯之間或者不同的語義
(四)OOP 規(guī)約
【強(qiáng)制】避免通過一個(gè)類的對象引用訪問此類的靜態(tài)變量或靜態(tài)方法，無謂增加編譯器解析成
【強(qiáng)制】所有的覆寫方法，必須加@Override 注解。
【強(qiáng)制】相同參數(shù)類型，相同業(yè)務(wù)含義，才可以使用 Java 的可變參數(shù)，避免使用 Object。
【強(qiáng)制】對外暴露的接口簽名，原則上不允許修改方法簽名，避免對接口調(diào)用方產(chǎn)生影響。接
【強(qiáng)制】不能使用過時(shí)的類或方法。
【強(qiáng)制】Object 的 equals 方法容易拋空指針異常，應(yīng)使用常量或確定有值的對象來調(diào)用
【強(qiáng)制】所有的相同類型的包裝類對象之間值的比較，全部使用 equals 方法比較。
【強(qiáng)制】關(guān)于基本數(shù)據(jù)類型與包裝數(shù)據(jù)類型的使用標(biāo)準(zhǔn)如下：
【強(qiáng)制】定義 DO/DTO/VO 等 POJO 類時(shí)，不要設(shè)定任何屬性默認(rèn)值。
【強(qiáng)制】序列化類新增屬性時(shí)，請不要修改 serialVersionUID 字段，避免反序列失?。蝗?br>
果完全不兼容升級，避免反序列化混亂，那么請修改 serialVersionUID 值。
【強(qiáng)制】構(gòu)造方法里面禁止加入任何業(yè)務(wù)邏輯，如果有初始化邏輯，請放在 init 方法中。
【強(qiáng)制】POJO 類必須寫 toString 方法。使用 IDE 的中工具：source> generate toString
【推薦】使用索引訪問用 String 的 split 方法得到的數(shù)組時(shí)，需做最后一個(gè)分隔符后有無
【推薦】當(dāng)一個(gè)類有多個(gè)構(gòu)造方法，或者多個(gè)同名方法，這些方法應(yīng)該按順序放置在一起，
【推薦】 類內(nèi)方法定義順序依次是：公有方法或保護(hù)方法 > 私有方法 > getter/setter
【推薦】setter 方法中，參數(shù)名稱與類成員變量名稱一致，this.成員名=參數(shù)名。在
【推薦】循環(huán)體內(nèi)，字符串的聯(lián)接方式，使用 StringBuilder 的 append 方法進(jìn)行擴(kuò)展。
【推薦】final 可?高程序響應(yīng)效率，聲明成 final 的情況：
【推薦】慎用 Object 的 clone 方法來拷貝對象。
【推薦】類成員與方法訪問控制從嚴(yán)：
【強(qiáng)制】關(guān)于 hashCode 和 equals 的處理，遵循如下規(guī)則：
【強(qiáng)制】ArrayList的subList結(jié)果不可強(qiáng)轉(zhuǎn)成ArrayList，否則會拋出ClassCastException
【強(qiáng)制】 在 subList 場景中，高度注意對原集合元素個(gè)數(shù)的修改，會導(dǎo)致子列表的遍歷、增
【強(qiáng)制】使用集合轉(zhuǎn)數(shù)組的方法，必須使用集合的 toArray(T[] array)，傳入的是類型完全
【強(qiáng)制】使用工具類 Arrays.asList()把數(shù)組轉(zhuǎn)換成集合時(shí)，不能使用其修改集合相關(guān)的方
【強(qiáng)制】泛型通配符<? extends T>來接收返回的數(shù)據(jù)，此寫法的泛型集合不能使用 add 方
【強(qiáng)制】不要在 foreach 循環(huán)里進(jìn)行元素的 remove/add 操作。remove 元素請使用 Iterator
【強(qiáng)制】在 JDK7 版本以上，Comparator 要滿足自反性，傳遞性，對稱性，不然 Arrays.sort，
new Comparator<Student>() {
@Override
public int compare(Student o1, Student o2) {
return o1.getId() > o2.getId() ? 1 : -1;
}
}
【推薦】集合初始化時(shí)，盡量指定集合初始值大小。
【推薦】使用 entrySet 遍歷 Map 類集合 KV，而不是 keySet 方式進(jìn)行遍歷。
【推薦】高度注意 Map 類集合 K/V 能不能存儲 null 值的情況，如下表格：
【參考】合理利用好集合的有序性(sort)和穩(wěn)定性(order)，避免集合的無序性(unsort)和
【參考】利用 Set 元素唯一的特性，可以快速對一個(gè)集合進(jìn)行去重操作，避免使用 List 的
(六)并發(fā)處理
【強(qiáng)制】獲取單例對象需要保證線程安全，其中的方法也要保證線程安全。
【強(qiáng)制】創(chuàng)建線程或線程池時(shí)請指定有意義的線程名稱，方便出錯(cuò)時(shí)回溯。
public class TimerTaskThread extends Thread {
public TimerTaskThread(){
super.setName("TimerTaskThread"); ...
}
【強(qiáng)制】線程資源必須通過線程池?供，不允許在應(yīng)用中自行顯式創(chuàng)建線程。
【強(qiáng)制】線程池不允許使用 Executors 去創(chuàng)建，而是通過 ThreadPoolExecutor 的方式，這樣
【強(qiáng)制】SimpleDateFormat 是線程不安全的類，一般不要定義為 static 變量，如果定義為
【強(qiáng)制】高并發(fā)時(shí)，同步調(diào)用應(yīng)該去考量鎖的性能損耗。能用無鎖數(shù)據(jù)結(jié)構(gòu)，就不要用鎖；能
【強(qiáng)制】對多個(gè)資源、數(shù)據(jù)庫表、對象同時(shí)加鎖時(shí)，需要保持一致的加鎖順序，否則可能會造
【強(qiáng)制】并發(fā)修改同一記錄時(shí)，避免更新丟失，要么在應(yīng)用層加鎖，要么在緩存加鎖，要么在
【強(qiáng)制】多線程并行處理定時(shí)任務(wù)時(shí)，Timer 運(yùn)行多個(gè) TimeTask 時(shí)，只要其中之一沒有捕獲
【推薦】使用 CountDownLatch 進(jìn)行異步轉(zhuǎn)同步操作，每個(gè)線程退出前必須調(diào)用 countDown
【推薦】避免 Random 實(shí)例被多線程使用，雖然共享該實(shí)例是線程安全的，但會因競爭同一
【推薦】通過雙重檢查鎖（double-checked locking）（在并發(fā)場景）實(shí)現(xiàn)延遲初始化的優(yōu)
【參考】volatile 解決多線程內(nèi)存不可見問題。對于一寫多讀，是可以解決變量同步問題，
【參考】 HashMap 在容量不夠進(jìn)行 resize 時(shí)由于高并發(fā)可能出現(xiàn)死鏈，導(dǎo)致 CPU 飆升，在
【參考】ThreadLocal 無法解決共享對象的更新問題，ThreadLocal 對象建議使用 static
(七)控制語句
【強(qiáng)制】在一個(gè) switch 塊內(nèi)，每個(gè) case 要么通過 break/return 等來終止，要么注釋說明程
【強(qiáng)制】在 if/else/for/while/do 語句中必須使用大括號，即使只有一行代碼，避免使用
【推薦】推薦盡量少用 else， if-else 的方式可以改寫成：
【推薦】除常用方法（如 getXxx/isXxx）等外，不要在條件判斷中執(zhí)行其它復(fù)雜的語句，將復(fù)
【推薦】循環(huán)體中的語句要考量性能，以下操作盡量移至循環(huán)體外處理，如定義對象、變量、
【推薦】接口入?yún)⒈Ｗo(hù)，這種場景常見的是用于做批量操作的接口。
【參考】方法中需要進(jìn)行參數(shù)校驗(yàn)的場景：
【參考】方法中不需要參數(shù)校驗(yàn)的場景：
(八)注釋規(guī)約
【強(qiáng)制】類、類屬性、類方法的注釋必須使用 Javadoc 規(guī)范，使用/*內(nèi)容 /格式，不得使用
【強(qiáng)制】所有的抽象方法（包括接口中的方法）必須要用 Javadoc 注釋、除了返回值、參數(shù)、
【強(qiáng)制】所有的類都必須添加創(chuàng)建者信息。
【強(qiáng)制】方法內(nèi)部單行注釋，在被注釋語句上方另起一行，使用//注釋。方法內(nèi)部多行注釋
【強(qiáng)制】所有的枚舉類型字段必須要有注釋，說明每個(gè)數(shù)據(jù)項(xiàng)的用途。
【推薦】與其“半吊子”英文來注釋，不如用中文注釋把問題說清楚。專有名詞與關(guān)鍵字保持
【推薦】代碼修改的同時(shí)，注釋也要進(jìn)行相應(yīng)的修改，尤其是參數(shù)、返回值、異常、核心邏輯
【參考】注釋掉的代碼盡量要配合說明，而不是簡單的注釋掉。
【參考】對于注釋的要求：第一、能夠準(zhǔn)確反應(yīng)設(shè)計(jì)思想和代碼邏輯；第二、能夠?述業(yè)務(wù)含
【參考】好的命名、代碼結(jié)構(gòu)是自解釋的，注釋力求精簡準(zhǔn)確、表達(dá)到位。避免出現(xiàn)注釋的
【參考】特殊注釋標(biāo)記，請注明標(biāo)記人與標(biāo)記時(shí)間。注意及時(shí)處理這些標(biāo)記，通過標(biāo)記掃?，
(九)其它
【強(qiáng)制】在使用正則表達(dá)式時(shí)，利用好其預(yù)編譯功能，可以有效加快正則匹配速度。
【強(qiáng)制】velocity 調(diào)用 POJO 類的屬性時(shí)，建議直接使用屬性名取值即可，模板引擎會自動(dòng)按
【強(qiáng)制】后臺輸送給頁面的變量必須加$!{var}——中間的感嘆號。
【強(qiáng)制】注意 Math.random() 這個(gè)方法返回是 double 類型，注意取值的范圍 0≤x<1（能夠
【強(qiáng)制】獲取當(dāng)前毫秒數(shù) System.currentTimeMillis(); 而不是 new Date().getTime();
【推薦】盡量不要在 velocity 模板中加入變量聲明、邏輯運(yùn)算符，更不要在模板中加入任何
【推薦】任何數(shù)據(jù)結(jié)構(gòu)的構(gòu)造或初始化，都應(yīng)指定大小，避免數(shù)據(jù)結(jié)構(gòu)無限增長吃光內(nèi)存。
【推薦】對于“明確停止使用的代碼和配置”，如方法、變量、類、配置文件、動(dòng)態(tài)配置屬性
二、異常日志
(一)異常處理
【強(qiáng)制】不要捕獲 Java 類庫中定義的繼承自 RuntimeException 的運(yùn)行時(shí)異常類，如：
【強(qiáng)制】異常不要用來做流程控制，條件控制，因?yàn)楫惓５奶幚硇时葪l件分支低。
【強(qiáng)制】對大段代碼進(jìn)行 try-catch，這是不負(fù)責(zé)任的表現(xiàn)。catch 時(shí)請分清穩(wěn)定代碼和非穩(wěn)
【強(qiáng)制】捕獲異常是為了處理它，不要捕獲了卻什么都不處理而拋棄之，如果不想處理它，請
【強(qiáng)制】有 try 塊放到了事務(wù)代碼中，catch 異常后，如果需要回滾事務(wù)，一定要注意手動(dòng)回
【強(qiáng)制】finally 塊必須對資源對象、流對象進(jìn)行關(guān)閉，有異常也要做 try-catch。
【強(qiáng)制】不能在 finally 塊中使用 return，finally 塊中的 return 返回后方法結(jié)束執(zhí)行，不
【強(qiáng)制】捕獲異常與拋異常，必須是完全匹配，或者捕獲異常是拋異常的父類。
【推薦】方法的返回值可以為 null，不強(qiáng)制返回空集合，或者空對象等，必須添加注釋充分
【推薦】防止 NPE，是程序員的基本修養(yǎng)，注意 NPE 產(chǎn)生的場景：
【推薦】在代碼中使用“拋異?！边€是“返回錯(cuò)誤碼”，對于公司外的 http/api 開放接口必須
【推薦】定義時(shí)區(qū)分 unchecked / checked 異常，避免直接使用 RuntimeException 拋出，
【參考】避免出現(xiàn)重復(fù)的代碼（Don’t Repeat Yourself），即 DRY 原則。
(二)日志規(guī)約
【強(qiáng)制】應(yīng)用中不可直接使用日志系統(tǒng)（Log4j、Logback）中的 API，而應(yīng)依賴使用日志框架
【強(qiáng)制】日志文件推薦至少保存 15 天，因?yàn)橛行┊惓＞邆湟浴爸堋睘轭l次發(fā)生的特點(diǎn)。
【強(qiáng)制】應(yīng)用中的擴(kuò)展日志（如打點(diǎn)、臨時(shí)監(jiān)控、訪問日志等）命名方式：
【強(qiáng)制】對 trace/debug/info 級別的日志輸出，必須使用條件輸出形式或者使用占位符的方
【強(qiáng)制】避免重復(fù)打印日志，浪費(fèi)磁盤空間，務(wù)必在 log4j.xml 中設(shè)置 additivity=false。
【強(qiáng)制】異常信息應(yīng)該包括兩類信息：案發(fā)現(xiàn)場信息和異常堆棧信息。如果不處理，那么往上
【推薦】可以使用 warn 日志級別來記錄用戶輸入?yún)?shù)錯(cuò)誤的情況，避免用戶投訴時(shí)，無所適
【推薦】謹(jǐn)慎地記錄日志。生產(chǎn)環(huán)境禁止輸出 debug 日志；有選擇地輸出 info 日志；如果使
三、MySQL 規(guī)約
(一)建表規(guī)約
【強(qiáng)制】表達(dá)是與否概念的字段，必須使用 is_xxx 的方式命名，數(shù)據(jù)類型是 unsigned tinyint
【強(qiáng)制】表名、字段名必須使用小寫字母或數(shù)字；禁止出現(xiàn)數(shù)字開頭，禁止兩個(gè)下劃線中間只
【強(qiáng)制】表名不使用復(fù)數(shù)名詞。
【強(qiáng)制】禁用保留字，如 desc、range、match、delayed 等，請參考 MySQL 官方保留字。
【強(qiáng)制】唯一索引名為 uk_字段名；普通索引名則為 idx_字段名。
【強(qiáng)制】小數(shù)類型為 decimal，禁止使用 float 和 double。
【強(qiáng)制】如果存儲的字符串長度幾乎相等，使用 char 定長字符串類型。
【強(qiáng)制】varchar 是可變長字符串，不預(yù)先分配存儲空間，長度不要超過 5000，如果存儲長
【強(qiáng)制】表必備三字段：id, gmt_create, gmt_modified。
【推薦】表的命名最好是加上“業(yè)務(wù)名稱_表的作用”。
【推薦】庫名與應(yīng)用名稱盡量一致。
【推薦】如果修改字段含義或?qū)ψ侄伪硎镜臓顟B(tài)追加時(shí)，需要及時(shí)更新字段注釋。
【推薦】字段允許適當(dāng)冗余，以?高性能，但是必須考慮數(shù)據(jù)同步的情況。冗余字段應(yīng)遵循：
【推薦】單表行數(shù)超過 500 萬行或者單表容量超過 2GB，才推薦進(jìn)行分庫分表。
【參考】合適的字符存儲長度，不但節(jié)約數(shù)據(jù)庫表空間、節(jié)約索引存儲，更重要的是?升檢
(二)索引規(guī)約
【強(qiáng)制】業(yè)務(wù)上具有唯一特性的字段，即使是組合字段，也必須建成唯一索引。
【強(qiáng)制】 超過三個(gè)表禁止 join。需要 join 的字段，數(shù)據(jù)類型保持絕對一致；多表關(guān)聯(lián)查詢
【強(qiáng)制】在 varchar 字段上建立索引時(shí)，必須指定索引長度，沒必要對全字段建立索引，根據(jù)
【強(qiáng)制】頁面搜索嚴(yán)禁左模糊或者全模糊，如果需要請走搜索引擎來解決。
【推薦】如果有 order by 的場景，請注意利用索引的有序性。order by 最后的字段是組合
【推薦】利用覆蓋索引來進(jìn)行查詢操作，來避免回表操作。
【推薦】利用延遲關(guān)聯(lián)或者子查詢優(yōu)化超多分頁場景。
【推薦】SQL 性能優(yōu)化的目標(biāo)：至少要達(dá)到 range 級別，要求是 ref 級別，如果可以是 consts
【推薦】建組合索引的時(shí)候，區(qū)分度最高的在最左邊。
【參考】創(chuàng)建索引時(shí)避免有如下極端誤解：
(三)SQL 規(guī)約
【強(qiáng)制】不要使用 count(列名)或 count(常量)來替代 count()，count( )就是 SQL92 定義
【強(qiáng)制】count(distinct col) 計(jì)算該列除 NULL 之外的不重復(fù)數(shù)量。注意 count(distinct
【強(qiáng)制】當(dāng)某一列的值全是 NULL 時(shí)，count(col)的返回結(jié)果為 0，但 sum(col)的返回結(jié)果為
【強(qiáng)制】使用 ISNULL()來判斷是否為 NULL 值。注意：NULL 與任何值的直接比較都為 NULL。
【強(qiáng)制】在代碼中寫分頁查詢邏輯時(shí)，若 count 為 0 應(yīng)直接返回，避免執(zhí)行后面的分頁語句。
【強(qiáng)制】不得使用外鍵與級聯(lián)，一切外鍵概念必須在應(yīng)用層解決。
【強(qiáng)制】禁止使用存儲過程，存儲過程難以調(diào)試和擴(kuò)展，更沒有移植性。
【強(qiáng)制】數(shù)據(jù)訂正時(shí)，刪除和修改記錄時(shí)，要先 select，避免出現(xiàn)誤刪除，確認(rèn)無誤才能執(zhí)
【推薦】in 操作能避免則避免，若實(shí)在避免不了，需要仔細(xì)評估 in 后邊的集合元素?cái)?shù)量，控
【參考】如果有全球化需要，所有的字符存儲與表示，均以 utf-8 編碼，那么字符計(jì)數(shù)方法
【參考】TRUNCATE TABLE 比 DELETE 速度快，且使用的系統(tǒng)和事務(wù)日志資源少，但 TRUNCATE
【強(qiáng)制】在表查詢中，一律不要使用 * 作為查詢的字段列表，需要哪些字段必須明確寫明。
【強(qiáng)制】POJO 類的 boolean 屬性不能加 is，而數(shù)據(jù)庫字段必須加 is_，要求在 resultMap 中
【強(qiáng)制】不要用 resultClass 當(dāng)返回參數(shù)，即使所有類屬性名與數(shù)據(jù)庫字段一一對應(yīng)，也需
【強(qiáng)制】xml 配置中參數(shù)注意使用：#{}，#param# 不要使用${} 此種方式容易出現(xiàn) SQL 注
【強(qiáng)制】iBATIS 自帶的 queryForList(String statementName,int start,int size)不推
【強(qiáng)制】不允許直接拿 HashMap 與 Hashtable 作為查詢結(jié)果集的輸出。
【強(qiáng)制】更新數(shù)據(jù)表記錄時(shí)，必須同時(shí)更新記錄對應(yīng)的 gmt_modified 字段值為當(dāng)前時(shí)間。
【推薦】不要寫一個(gè)大而全的數(shù)據(jù)更新接口，傳入為 POJO 類，不管是不是自己的目標(biāo)更新字
【參考】@Transactional 事務(wù)不要濫用。事務(wù)會影響數(shù)據(jù)庫的 QPS，另外使用事務(wù)的地方需
【參考】<isEqual>中的 compareValue 是與屬性值對比的常量，一般是數(shù)字，表示相等時(shí)帶
四、工程規(guī)約
(一)應(yīng)用分層
【推薦】圖中默認(rèn)上層依賴于下層，箭頭關(guān)系表示可直接依賴，如：開放接口層可以依賴于
【參考】 （分層異常處理規(guī)約）在 DAO 層，產(chǎn)生的異常類型有很多，無法用細(xì)粒度異常進(jìn)行
【參考】分層領(lǐng)域模型規(guī)約：
(二)二方庫規(guī)約
【強(qiáng)制】定義 GAV 遵從以下規(guī)則：
【強(qiáng)制】二方庫版本號命名方式：主版本號.次版本號.修訂號
【強(qiáng)制】線上應(yīng)用不要依賴 SNAPSHOT 版本（安全包除外）；正式發(fā)布的類庫必須使用 RELEASE
【強(qiáng)制】二方庫的新增或升級，保持除功能點(diǎn)之外的其它 jar 包仲裁結(jié)果不變。如果有改變，
【強(qiáng)制】二方庫里可以定義枚舉類型，參數(shù)可以使用枚舉類型，但是接口返回值不允許使用枚
【強(qiáng)制】依賴于一個(gè)二方庫群時(shí)，必須定義一個(gè)統(tǒng)一版本變量，避免版本號不一致。
【強(qiáng)制】禁止在子項(xiàng)目的 pom 依賴中出現(xiàn)相同的 GroupId，相同的 ArtifactId，但是不同的
【推薦】所有 pom 文件中的依賴聲明放在<dependencies>語句塊中，所有版本仲裁放在
【推薦】二方庫盡量不要有配置項(xiàng)，最低限度不要再增加配置項(xiàng)。
【參考】為避免應(yīng)用二方庫的依賴沖突問題，二方庫發(fā)布者應(yīng)當(dāng)遵循以下原則：
【推薦】高并發(fā)服務(wù)器建議調(diào)小 TCP 協(xié)議的 time_wait 超時(shí)時(shí)間。
【推薦】調(diào)大服務(wù)器所支持的最大文件句柄數(shù)（File Descriptor，簡寫為 fd）。
【推薦】給 JVM 設(shè)置-XX:+HeapDumpOnOutOfMemoryError 參數(shù)，讓 JVM 碰到 OOM 場景時(shí)輸出
【參考】服務(wù)器內(nèi)部重定向使用 forward；外部重定向地址使用 URL 拼裝工具類來生成，否則
五、安全規(guī)約
【強(qiáng)制】隸屬于用戶個(gè)人的頁面或者功能必須進(jìn)行權(quán)限控制校驗(yàn)。
【強(qiáng)制】用戶敏感數(shù)據(jù)禁止直接展示，必須對展示數(shù)據(jù)脫敏。
【強(qiáng)制】用戶輸入的 SQL 參數(shù)嚴(yán)格使用參數(shù)綁定或者 METADATA 字段值限定，防止 SQL 注入，
【強(qiáng)制】用戶請求傳入的任何參數(shù)必須做有效性驗(yàn)證。
【強(qiáng)制】禁止向 HTML 頁面輸出未經(jīng)安全過濾或未正確轉(zhuǎn)義的用戶數(shù)據(jù)。
【強(qiáng)制】表單、AJAX ?交必須執(zhí)行 CSRF 安全過濾。
【強(qiáng)制】在使用平臺資源，譬如短信、郵件、電話、下單、支付，必須實(shí)現(xiàn)正確的防重放限制，
【推薦】發(fā)貼、評論、發(fā)送即時(shí)消息等用戶生成內(nèi)容的場景必須實(shí)現(xiàn)防刷、文本內(nèi)容違禁詞過
最后編輯于 ：2018.06.28 19:08:44
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
