提交可参考的java依赖包管理文件和git过滤

.gitignore

@@ -1,3 +1,41 @@
+######################################################################
+# Build Tools
+
+.gradle
+/build/
+!gradle/wrapper/gradle-wrapper.jar
+
+target/
+!.mvn/wrapper/maven-wrapper.jar
+
+######################################################################
+# IDE
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### JRebel ###
+rebel.xml
+
+### NetBeans ###
+nbproject/private/
+build/*
+nbbuild/
+dist/
+nbdist/
+.nb-gradle/
+
 # ---> Java
 *.class
 
@@ -12,3 +50,13 @@
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
 
+######################################################################
+# Others
+*.log
+*.xml.versionsBackup
+*.swp
+.flattened-pom.xml
+
+!*/build/*.java
+!*/build/*.html
+!*/build/*.xml

doc/阿里巴巴代码规范.pdf

@@ -0,0 +1,3055 @@
+            前言
+
+Java 开发手册 是 里巴巴 团技术团 的 体智 结晶和经 总结，经历了多次大规模
+
+线实战的检 及不断完善，公开到业界后，众多社区开发者 跃参与，共同打 完善，系统化地整理
+
+成册，当前的版本是 山版 现代软件行业的 速发展对开发者的综合素质要求越来越 ，因为不仅
+
+是编程知识点，其它维度的知识点也会影响到软件的最终交付质量 比如：五花八 的错误码人为地
+
+增加排查 的 度；数据库的表结构和索引设计缺 带来的系统架构缺 或性能 ；工程结构混
+
+乱导致后续 目维护艰 ；没有鉴权的漏洞代码易被 客攻击等等 所以本手册以 Java 开发者为中
+
+心视角，划分为编程规约 异常日志 单元测试 安全规约 MySQL 数据库 工程结构 设计规约
+
+七个维度，再根据内容特征，细分成若干二级子目录 另外，依据约束力强弱及故 敏感性，规约依
+
+次分为 强制  推荐  参考 三大类 在延伸信息中，“说明”对规约做了适当扩展和解释；
+
+“正例”提 什么样的编码和实现方式；“反例”说明 要提 的 区，以及真实的错误案例
+
+       手册的愿景是码出 效，码出质 现代软件架构的复杂性 要协同开发完成，如何 效地协
+同 ？无规矩不成方圆，无规范 以协同，比如，制订交通法规表 上是要 制行车权，实 上是保
+
+   公众的人身安全，试想如果没有 速，没有红绿灯，谁还敢上路行 ？对软件来说，适当的规范和
+标准绝不是消灭代码内容的创造性 优 性，而是 制过度个性化，以 种普遍认可的统 方式 起
+做事，提升协作效率， 低 通成本 代码的字里行 流 的是软件系统的血 ，质量的提升是尽可
+能少踩 ， 绝踩重复的 ，切实提升系统稳定性，码出质量
+
+       我们已经在 2017 杭州云 大会上发布了配套的 Java 开发规约 IDE 插件，下载量达到 162 万人
+次， 里云效也 成了代码规约扫描引擎 次年，发布 36 万字的配套详解图书 码出 效 ，本书
+
+   持“图胜于表，表胜于言”的理念，深入浅出地将计算机基础 向对象思想 JVM 探源 数据
+结构与 合 并发与多线程 单元测试等知识客观 立体地呈现出来 紧扣学以致用 学以精进的目
+标，结合 里巴巴实践经 和故 案例，与底层源码解析 会贯通， 道来 码出 效 和 Java
+开发手册 稿费所得收入均捐赠公益事情，希望用技术情怀帮助更多的人
+                              目录
+
+      编程规约 ................................................................................................................................................... 1
+      ( ) 命名 格..........................................................................................................................................1
+      (二) 常量定义 .......................................................................................................................................... 4
+      (三) 代码格式 .......................................................................................................................................... 5
+      (四) OOP 规约 ........................................................................................................................................7
+      (五) 日期时 ........................................................................................................................................11
+      (六) 合处理 ........................................................................................................................................12
+      (七) 并发处理 ........................................................................................................................................17
+      (八) 控制语句 ........................................................................................................................................20
+      (九) 注释规约 ........................................................................................................................................24
+      (十) 前后端规约 ....................................................................................................................................25
+      (十 ) 其他.............................................................................................................................................27
+二 异常日志 .................................................................................................................................................29
+      ( ) 错误码............................................................................................................................................29
+      (二) 异常处理 ........................................................................................................................................30
+      (三) 日志规约 ........................................................................................................................................32
+三 单元测试 .................................................................................................................................................35
+四 安全规约 .................................................................................................................................................37
+五 MySQL 数据库.......................................................................................................................................38
+      ( ) 建表规约........................................................................................................................................38
+      (二) 索引规约 ........................................................................................................................................39
+      (三) SQL 语句 .......................................................................................................................................41
+      (四) ORM 映射 .....................................................................................................................................42
+六 工程结构 .................................................................................................................................................44
+      ( ) 应用分层........................................................................................................................................44
+      (二) 二方库依赖 ....................................................................................................................................45
+      (三) 服务器 ............................................................................................................................................46
+七 设计规约 .................................................................................................................................................48
+   1：版本历史 ..............................................................................................................................................51
+   2：专有名词解释 ......................................................................................................................................53
+   3：错误码列表 ..........................................................................................................................................54
+
+                                        （注：浏览时请使用 PDF 左侧导航栏）
+             Java 开发手册
+
+版本号     制定团  更新日期                                          备注
+ 1.7.0                                山版， 次发布前后端规约
+        里巴巴与全球 Java 社区开发者 2020.08.03
+
+       编程规约
+
+( ) 命名 格
+
+    1. 强制 代码中的命名均不能以下划线或美元符号开始，也不能以下划线或美元符号结束
+
+          反例：_name / __name / $name / name_ / name$ / name__
+
+    2. 强制 所有编程相关的命名严禁使用拼 与英文混合的方式，更不允许直接使用中文的方式
+
+          说明：正确的英文拼写和语法可以让 读者易于理解，避免歧义 注意，纯拼 命名方式更要避免采用
+          正例：ali / alibaba / taobao / cainiao/ aliyun/ youku / hangzhou 等国 通用的名称，可视同英文
+          反例：DaZhePromotion [打折] / getPingfenByName() [评分] / String fw[福 ] / int 某变量 = 3
+
+    3. 强制 代码和注释中都要避免使用任何语言的种族歧视性词语
+
+          正例：日本人 / 印度人 / blockList / allowList / secondary
+          反例：RIBENGUIZI / Asan / blackList / whiteList / slave
+
+    4. 强制 类名使用 UpperCamelCase 格，但以下情形例外：DO / BO / DTO / VO / AO /
+         PO / UID 等
+
+          正例：ForceCode / UserDO / HtmlDTO / XmlService / TcpUdpDeal / TaPromotion
+          反例：forcecode / UserDo / HTMLDto / XMLService / TCPUDPDeal / TAPromotion
+
+    5. 强制 方法名 参数名 成员变量 局部变量都统 使用 lowerCamelCase 格
+
+          正例： localValue / getHttpMessage() / inputUserId
+
+    6. 强制 常量命名全部大写，单词 用下划线 开，力求语义表达完整清楚，不要 名字
+
+          正例：MAX_STOCK_COUNT / CACHE_EXPIRED_TIME
+          反例：MAX_COUNT / EXPIRED_TIME
+
+    7. 强制 抽象类命名使用 Abstract 或 Base 开头；异常类命名使用 Exception 结尾；测试类
+         命名以它要测试的类的名称开始，以 Test 结尾
+
+    8. 强制 类型与中括号紧 相连来表示数组
+
+          正例：定义整形数组 int[] arrayDemo
+          反例：在 main 参数中，使用 String args[]来定义
+
+    9. 强制 POJO 类中的任何布尔类型的变量，都不要加 is 前缀，否则部分框架解析会引起序列
+         化错误
+
+                                                                                                                                                                           1/59
+                                                                        Java 开发手册
+
+     说明：在本文 MySQL 规约中的建表约定第 条，表达是与否的变量采用 is_xxx 的命名方式，所以， 要
+     在<resultMap>设置从 is_xxx 到 xxx 的映射关系
+     反例：定义为基本数据类型 Boolean isDeleted 的属性，它的方法也是 isDeleted()，框架在反向解析的时
+     候，“误以为”对应的属性名称是 deleted，导致属性获取不到，进而抛出异常
+
+10. 强制 包名统 使用小写，点分 符之 有且仅有 个自然语义的英语单词 包名统 使用
+    单数形式，但是类名如果有复数含义，类名可以使用复数形式
+
+     正例：应用工具类包名为 com.alibaba.ei.kunlun.aap.util 类名为 MessageUtils（此规则参考 spring 的
+     框架结构）
+
+11. 强制 避免在子父类的成员变量之 或者不同代码块的局部变量之 采用完全相同的命名，
+    使可理解性 低
+
+     说明：子类 父类成员变量名相同，即使是 public 类型的变量也能够通过编译，另外，局部变量在同 方
+     法内的不同代码块中同名也是合法的，这些情况都要避免 对于 setter/getter 的参数名称也要避免与成
+     员变量名称相同
+     反例：
+
+          public class ConfusingName {
+                public int stock;
+
+                // setter/getter 的参数名称，不允许与本类成员变量同名
+                public void get(String alibaba) {
+
+                      if (condition) {
+                            final int money = 666;
+                            // ...
+
+                      }
+
+                      for (int i = 0; i < 10; i++) {
+                            // 在同 方法体中，不允许与其它代码块中的 money 命名相同
+                            final int money = 15978;
+                            // ...
+
+                      }
+                }
+          }
+
+          class Son extends ConfusingName {
+                // 不允许与父类的成员变量名称相同
+                public int stock;
+
+          }
+
+12. 强制 绝完全不规范的缩写，避免望文不知义
+
+     反例：AbstractClass“缩写”成 AbsClass；condition“缩写”成 condi；Function 缩写”成 Fu，此类
+        意缩写严重 低了代码的可 读性
+
+13. 推荐 为了达到代码自解释的目标，任何自定义编程元素在命名时，使用尽量完整的单词组
+    合来表达
+
+                                                                                                                                                                     2/59
+                                                                        Java 开发手册
+
+     正例：对某个对象引用的 volatile 字段进行原子更新的类名为 AtomicReferenceFieldUpdater
+     反例：常见的方法内变量为 int a;的定义方式
+
+14. 推荐 在常量与变量的命名时，表示类型的名词放在词尾，以提升辨识度
+
+     正例：startTime / workQueue / nameList / TERMINATED_THREAD_COUNT
+     反例：startedAt / QueueOfWork / listName / COUNT_TERMINATED_THREAD
+
+15. 推荐 如果模块 接口 类 方法使用了设计模式，在命名时 体现出具体模式
+
+     说明：将设计模式体现在名字中，有利于 读者快速理解架构设计理念
+     正例： public class OrderFactory;
+
+               public class LoginProxy;
+               public class ResourceObserver;
+
+16. 推荐 接口类中的方法和属性不要加任何修 符号（public 也不要加），保持代码的简洁
+    性，并加上有效的 Javadoc 注释 尽量不要在接口里定义变量，如果 定要定义变量，确定
+    与接口方法相关，并且是整个应用的基础常量
+
+     正例：接口方法签名 void commit();
+              接口基础常量 String COMPANY = "alibaba";
+
+     反例：接口方法定义 public abstract void f();
+     说明：JDK8 中接口允许有 认实现，那么这个 default 方法，是对所有实现类都有价值的 认实现
+
+17. 接口和实现类的命名有两套规则：
+
+      1） 强制 对于 Service 和 DAO 类，基于 SOA 的理念，暴 出来的服务 定是接口，内部的实现类用
+     Impl 的后缀与接口区别
+     正例：CacheServiceImpl 实现 CacheService 接口
+      2） 推荐 如果是形容能力的接口名称，取对应的形容词为接口名（通常是–able 的形容词）
+     正例：AbstractTranslator 实现 Translatable 接口
+
+18. 参考 枚举类名带上 Enum 后缀，枚举成员名称 要全大写，单词 用下划线 开
+
+     说明：枚举其实就是特殊的常量类，且构造方法被 认强制是私有
+     正例：枚举名字为 ProcessStatusEnum 的成员名称：SUCCESS / UNKNOWN_REASON
+
+19. 参考 各层命名规约：
+
+     A) Service/DAO 层方法命名规约
+        1） 获取单个对象的方法用 get 做前缀
+        2） 获取多个对象的方法用 list 做前缀，复数结尾，如：listObjects
+        3） 获取统计值的方法用 count 做前缀
+        4） 插入的方法用 save/insert 做前缀
+        5） 删 的方法用 remove/delete 做前缀
+        6） 修改的方法用 update 做前缀
+
+     B) 域模型命名规约
+
+                                                                                                                                                                    3/59
+                                                                              Java 开发手册
+
+             1） 数据对象：xxxDO，xxx 即为数据表名
+             2） 数据传输对象：xxxDTO，xxx 为业务 域相关的名称
+             3） 展示对象：xxxVO，xxx 般为网 名称
+             4） POJO 是 DO/DTO/BO/VO 的统称，禁止命名成 xxxPOJO
+
+(二) 常量定义
+
+    1. 强制 不允许任何 法值（即未经 先定义的常量）直接出现在代码中
+
+           反例：
+
+                // 本例中，开发者 A 定义了缓存的 key，然后开发者 B 使用缓存时少了下划线，即 key 是"Id#taobao"+tradeId，导致
+                出现故
+                String key = "Id#taobao_" + tradeId;
+                cache.put(key, value);
+
+    2. 强制 在 long 或者 Long 赋值时，数值后使用大写字母 L，不能是小写字母 l，小写容易跟
+         数字混淆，造成误解
+
+          说明：Long a = 2l; 写的是数字的 21，还是 Long 型的 2？
+
+    3. 推荐 不要使用 个常量类维护所有常量，要按常量功能进行归类，分开维护
+
+          说明：大而全的常量类，杂乱无章，使用查找功能才能定位到修改的常量，不利于理解，也不利于维护
+          正例：缓存相关常量放在类 CacheConsts 下；系统配置相关常量放在类 SystemConfigConsts 下
+
+    4. 推荐 常量的复用层次有五层：跨应用共享常量 应用内共享常量 子工程内共享常量 包
+         内共享常量 类内共享常量
+
+           1） 跨应用共享常量：放置在二方库中，通常是 client.jar 中的 constant 目录下
+           2） 应用内共享常量：放置在 方库中，通常是子模块中的 constant 目录下
+           反例：易懂变量也要统 定义成应用内共享常量，两位工程师在两个类中分别定义了“YES”的变量：
+
+                类 A 中：public static final String YES = "yes";
+                类 B 中：public static final String YES = "y";
+                A.YES.equals(B.YES)， 期是 true，但实 返回为 false，导致线上
+           3） 子工程内部共享常量：即在当前子工程的 constant 目录下
+           4） 包内共享常量：即在当前包下单独的 constant 目录下
+           5） 类内共享常量：直接在类内部 private static final 定义
+
+    5. 推荐 如果变量值仅在 个固定范围内变化用 enum 类型来定义
+
+          说明：如果存在名称之外的延伸属性应使用 enum 类型，下 正例中的数字就是延伸信息，表示 年中的
+          第几个季节
+          正例：
+
+                public enum SeasonEnum {
+                      SPRING(1), SUMMER(2), AUTUMN(3), WINTER(4);
+                      private int seq;
+                      SeasonEnum(int seq) {
+
+                                                                                                                                                                           4/59
+                             Java 开发手册
+
+            this.seq = seq;
+      }
+      public int getSeq() {
+
+            return seq;
+      }
+}
+
+(三) 代码格式
+
+1. 强制 如果是大括号内为空，则简洁地写成{}即可，大括号中 无 换行和空格；如果是
+    空代码块则：
+
+      1） 左大括号前不换行
+      2） 左大括号后换行
+      3） 右大括号前换行
+      4） 右大括号后还有 else 等代码则不换行；表示终止的右大括号后必 换行
+
+2. 强制 左小括号和右边相邻字符之 不出现空格；右小括号和左边相邻字符之 也不出现空
+    格；而左大括号前 要加空格 详见第 5 条下方正例提示
+
+     反例：if (空格 a == b 空格)
+
+3. 强制 if/for/while/switch/do 等保留字与括号之 都必 加空格
+
+4. 强制 任何二目 三目运算符的左右两边都 要加 个空格
+
+     说明：包括赋值运算符= 逻辑运算符&& 加减乘 符号等
+
+5. 强制 采用 4 个空格缩进，禁止使用 Tab 字符
+
+     说明：如果使用 Tab 缩进，必 设置 1 个 Tab 为 4 个空格 IDEA 设置 Tab 为 4 个空格时，请勿勾选 Use
+     tab character；而在 Eclipse 中，必 勾选 insert spaces for tabs
+     正例： （涉及 1-5 点）
+
+public static void main(String[] args) {          要空格
+      // 缩进 4 个空格
+      String say = "hello";
+      // 运算符的左右必 有 个空格
+      int flag = 0;
+      // 关 词 if 与括号之 必 有 个空格，括号内的 f 与左括号，0 与右括号不
+      if (flag == 0) {
+            System.out.println(say);
+      }
+      // 左大括号前加空格且不换行；左大括号后换行
+      if (flag == 1) {
+            System.out.println("world");
+            // 右大括号前换行，右大括号后有 else，不用换行
+      } else {
+            System.out.println("ok");
+            // 在右大括号后直接结束，则必 换行
+      }
+
+}
+
+                                                       5/59
+                                                                        Java 开发手册
+
+6. 强制 注释的双斜线与注释内容之 有且仅有 个空格
+
+     正例：
+
+          // 这是示例注释，请注意在双斜线之后有 个空格
+          String commentString = new String();
+
+7. 强制 在进行类型强制转换时，右括号与强制转换值之 不 要任何空格 开
+
+     正例：
+
+          double first = 3.2d;
+          int second = (int)first + 2;
+
+8. 强制 单行字符数 制不超过 120 个，超出 要换行，换行时遵循如下原则：
+
+      1）第二行相对第 行缩进 4 个空格，从第三行开始，不再继续缩进，参考示例
+      2）运算符与下文 起换行
+      3）方法调用的点符号与下文 起换行
+      4）方法调用中的多个参数 要换行时，在逗号后进行
+      5）在括号前不要换行，见反例
+
+正例：
+
+StringBuilder sb = new StringBuilder();  起换行
+// 超过 120 个字符的情况下，换行缩进 4 个空格，并且方法前的点号
+sb.append("yang").append("hao")...
+
+            .append("chen")...
+            .append("chen")...
+            .append("chen");
+
+反例：
+
+StringBuilder sb = new StringBuilder();
+// 超过 120 个字符的情况下，不要在括号前换行
+sb.append("you").append("are")...append
+
+      ("lucky");
+
+// 参数很多的方法调用可能超过 120 个字符，逗号后才是换行处
+method(args1, args2, args3, ...
+
+      , argsX);
+
+9. 强制 方法参数在定义和传入时，多个参数逗号后 必 加空格
+
+     正例：下例中实参的 args1，后边必 要有 个空格
+
+                  method(args1, args2, args3);
+
+10. 强制 IDE 的 text file encoding 设置为 UTF-8; IDE 中文件的换行符使用 Unix 格式，不要
+    使用 Windows 格式
+
+11. 推荐 单个方法的总行数不超过 80 行
+
+     说明： 注释之外的方法签名 左右大括号 方法内代码 空行 回车及任何不可见字符的总行数不超过
+     80 行
+     正例：代码逻辑分清红花和绿叶，个性和共性，绿叶逻辑单独出来成为 外方法，使主干代码更加清晰；共
+     性逻辑抽取成为共性方法，便于复用和维护
+
+                                                                                   6/59
+                                                                        Java 开发手册
+
+12. 推荐 没有必要增加若干空格来使变量的赋值等号与上 行对应位置的等号对
+
+     正例：
+
+          int one = 1;
+          long two = 2L;
+          float three = 3F;
+          StringBuilder sb = new StringBuilder();
+
+     说明：增加 sb 这个变量，如果 要对 ，则给 one two three 都要增加几个空格，在变量比较多的情
+     况下，是 常累 的事情
+
+13. 推荐 不同逻辑 不同语义 不同业务的代码之 插入 个空行分 开来以提升可读性
+
+     说明：任何情形，没有必要插入多个空行进行 开
+
+(四) OOP 规约
+
+1. 强制 避免通过 个类的对象引用访 此类的 态变量或 态方法，无谓增加编译器解析成
+    本，直接用类名来访 即可
+
+2. 强制 所有的覆写方法，必 加@Override 注解
+
+说明：getObject()与 get0bject()的  个是字母的 O， 个是数字的 0，加@Override 可以准确判
+
+断是否覆盖成功 另外，如果在抽象类中对方法签名进行修改，其实现类会 上编译报错
+
+3. 强制 相同参数类型，相同业务含义，才可以使用 Java 的可变参数，避免使用 Object
+
+     说明：可变参数必 放置在参数列表的最后 （建议开发者尽量不用可变参数编程）
+     正例：public List<User> listUsers(String type, Long... ids) {...}
+
+4. 强制 外部正在调用或者二方库依赖的接口，不允许修改方法签名，避免对接口调用方产生
+    影响 接口过时必 加@Deprecated 注解，并清晰地说明采用的新接口或者新服务是什么
+
+5. 强制 不能使用过时的类或方法
+
+     说明：java.net.URLDecoder 中的方法 decode(String encodeStr) 这个方法已经过时，应该使用双参数
+     decode(String source, String encode) 接口提供方既然明确是过时接口，那么有义务同时提供新的接口；
+     作为调用方来说，有义务去考证过时方法的新实现是什么
+
+6. 强制 Object 的 equals 方法容易抛空指针异常，应使用常量或确定有值的对象来调用 equals
+
+     正例："test".equals(object);
+     反例：object.equals("test");
+     说明：推荐使用 JDK7 引入的工具类 java.util.Objects#equals(Object a, Object b)
+
+7. 强制 所有整型包装类对象之 值的比较，全部使用 equals 方法比较
+
+     说明：对于 Integer var = ? 在-128 至 127 之 的赋值，Integer 对象是在 IntegerCache.cache 产生，
+     会复用已有对象，这个区 内的 Integer 值可以直接使用==进行判断，但是这个区 之外的所有数据，都
+     会在堆上产生，并不会复用已有对象，这是 个大 ，推荐使用 equals 方法进行判断
+
+                                                                     7/59
+                                                                        Java 开发手册
+
+8. 强制 任何货币金 ，均以最小货币单位且整型类型来进行存储
+
+9. 强制 浮点数之 的等值判断，基本数据类型不能用==来比较，包装数据类型不能用 equals
+    来判断
+
+     说明：浮点数采用“尾数+ 码”的编码方式，类似于科学计数法的“有效数字+指数”的表示方式 二进
+     制无法精确表示大部分的十进制小数，具体原理参考 码出 效
+     反例：
+
+          float a = 1.0F - 0.9F;
+          float b = 0.9F - 0.8F;
+
+          if (a == b) {
+                // 期进入此代码块，执行其它业务逻辑
+                // 但事实上 a==b 的结果为 false
+
+          }
+
+          Float x = Float.valueOf(a);
+          Float y = Float.valueOf(b);
+          if (x.equals(y)) {
+
+                // 期进入此代码块，执行其它业务逻辑
+                // 但事实上 equals 的结果为 false
+          }
+
+     正例：
+
+      (1) 指定 个误差范围，两个浮点数的差值在此范围之内，则认为是相等的
+          float a = 1.0F - 0.9F;
+          float b = 0.9F - 0.8F;
+          float diff = 1e-6F;
+
+          if (Math.abs(a - b) < diff) {
+                System.out.println("true");
+
+          }
+       (2) 使用 BigDecimal 来定义值，再进行浮点数的运算操作
+
+          BigDecimal a = new BigDecimal("1.0");
+          BigDecimal b = new BigDecimal("0.9");
+          BigDecimal c = new BigDecimal("0.8");
+
+          BigDecimal x = a.subtract(b);
+          BigDecimal y = b.subtract(c);
+
+          if (x.compareTo(y) == 0) {
+                System.out.println("true");
+
+          }
+
+10. 强制 如上所示 BigDecimal 的等值比较应使用 compareTo()方法，而不是 equals()方法
+
+     说明：equals()方法会比较值和精度（1.0 与 1.00 返回结果为 false），而 compareTo()则会忽略精度
+
+11. 强制 定义数据对象 DO 类时，属性类型要与数据库字段类型相匹配
+
+     正例：数据库字段的 bigint 必 与类属性的 Long 类型相对应
+     反例：某个案例的数据库表 id 字段定义类型 bigint unsigned，实 类对象属性为 Integer， 着 id 越来
+     越大，超过 Integer 的表示范围而溢出成为负数
+
+                                                                                                                                                                     8/59
+                   Java 开发手册
+
+12. 强制 禁止使用构造方法 BigDecimal(double)的方式把 double 值转化为 BigDecimal 对象
+
+     说明：BigDecimal(double)存在精度损失 ，在精确计算或值比较的场景中可能会导致业务逻辑异常
+
+如：BigDecimal g = new BigDecimal(0.1F); 实 的存储值为：0.10000000149
+
+正例：优先推荐入参为 String 的构造方法，或使用 BigDecimal 的 valueOf 方法，此方法内部其实执行了
+
+Double 的 toString，而 Double 的 toString 按 double 的实 能表达的精度对尾数进行了截断
+
+      BigDecimal recommend1 = new BigDecimal("0.1");
+      BigDecimal recommend2 = BigDecimal.valueOf(0.1);
+
+13. 关于基本数据类型与包装数据类型的使用标准如下：
+
+      1） 强制 所有的 POJO 类属性必 使用包装数据类型
+      2） 强制 RPC 方法的返回值和参数必 使用包装数据类型
+
+ 3） 推荐 所有的局部变量使用基本数据类型                                            ，或
+说明：POJO 类属性没有初值是提醒使用者在 要使用时，必 自己显式地进行赋值，任何 NPE
+
+者入库检查，都由使用者来保证
+
+正例：数据库的查询结果可能是 null，因为自动拆箱，用基本数据类型接收有 NPE
+
+反例：某业务的交易报表上显示成交总  情况，即正负 x%，x 为基本数据类型，调用的 RPC 服务，调
+
+用不成功时，返回的是 认值， 显示为 0%，这是不合理的，应该显示成中划线- 所以包装数据类型
+的 null 值，能够表示 外的信息，如：远程调用失败，异常退出
+
+14. 强制 定义 DO/DTO/VO 等 POJO 类时，不要设定任何属性 认值
+
+     反例：POJO 类的 createTime 认值为 new Date()，但是这个属性在数据提取时并没有置入具体值，在
+     更新其它字段时又 带更新了此字段，导致创建时 被修改成当前时
+
+15. 强制 序列化类新增属性时，请不要修改 serialVersionUID 字段，避免反序列失败；如果
+    完全不兼容升级，避免反序列化混乱，那么请修改 serialVersionUID 值
+
+     说明：注意 serialVersionUID 不 致会抛出序列化运行时异常
+
+16. 强制 构造方法里 禁止加入任何业务逻辑，如果有初始化逻辑，请放在 init 方法中
+
+17. 强制 POJO 类必 写 toString 方法 使用 IDE 中的工具：source> generate toString
+    时，如果继承了另 个 POJO 类，注意在前 加 下 super.toString
+
+     说明：在方法执行抛出异常时，可以直接调用 POJO 的 toString()方法打印其属性值，便于排查
+
+18. 强制 禁止在 POJO 类中，同时存在对应属性 xxx 的 isXxx()和 getXxx()方法
+
+     说明：框架在调用属性 xxx 的提取方法时，并不能确定哪个方法 定是被优先调用到的
+
+19. 推荐 使用索引访 用 String 的 split 方法得到的数组时， 做最后 个分 符后有无内容
+
+    的检查，否则会有抛 IndexOutOfBoundsException 的
+
+     说明：
+
+          String str = "a,b,c,,";
+          String[] ary = str.split(",");
+          // 期大于 3，结果是 3
+          System.out.println(ary.length);
+
+                                                                  9/59
+                                                                        Java 开发手册
+
+20. 推荐 当 个类有多个构造方法，或者多个同名方法，这些方法应该按 序放置在 起，便
+    于 读，此条规则优先于下 条
+
+21. 推荐 类内方法定义的 序依次是：公有方法或保护方法 > 私有方法 > getter / setter
+    方法
+
+     说明：公有方法是类的调用者和维护者最关心的方法， 屏展示最好；保护方法虽然只是子类关心，也可
+     能是“模板设计模式”下的核心方法；而私有方法外部 般不 要特别关心，是 个 盒实现；因为承载
+     的信息价值较低，所有 Service 和 DAO 的 getter/setter 方法放在类体最后
+
+22. 推荐 setter 方法中，参数名称与类成员变量名称 致，this.成员名 = 参数名 在
+    getter/setter 方法中，不要增加业务逻辑，增加排查 的 度
+
+     反例：
+
+          public Integer getData () {
+                if (condition) {
+                      return this.data + 100;
+                } else {
+                      return this.data - 100;
+                }
+
+          }
+
+23. 推荐 循环体内，字符串的连接方式，使用 StringBuilder 的 append 方法进行扩展
+
+     说明：下例中，反编译出的字节码文件显示每次循环都会 new 出 个 StringBuilder 对象，然后进行 append
+     操作，最后通过 toString 方法返回 String 对象，造成内存资源浪费
+     反例：
+
+          String str = "start";
+          for (int i = 0; i < 100; i++) {
+
+                str = str + "hello";
+          }
+
+24. 推荐 final 可以声明类 成员变量 方法 以及本地变量，下列情况使用 final 关 字：
+
+      1） 不允许被继承的类，如：String 类
+      2） 不允许修改引用的域对象，如：POJO 类的域变量
+      3） 不允许被覆写的方法，如：POJO 类的 setter 方法
+      4） 不允许运行过程中重新赋值的局部变量
+      5） 避免上下文重复使用 个变量，使用 final 关 字可以强制重新定义 个变量，方便更好地进行重构
+
+25. 推荐 慎用 Object 的 clone 方法来拷贝对象
+
+     说明：对象 clone 方法 认是浅拷贝，若想实现深拷贝， 覆写 clone 方法实现域对象的深度遍历式拷贝
+
+26. 推荐 类成员与方法访 控制从严：
+
+1） 如果不允许外部直接通过 new 来创建对象，那么构造方法必 是 private
+
+2） 工具类不允许有 public 或 default 构造方法
+
+3） 类 static 成员变量并且与子类共享，必 是 protected
+
+4） 类 static 成员变量并且仅在本类使用，必 是 private
+
+                                            10/59
+                                                                              Java 开发手册
+
+           5） 类 static 成员变量如果仅在本类使用，必 是 private
+           6） 若是 static 成员变量，考虑是否为 final
+           7） 类成员方法只供类内部调用，必 是 private
+           8） 类成员方法只对继承类公开，那么 制为 protected
+          说明：任何类 方法 参数 变量，严控访 范围 过于宽泛的访 范围，不利于模块解 思考：如果
+          是 个 private 的方法，想删 就删 ，可是 个 public 的 service 成员方法或成员变量，删 下，不
+          得手心冒点汗吗？变量像自己的小孩，尽量在自己的视线内，变量作用域太大，无 制的到处跑，那么你
+          会担心的
+
+(五) 日期时
+
+    1. 强制 日期格式化时，传入 pattern 中表示年份统 使用小写的 y
+
+          说明：日期格式化时，yyyy 表示当天所在的年，而大写的 YYYY 代表是 week in which year（JDK7 之后
+          引入的概念），意思是当天所在的周属于的年份， 周从周日开始，周六结束，只要本周跨年，返回的 YYYY
+          就是下 年
+          正例：表示日期和时 的格式如下所示：
+
+                        new SimpleDateFormat("yyyy-MM-dd HH:mm:ss")
+
+    2. 强制 在日期格式中分清楚大写的 M 和小写的 m，大写的 H 和小写的 h 分别指代的意义
+
+          说明：日期格式中的这两对字母表意如下：
+           1） 表示月份是大写的 M；
+           2） 表示分钟则是小写的 m；
+           3） 24 小时制的是大写的 H；
+           4） 12 小时制的则是小写的 h
+
+    3. 强制 获取当前毫秒数：System.currentTimeMillis(); 而不是 new Date().getTime()
+
+          说明：如果想获取更加精确的纳秒级时 值，使用 System.nanoTime 的方式 在 JDK8 中，针对统计时
+          等场景，推荐使用 Instant 类
+
+    4. 强制 不允许在程序任何地方中使用：1）java.sql.Date 2）java.sql.Time
+         3）java.sql.Timestamp
+
+          说明：第 1 个不记录时 ，getHours()抛出异常；第 2 个不记录日期，getYear()抛出异常；第 3 个在构造
+          方法 super((time/1000)*1000)，在 Timestamp 属性 fastTime 和 nanos 分别存储秒和纳秒信息
+
+          反例： java.util.Date.after(Date)进行时 比较时，当入参是 java.sql.Timestamp 时，会触发 JDK
+          BUG(JDK9 已修复)，可能导致比较时的意外结果
+
+    5. 强制 不要在程序中写死 年为 365 天，避免在公历 年时出现日期转换错误或程序逻辑
+         错误
+
+                                                                                                                                                                         11/59
+                                                                   Java 开发手册
+
+正例：
+
+    // 获取今年的天数
+    int daysOfThisYear = LocalDate.now().lengthOfYear();
+
+    // 获取指定某年的天数
+    LocalDate.of(2011, 1, 1).lengthOfYear();
+
+反例：
+
+    // 第 种情况：在 年 366 天时，出现数组越界异常
+    int[] dayArray = new int[365];
+
+// 第二种情况： 年有效期的会员制，今年 1 月 26 日注册，硬编码 365 返回的却是 1 月 25 日
+Calendar calendar = Calendar.getInstance();
+calendar.set(2020, 1, 26);
+calendar.add(Calendar.DATE, 365);
+
+6. 推荐 避免公历 年 2 月  年的 2 月份有 29 天， 年后的那 天不可能是 2 月 29
+    日
+
+7. 推荐 使用枚举值来指代月份 如果使用数字，注意 Date，Calendar 等日期相关类的月份
+    month 取值在 0-11 之
+
+     说明：参考 JDK 原生注释，Month value is 0-based. e.g., 0 for January.
+     正例： Calendar.JANUARY，Calendar.FEBRUARY，Calendar.MARCH 等来指代相应月份来进行传参或
+     比较
+
+(六) 合处理
+
+    1. 强制 关于 hashCode 和 equals 的处理，遵循如下规则：
+
+          1） 只要覆写 equals，就必 覆写 hashCode
+          2） 因为 Set 存储的是不重复的对象，依据 hashCode 和 equals 进行判断，所以 Set 存储的对象必 覆写
+          这两种方法
+          3） 如果自定义对象作为 Map 的 ，那么必 覆写 hashCode 和 equals
+          说明：String 因为覆写了 hashCode 和 equals 方法，所以可以 快地将 String 对象作为 key 来使用
+
+    2. 强制 判断所有 合内部的元素是否为空，使用 isEmpty()方法，而不是 size()==0 的方式
+
+          说明：在某些 合中，前者的时 复杂度为 O(1)，而且可读性更好
+          正例：
+
+                Map<String, Object> map = new HashMap<>(16);
+                if(map.isEmpty()) {
+
+                            System.out.println("no element in this map.");
+                }
+
+                                                                              12/59
+                                                                        Java 开发手册
+
+3. 强制 在使用 java.util.stream.Collectors 类的 toMap()方法转为 Map 合时， 定要使
+    用含有参数类型为 BinaryOperator，参数名为 mergeFunction 的方法，否则当出现相同 key
+    值时会抛出 IllegalStateException 异常
+
+     说明：参数 mergeFunction 的作用是当出现 key 重复时，自定义对 value 的处理策略
+
+     正例：
+
+          List<Pair<String, Double>> pairArrayList = new ArrayList<>(3);
+          pairArrayList.add(new Pair<>("version", 12.10));
+          pairArrayList.add(new Pair<>("version", 12.19));
+          pairArrayList.add(new Pair<>("version", 6.28));
+          Map<String, Double> map = pairArrayList.stream().collect(
+          // 生成的 map 合中只有 个 值对：{version=6.28}
+          Collectors.toMap(Pair::getKey, Pair::getValue, (v1, v2) -> v2));
+
+反例：
+
+    String[] departments = new String[] {"iERP", "iERP", "EIBU"};
+    // 抛出 IllegalStateException 异常
+    Map<Integer, String> map = Arrays.stream(departments)
+
+          .collect(Collectors.toMap(String::hashCode, str -> str));
+
+4. 强制 在使用 java.util.stream.Collectors 类的 toMap()方法转为 Map                    合时， 定要注
+    意当 value 为 null 时会抛 NPE 异常
+
+     说明：在 java.util.HashMap 的 merge 方法里会进行如下的判断：
+
+          if (value == null || remappingFunction == null)
+                throw new NullPointerException();
+
+     反例：
+
+          List<Pair<String, Double>> pairArrayList = new ArrayList<>(2);
+          pairArrayList.add(new Pair<>("version1", 8.3));
+          pairArrayList.add(new Pair<>("version2", null));
+          Map<String, Double> map = pairArrayList.stream().collect(
+          // 抛出 NullPointerException 异常
+          Collectors.toMap(Pair::getKey, Pair::getValue, (v1, v2) -> v2));
+
+5. 强制 ArrayList 的 subList 结果不可强转成 ArrayList，否则会抛出 ClassCastException 异
+    常：java.util.RandomAccessSubList cannot be cast to java.util.ArrayList
+
+     说明：subList()返回的是 ArrayList 的内部类 SubList，并不是 ArrayList 本身，而是 ArrayList 的 个视
+     图，对于 SubList 的所有操作最终会反映到原列表上
+
+6. 强制 使用 Map 的方法 keySet()/values()/entrySet()返回 合对象时，不可以对其进行添
+    加元素操作，否则会抛出 UnsupportedOperationException 异常
+
+7. 强制 Collections 类返回的对象，如：emptyList()/singletonList()等都是 immutable list，
+    不可对其进行添加或者删 元素的操作
+
+     反例：如果查询无结果，返回 Collections.emptyList()空 合对象，调用方 旦进行了添加元素的操作，就
+     会触发 UnsupportedOperationException 异常
+
+                                                                            13/59
+                                                                        Java 开发手册
+
+8. 强制 在 subList 场景中， 度注意对父 合元素的增加或删 ，均会导致子列表的遍历
+    增加 删 产生 ConcurrentModificationException 异常
+
+9. 强制 使用 合转数组的方法，必 使用 合的 toArray(T[] array)，传入的是类型完全
+    致 度为 0 的空数组
+
+     反例：直接使用 toArray 无参方法存在 ，此方法返回值只能是 Object[]类，若强转其它类型数组将出现
+     ClassCastException 错误
+     正例：
+
+          List<String> list = new ArrayList<>(2);
+          list.add("guan");
+          list.add("bao");
+          String[] array = list.toArray(new String[0]);
+
+     说明：使用 toArray 带参方法，数组空 大小的 length：
+             1） 等于 0，动态创建与 size 相同的数组，性能最好
+             2） 大于 0 但小于 size，重新创建大小等于 size 的数组，增加 GC 负担
+             3） 等于 size，在 并发情况下，数组创建完成之后，size 正在变大的情况下，负 影响与 2 相同
+             4） 大于 size，空 浪费，且在 size 处插入 null 值，存在 NPE 患
+
+10. 强制 在使用 Collection 接口任何实现类的 addAll()方法时，都要对输入的 合参数进行
+    NPE 判断
+
+     说明：在 ArrayList#addAll 方法的第 行代码即 Object[] a = c.toArray(); 其中 c 为输入 合参数，如果
+     为 null，则直接抛出异常
+
+11. 强制 使用工具类 Arrays.asList()把数组转换成 合时，不能使用其修改 合相关的方法，
+    它的 add/remove/clear 方法会抛出 UnsupportedOperationException 异常
+
+     说明：asList 的返回对象是 个 Arrays 内部类，并没有实现 合的修改方法 Arrays.asList 体现的是适配
+     器模式，只是转换接口，后台的数据仍是数组
+
+            String[] str = new String[] { "chen", "yang", "hao" };
+            List list = Arrays.asList(str);
+
+     第 种情况：list.add("yangguanbao"); 运行时异常
+     第二种情况：str[0] = "change"; 也会 之修改，反之亦然
+
+12. 强制 泛型通配符<? extends T>来接收返回的数据，此写法的泛型 合不能使用 add 方法，
+
+而<? super T>不能使用 get 方法，两者在接口调用赋值的场景中容易出错
+
+说明：扩展说 下 PECS(Producer Extends Consumer Super)原则：第  繁往外读取内容的，适合用
+
+<? extends T> 第二 经常往里插入的，适合用<? super T>
+
+13. 强制 在无泛型 制定义的 合赋值给泛型 制的 合时，在使用 合元素时， 要进行
+    instanceof 判断，避免抛出 ClassCastException 异常
+
+     说明：毕竟泛型是在 JDK5 后才出现，考虑到向前兼容，编译器是允许 泛型 合与泛型 合互相赋值
+
+                                                    14/59
+                                                                        Java 开发手册
+
+     反例：
+
+          List<String> generics = null;
+          List notGenerics = new ArrayList(10);
+          notGenerics.add(new Object());
+          notGenerics.add(new Integer(1));
+          generics = notGenerics;
+          // 此处抛出 ClassCastException 异常
+          String string = generics.get(0);
+
+14. 强制 不要在 foreach 循环里进行元素的 remove/add 操作 remove 元素请使用 Iterator
+    方式，如果并发操作， 要对 Iterator 对象加锁
+
+     正例：
+
+          List<String> list = new ArrayList<>();
+          list.add("1");
+          list.add("2");
+          Iterator<String> iterator = list.iterator();
+          while (iterator.hasNext()) {
+
+                String item = iterator.next();
+                if (删 元素的条件) {
+
+                      iterator.remove();
+                }
+          }
+
+     反例：
+
+          for (String item : list) {
+                if ("1".equals(item)) {
+                      list.remove(item);
+                }
+
+          }
+
+     说明：以上代码的执行结果肯定会出乎大家的意料，那么试 下把“1”换成“2”，会是同样的结果吗？
+
+15. 强制 在 JDK7 版本及以上，Comparator 实现类要满足如下三个条件，不然 Arrays.sort，
+    Collections.sort 会抛 IllegalArgumentException 异常
+
+     说明：三个条件如下
+
+      1） x，y 的比较结果和 y，x 的比较结果相反
+
+      2） x>y，y>z，则 x>z
+
+      3） x=y，则 x，z 比较结果和 y，z 比较结果相同
+
+     反例：下例中没有处理相等的情况，交换两个对象判断结果并不互反，不符合第 个条件，在实 使用中
+
+        可能会出现异常
+
+          new Comparator<Student>() {
+                @Override
+                public int compare(Student o1, Student o2) {
+                      return o1.getId() > o2.getId() ? 1 : -1;
+                }
+
+          };
+
+16. 推荐 合泛型定义时，在 JDK7 及以上，使用 diamond 语法或全省略
+
+   说明：菱形泛型，即 diamond，直接使用<>来指代前边已经指定的类型
+
+                                                                                                                                                                   15/59
+                       Java 开发手册
+
+   正例：
+
+          // diamond 方式，即<>
+          HashMap<String, String> userCache = new HashMap<>(16);
+          // 全省略方式
+          ArrayList<User> users = new ArrayList(10);
+
+17. 推荐 合初始化时，指定 合初始值大小
+
+     说明：HashMap 使用 HashMap(int initialCapacity) 初始化，如果暂时无法确定 合大小，那么指定
+     认值（16）即可
+     正例：initialCapacity = ( 要存储的元素个数 / 负载因子) + 1 注意负载因子（即 loader factor） 认
+     为 0.75，如果暂时无法确定初始值大小，请设置为 16（即 认值）
+     反例： HashMap 要放置 1024 个元素，由于没有设置容量初始大小， 着元素增加而被迫不断扩容，
+     resize()方法总共会调用 8 次，反复重建哈希表和数据迁移 当放置的 合元素个数达千万级时会影响程序
+     性能
+
+18. 推荐 使用 entrySet 遍历 Map 类 合 KV，而不是 keySet 方式进行遍历
+
+     说明：keySet 其实是遍历了 2 次， 次是转为 Iterator 对象，另 次是从 hashMap 中取出 key 所对应的
+     value 而 entrySet 只是遍历了 次就把 key 和 value 都放到了 entry 中，效率更 如果是 JDK8，使用
+     Map.forEach 方法
+     正例：values()返回的是 V 值 合，是 个 list 合对象；keySet()返回的是 K 值 合，是 个 Set 合对
+     象；entrySet()返回的是 K-V 值组合 合
+
+19. 推荐 度注意 Map 类 合 K/V 能不能存储 null 值的情况，如下表格：
+
+         合类  Key       Value      Super            说明
+
+Hashtable    不允许为 null 不允许为 null Dictionary  线程安全
+
+ConcurrentHashMap 不允许为 null 不允许为 null AbstractMap 锁分段技术（JDK8:CAS）
+
+TreeMap      不允许为 null 允许为 null   AbstractMap 线程不安全
+
+HashMap      允许为 null  允许为 null   AbstractMap 线程不安全
+
+反例：由于 HashMap 的干扰，很多人认为 ConcurrentHashMap 是可以置入 null 值，而事实上，存储
+null 值时会抛出 NPE 异常
+
+20. 参考 合理利用好 合的有序性(sort)和稳定性(order)，避免 合的无序性(unsort)和不稳
+    定性(unorder)带来的负 影响
+
+     说明：有序性是指遍历的结果是按某种比较规则依次排列的 稳定性指 合每次遍历的元素次序是 定的
+     如：ArrayList 是 order/unsort；HashMap 是 unorder/unsort；TreeSet 是 order/sort
+
+21. 参考 利用 Set 元素唯 的特性，可以快速对 个 合进行去重操作，避免使用 List 的
+    contains()进行遍历去重或者判断包含操作
+
+                                                                   16/59
+                         Java 开发手册
+
+(七) 并发处理
+
+1. 强制 获取单例对象 要保证线程安全，其中的方法也要保证线程安全
+
+     说明：资源 动类 工具类 单例工厂类都 要注意
+
+2. 强制 创建线程或线程池时请指定有意义的线程名称，方便出错时回
+
+     正例：自定义线程工厂，并且根据外部特征进行分组，比如，来自同 机房的调用，把机房编号赋值给
+     whatFeatureOfGroup
+
+          public class UserThreadFactory implements ThreadFactory {
+                private final String namePrefix;
+                private final AtomicInteger nextId = new AtomicInteger(1);
+
+// 定义线程组名称，在利用 jstack 来排查 时， 常有帮助
+UserThreadFactory(String whatFeatureOfGroup) {
+
+      namePrefix = "From UserThreadFactory's " + whatFeatureOfGroup + "-Worker-";
+}
+
+      @Override
+      public Thread newThread(Runnable task) {
+
+            String name = namePrefix + nextId.getAndIncrement();
+            Thread thread = new Thread(null, task, name, 0, false);
+            System.out.println(thread.getName());
+            return thread;
+      }
+
+}
+
+3. 强制 线程资源必 通过线程池提供，不允许在应用中自行显式创建线程
+
+     说明：线程池的好处是减少在创建和销毁线程上所消耗的时 以及系统资源的开销，解决资源不足的
+     如果不使用线程池，有可能造成系统创建大量同类线程而导致消耗完内存或者“过度切换”的
+
+4. 强制 线程池不允许使用 Executors 去创建，而是通过 ThreadPoolExecutor 的方式，这
+    样的处理方式让写的同学更加明确线程池的运行规则，规避资源耗尽的
+
+     说明：Executors 返回的线程池对象的 端如下：
+     1） FixedThreadPool 和 SingleThreadPool：
+
+        允许的请求 列 度为 Integer.MAX_VALUE，可能会堆积大量的请求，从而导致 OOM
+     2） CachedThreadPool：
+
+        允许的创建线程数量为 Integer.MAX_VALUE，可能会创建大量的线程，从而导致 OOM
+
+5. 强制 SimpleDateFormat 是线程不安全的类， 般不要定义为 static 变量，如果定义为 static，
+
+必 加锁，或者使用 DateUtils 工具类
+
+正例：注意线程安全，使用 DateUtils 亦推荐如下处理：
+
+private static final ThreadLocal<DateFormat> df = new ThreadLocal<DateFormat>() {
+      @Override
+      protected DateFormat initialValue() {
+            return new SimpleDateFormat("yyyy-MM-dd");
+      }
+
+};
+
+                                                                                   17/59
+                                                                        Java 开发手册
+
+     说明：如果是 JDK8 的应用，可以使用 Instant 代替 Date，LocalDateTime 代替 Calendar，
+     DateTimeFormatter 代替 SimpleDateFormat，官方给出的解释：simple beautiful strong immutable
+     thread-safe
+
+6. 强制 必 回收自定义的 ThreadLocal 变量，尤其在线程池场景下，线程经常会被复用，
+    如果不清理自定义的 ThreadLocal 变量，可能会影响后续业务逻辑和造成内存泄 等
+    尽量在代理中使用 try-finally 块进行回收
+
+     正例：
+
+          objectThreadLocal.set(userInfo);
+          try {
+
+                // ...
+          } finally {
+
+                objectThreadLocal.remove();
+          }
+
+7. 强制 并发时，同步调用应该去考量锁的性能损耗 能用无锁数据结构，就不要用锁；能
+    锁区块，就不要锁整个方法体；能用对象锁，就不要用类锁
+
+     说明：尽可能使加锁的代码块工作量尽可能的小，避免在锁代码块中调用 RPC 方法
+
+8. 强制 对多个资源 数据库表 对象同时加锁时， 要保持 致的加锁 序，否则可能会造
+    成死锁
+
+     说明：线程 要对表 A B C 依次全部加锁后才可以进行更新操作，那么线程二的加锁 序也必 是 A
+     B C，否则可能出现死锁
+
+9. 强制 在使用 塞等待获取锁的方式中，必 在 try 代码块之外，并且在加锁方法与 try 代
+    码块之 没有任何可能抛出异常的方法调用，避免加锁成功后，在 finally 中无法解锁
+
+     说明 ：如果在 lock 方法与 try 代码块之 的方法调用抛出异常，那么无法解锁，造成其它线程无法成功
+     获取锁
+     说明二：如果 lock 方法在 try 代码块之内，可能由于其它方法抛出异常，导致在 finally 代码块中，unlock
+     对未加锁的对象解锁，它会调用 AQS 的 tryRelease 方法（取决于具体实现类），抛出
+     IllegalMonitorStateException 异常
+     说明三：在 Lock 对象的 lock 方法实现中可能抛出 unchecked 异常，产生的后果与说明二相同
+     正例：
+
+          Lock lock = new XxxLock();
+          // ...
+          lock.lock();
+          try {
+
+                doSomething();
+                doOthers();
+          } finally {
+                lock.unlock();
+          }
+
+     反例：
+
+          Lock lock = new XxxLock();
+          // ...
+
+                                                                                                                                                                   18/59
+                                                                        Java 开发手册
+          try {
+
+                // 如果此处抛出异常，则直接执行 finally 代码块
+                doSomething();
+                // 无论加锁是否成功，finally 代码块都会执行
+                lock.lock();
+                doOthers();
+          } finally {
+                lock.unlock();
+          }
+
+10. 强制 在使用尝试机制来获取锁的方式中，进入业务代码块之前，必 先判断当前线程是否
+    持有锁 锁的释放规则与锁的 塞等待方式相同
+
+     说明：Lock 对象的 unlock 方法在执行时，它会调用 AQS 的 tryRelease 方法（取决于具体实现类），如果
+     当前线程不持有锁，则抛出 IllegalMonitorStateException 异常
+     正例：
+
+          Lock lock = new XxxLock();
+          // ...
+          boolean isLocked = lock.tryLock();
+          if (isLocked) {
+
+                try {
+                      doSomething();
+                      doOthers();
+
+                } finally {
+                      lock.unlock();
+
+                }
+          }
+
+11. 强制 并发修改同 记录时，避免更新丢失， 要加锁 要么在应用层加锁，要么在缓存加
+    锁，要么在数据库层使用乐观锁，使用 version 作为更新依据
+
+     说明：如果每次访 冲突概率小于 20%，推荐使用乐观锁，否则使用 观锁 乐观锁的重试次数不得小于
+     3次
+
+12. 强制 多线程并行处理定时任务时，Timer 运行多个 TimeTask 时，只要其中之 没有捕获抛
+    出的异常，其它任务便会自动终止运行，使用 ScheduledExecutorService 则没有这个
+
+13. 推荐 资金相关的金 敏感信息，使用 观锁策略
+
+     说明：乐观锁在获得锁的同时已经完成了更新操作，校 逻辑容易出现漏洞，另外，乐观锁对冲突的解决策
+     略有较复杂的要求，处理不当容易造成系统压力或数据异常，所以资金相关的金 敏感信息不建议使用乐观
+     锁更新
+     正例： 观锁遵循 锁 二判 三更新 四释放的原则
+
+14. 推荐 使用 CountDownLatch 进行异步转同步操作，每个线程退出前必 调用 countDown 方
+    法，线程执行代码注意 catch 异常，确保 countDown 方法被执行到，避免主线程无法执行至
+    await 方法，直到超时才返回结果
+
+     说明：注意，子线程抛出异常堆栈，不能在主线程 try-catch 到
+
+                                                                                                                                                                   19/59
+                                                                        Java 开发手册
+
+15. 推荐 避免 Random 实例被多线程使用，虽然共享该实例是线程安全的，但会因竞争同 seed
+    导致的性能下
+
+     说明：Random 实例包括 java.util.Random 的实例或者 Math.random()的方式
+
+     正例：在 JDK7 之后，可以直接使用 API ThreadLocalRandom，而在 JDK7 之前， 要编码保证每个线
+
+     程持有 个单独的 Random 实例
+
+16. 推荐 通过双重检查锁（double-checked locking）（在并发场景下）存在延迟初始化的优化
+             患（可参考 The "Double-Checked Locking is Broken" Declaration），推荐解决方案中较
+
+    为简单 种（适用于 JDK5 及以上版本），将目标属性声明为 volatile 型，比如将 helper 的属
+    性声明修改为`private volatile Helper helper = null;`
+
+     正例：
+
+          public class LazyInitDemo {
+                private volatile Helper helper = null;
+
+                public Helper getHelper() {
+                      if (helper == null) {
+                            synchronized (this) {
+                                  if (helper == null) { helper = new Helper(); }
+                            }
+                      }
+                      return helper;
+
+                }
+                // other methods and fields...
+          }
+
+17. 参考 volatile 解决多线程内存不可见  对于 写多读，是可以解决变量同步 ，但
+
+是如果多写，同样无法解决线程安全
+
+说明：如果是 count++操作，使用如下类实现：AtomicInteger count = new AtomicInteger();
+
+count.addAndGet(1); 如果是 JDK8，推荐使用 LongAdder 对象，比 AtomicLong 性能更好（减少乐观
+
+锁的重试次数）
+
+18. 参考 HashMap 在容量不够进行 resize 时由于 并发可能出现死链，导致 CPU 升，在
+    开发过程中注意规避此
+
+19. 参考 ThreadLocal 对象使用 static 修 ，ThreadLocal 无法解决共享对象的更新
+
+     说明：这个变量是针对 个线程内所有操作共享的，所以设置为 态变量，所有此类实例共享此 态变量，
+     也就是说在类第 次被使用时装载，只分配 块存储空 ，所有此类的对象(只要是这个线程内定义的)都可
+     以操控这个变量
+
+(八) 控制语句
+
+    1. 强制 在 个 switch 块内，每个 case 要么通过 continue/break/return 等来终止，要么
+         注释说明程序将继续执行到哪 个 case 为止；在 个 switch 块内，都必 包含 个 default
+
+                                                                                                                                                                         20/59
+                                                                        Java 开发手册
+
+    语句并且放在最后，即使它什么代码也没有
+
+     说明：注意 break 是退出 switch 语句块，而 return 是退出方法体
+
+2. 强制 当 switch 括号内的变量类型为 String 并且此变量为外部参数时，必 先进行 null
+    判断
+
+     反例：如下的代码输出是什么？
+
+          public class SwitchString {
+                public static void main(String[] args) {
+                      method(null);
+                }
+
+                public static void method(String param) {
+                      switch (param) {
+                            // 肯定不是进入这里
+                            case "sth":
+                                  System.out.println("it's sth");
+                                  break;
+                            // 也不是进入这里
+                            case "null":
+                                  System.out.println("it's null");
+                                  break;
+                            // 也不是进入这里
+                            default:
+                                  System.out.println("default");
+                      }
+
+                }
+          }
+
+3. 强制 在 if/else/for/while/do 语句中必 使用大括号
+
+     说明：即使只有 行代码，也禁止不采用大括号的编码方式：if (condition) statements;
+
+4. 强制 三目运算符 condition? 表达式 1 : 表达式 2 中， 度注意表达式 1 和 2 在类型对
+    时，可能抛出因自动拆箱导致的 NPE 异常
+
+     说明：以下两种场景会触发类型对 的拆箱操作：
+     1） 表达式 1 或表达式 2 的值只要有 个是原始类型
+     2） 表达式 1 或表达式 2 的值的类型不 致，会强制拆箱升级成表示范围更大的那个类型
+     反例：
+
+          Integer a = 1;
+          Integer b = 2;
+          Integer c = null;
+          Boolean flag = false;
+          // a*b 的结果是 int 类型，那么 c 会强制拆箱成 int 类型，抛出 NPE 异常
+          Integer result=(flag? a*b : c);
+
+5. 强制 在 并发场景中，避免使用”等于”判断作为中断或退出的条件
+
+     说明：如果并发控制没有处理好，容易产生等值判断被“击穿”的情况，使用大于或小于的区 判断条件
+     来代替
+
+                                                                                                                                                                   21/59
+                                                                        Java 开发手册
+
+     反例：判断剩余奖品数量等于 0 时，终止发放奖品，但因为并发处理错误导致奖品数量瞬 变成了负数，
+
+     这样的话，活动无法终止
+
+6. 推荐 当某个方法的代码总行数超过 10 行时，return / throw 等中断逻辑的右大括号后均
+       要加 个空行
+
+     说明：这样做逻辑清晰，有利于代码 读时重点关注
+
+7. 推荐 表达异常的分支时，少用 if-else 方式，这种方式可以改写成：
+
+          if (condition) {
+                ...
+                return obj;
+
+          }
+          // 接着写 else 的业务逻辑代码;
+
+     说明：如果 使用 if()...else if()...else...方式表达逻辑，避免后续代码维护困 ，请勿超过 3 层
+
+     正例：超过 3 层的 if-else 的逻辑判断代码可以使用卫语句 策略模式 状态模式等来实现，其中卫语句
+
+     示例如下：
+
+          public void findBoyfriend (Man man) {
+                if (man.isUgly()) {
+                      System.out.println("本 是外 协会的资深会员");
+                      return;
+                }
+                if (man.isPoor()) {
+                      System.out.println(" 夫 百事 ");
+                      return;
+                }
+                if (man.isBadTemper()) {
+                      System.out.println("银河有多远，你就给我滚多远");
+                      return;
+                }
+
+                System.out.println("可以先交往 段时 看看");
+          }
+
+8. 推荐 常用方法（如 getXxx/isXxx）等外，不要在条件判断中执行其它复杂的语句，将复
+    杂逻辑判断的结果赋值给 个有意义的布尔变量名，以提 可读性
+
+     说明：很多 if 语句内的逻辑表达式相当复杂，与 或 取反混合运算，甚至各种方法纵深调用，理解成本
+
+        常 如果赋值 个 常好理解的布尔变量名字，则是件令人 心 目的事情
+
+     正例：
+
+          // 伪代码如下
+          final boolean existed = (file.open(fileName, "w") != null) && (...) || (...);
+          if (existed) {
+
+                ...
+          }
+
+     反例：
+
+          public final void acquire ( long arg) {
+                if (!tryAcquire(arg) &&
+                      acquireQueued(addWaiter(Node.EXCLUSIVE), arg)) {
+                      selfInterrupt();
+                }
+
+                                                                                                                                                                   22/59
+                                                                        Java 开发手册
+
+9. 推荐 不要在其它表达式（尤其是条件表达式）中，插入赋值语句
+
+     说明：赋值点类似于人体的穴位，对于代码的理解至关重要，所以赋值语句 要清晰地单独成为 行
+     反例：
+
+          public Lock getLock(boolean fair) {
+                // 算术表达式中出现赋值操作，容易忽略 count 值已经被改变
+                threshold = (count = Integer.MAX_VALUE) - 1;
+                // 条件表达式中出现赋值操作，容易误认为是 sync==fair
+                return (sync = fair) ? new FairSync() : new NonfairSync();
+
+          }
+
+10. 推荐 循环体中的语句要考量性能，以下操作尽量移至循环体外处理，如定义对象 变量
+    获取数据库连接，进行不必要的 try-catch 操作（这个 try-catch 是否可以移至循环体外）
+
+11. 推荐 避免采用取反逻辑运算符
+
+     说明：取反逻辑不利于快速理解，并且取反逻辑写法 般都存在对应的正向逻辑写法
+     正例：使用 if (x < 628) 来表达 x 小于 628
+     反例：使用 if (!(x >= 628)) 来表达 x 小于 628
+
+12. 推荐 公开接口 要进行入参保护，尤其是批量操作的接口
+
+     反例：某业务系统，提供 个用户批量查询的接口，API 文档上有说最多查多少个，但接口实现上没做任何
+     保护，导致调用方传了 个 1000 的用户 id 数组过来后，查询信息后，内存爆了
+
+13. 参考 下列情形， 要进行参数校 ：
+
+      1） 调用 次低的方法
+      2） 执行时 开销很大的方法 此情形中，参数校 时 几乎可以忽略不计，但如果因为参数错误导致
+     中 执行回退，或者错误，那得不偿失
+      3） 要极 稳定性和可用性的方法
+      4） 对外提供的开放接口，不管是 RPC/API/HTTP 接口
+      5） 敏感权 入口
+
+14. 参考 下列情形，不 要进行参数校 ：
+
+      1） 极有可能被循环调用的方法 但在方法说明里必 注明外部参数检查
+      2） 底层调用 度比较 的方法 毕竟是像纯净水过滤的最后 道，参数错误不太可能到底层才会暴
+
+                 般 DAO 层与 Service 层都在同 个应用中，部署在同 台服务器中，所以 DAO 的参数校 ，可
+     以省略
+      3） 被声明成 private 只会被自己代码所调用的方法，如果能够确定调用方法的代码传入参数已经做过检
+     查或者肯定不会有 ，此时可以不校 参数
+
+                                                                                                                                                                   23/59
+                       Java 开发手册
+
+(九) 注释规约
+
+1. 强制 类 类属性 类方法的注释必 使用 Javadoc 规范，使用/**内容*/格式，不得使用
+    // xxx 方式
+
+     说明：在 IDE 编辑窗口中，Javadoc 方式会提示相关注释，生成 Javadoc 可以正确输出相应注释；在 IDE
+     中，工程调用方法时，不进入方法即可悬浮提示方法 参数 返回值的意义，提 读效率
+
+2. 强制 所有的抽象方法（包括接口中的方法）必 要用 Javadoc 注释  了返回值 参数
+    异常说明外，还必 指出该方法做什么事情，实现什么功能
+
+     说明：对子类的实现要求，或者调用注意事 ，请 并说明
+
+3. 强制 所有的类都必 添加创建者和创建日期
+
+     说明：在设置模板时，注意 IDEA 的@author 为`${USER}`，而 eclipse 的@author 为`${user}`，大小写有
+     区别，而日期的设置统 为 yyyy/MM/dd 的格式
+     正例：
+
+         /**
+
+* @author yangguanbao
+
+* @date 2016/10/31
+
+           */
+
+4. 强制 方法内部单行注释，在被注释语句上方另起 行，使用//注释 方法内部多行注释使
+    用/* */注释，注意与代码对
+
+5. 强制 所有的枚举类型字段必 要有注释，说明每个数据 的用途
+
+6. 推荐 与其“半吊子”英文来注释，不如用中文注释把 说清楚 专有名词与关 字保持
+    英文原文即可
+
+     反例：“TCP 连接超时”解释成“传输控制协议连接超时”，理解反而费脑
+
+7. 推荐 代码修改的同时，注释也要进行相应的修改，尤其是参数 返回值 异常 核心逻辑
+    等的修改
+
+     说明：代码与注释更新不同步，就像路网与导航软件更新不同步 样，如果导航软件严重滞后，就失去了
+     导航的意义
+
+8. 推荐 在类中删 未使用的任何字段 方法 内部类；在方法中删 未使用的任何参数声明
+    与内部变量
+
+9. 参考 慎注释掉代码 在上方详细说明，而不是简单地注释掉 如果无用，则删
+
+     说明：代码被注释掉有两种可能性：1）后续会恢复此段代码逻辑 2）永久不用 前者如果没有备注信息，
+        以知晓注释动机 后者建议直接删掉即可，假如 要查 历史代码，登录代码仓库即可
+
+                                        24/59
+                                                                              Java 开发手册
+
+    10. 参考 对于注释的要求：第 能够准确反映设计思想和代码逻辑；第二 能够描述业务含
+         义，使别的程序员能够迅速了解到代码背后的信息 完全没有注释的大段代码对于 读者形同
+         天书，注释是给自己看的，即使 很 时 ，也能清晰理解当时的思路；注释也是给继任者看
+         的，使其能够快速接替自己的工作
+
+    11. 参考 好的命名 代码结构是自解释的，注释力求精简准确 表达到位 避免出现注释的
+         个极端：过多过滥的注释，代码的逻辑 旦修改，修改注释又是相当大的负担
+
+          反例：
+
+                // put elephant into fridge
+                put(elephant, fridge);
+
+          方法名 put，加上两个有意义的变量名 elephant 和 fridge，已经说明了这是在干什么，语义清晰的代码不
+             要 外的注释
+
+    12. 参考 特殊注释标记，请注明标记人与标记时 注意及时处理这些标记，通过标记扫描，
+         经常清理此类标记 线上故 有时候就是来源于这些标记处的代码
+
+           1） 待办事宜（TODO）:（标记人，标记时 ，[ 计处理时 ]）
+              表示 要实现，但目前还未实现的功能 这实 上是 个 Javadoc 的标签，目前的 Javadoc 还没
+                   有实现，但已经被广泛使用 只能应用于类，接口和方法（因为它是 个 Javadoc 标签）
+
+           2） 错误，不能工作（FIXME）:（标记人，标记时 ，[ 计处理时 ]）
+              在注释中用 FIXME 标记某代码是错误的，而且不能工作， 要及时纠正的情况
+
+(十) 前后端规约
+
+    1. 强制 前后端交互的 API， 要明确协议 域名 路径 请求方法 请求内容 状态码 响
+         应体
+
+          说明：
+          1） 协议：生产环境必 使用 HTTPS
+          2） 路径：每 个 API 对应 个路径，表示 API 具体的请求地址：
+
+             a） 代表 种资源，只能为名词，推荐使用复数，不能为动词，请求方法已经表达动作意义
+             b） URL 路径不能使用大写，单词如果 要分 ，统 使用下划线
+             c） 路径禁止携带表示请求内容类型的后缀，比如".json",".xml"，通过 accept 头表达即可
+          3） 请求方法：对具体操作的定义，常见的请求方法如下：
+             a） GET：从服务器取出资源
+             b） POST：在服务器新建 个资源
+             c） PUT：在服务器更新资源
+             d） DELETE：从服务器删 资源
+          4） 请求内容：URL 带的参数必 无敏感信息或符合安全要求；body 里带参数时必 设置 Content-Type
+          5） 响应体：响应体 body 可放置多种数据类型，由 Content-Type 头来确定
+
+                                                                                                                                                                         25/59
+                                                                        Java 开发手册
+
+2. 强制 前后端数据列表相关的接口返回，如果为空，则返回空数组[]或空 合{}
+
+     说明：此条约定有利于数据层 上的协作更加 效，减少前端很多 碎的 null 判断
+
+3. 强制 服务端发生错误时，返回给前端的响应信息必 包含 HTTP 状态码，errorCode
+    errorMessage 用户提示信息四个部分
+
+     说明：四个部分的涉众对象分别是浏览器 前端开发 错误排查人员 用户 其中输出给用户的提示信息
+     要求：简短清晰 提示友好，引导用户进行下 步操作或解释错误原因，提示信息可以包括错误原因 上
+     下文环境 推荐操作等 errorCode：参考 表 3 errorMessage：简要描述后端出错原因，便于错误排
+     查人员快速定位 ，注意不要包含敏感数据信息
+     正例：常见的 HTTP 状态码如下
+      1） 200 OK: 表明该请求被成功地完成，所请求的资源发送到客户端
+      2） 401 Unauthorized: 请求要求身份 证，常见对于 要登录而用户未登录的情况
+      3） 403 Forbidden：服务器拒绝请求，常见于机密信息或复制其它登录用户链接访 服务器的情况
+      4） 404 Not Found: 服务器无法取得所请求的网 ，请求资源不存在
+      5） 500 Internal Server Error: 服务器内部错误
+
+4. 强制 在前后端交互的 JSON 格式数据中，所有的 key 必 为小写字母开始的
+    lowerCamelCase 格，符合英文表达习惯，且表意完整
+
+     正例：errorCode / errorMessage / assetStatus / menuList / orderList / configFlag
+     反例：ERRORCODE / ERROR_CODE / error_message / error-message / errormessage /
+     ErrorMessage / msg
+
+5. 强制 errorMessage 是前后端错误追踪机制的体现，可以在前端输出到 type="hidden"
+    文字类控件中，或者用户端的日志中，帮助我们快速地定位出
+
+6. 强制 对于 要使用超大整数的场景，服务端 律使用 String 字符串类型返回，禁止使用
+
+Long 类型
+
+说明：Java 服务端如果直接返回 Long 整型数据给前端，JS 会自动转换为 Number 类型（注：此类型为双
+
+精度浮点数，表示原理与取值范围等同于 Java 中的 Double） Long 类型能表示的最大值是 2 的 63 次方
+
+-1，在取值范围之内，超过 2 的 53 次方 (9007199254740992)的数值转化为 JS 的 Number 时，有些数
+
+值会有精度损失 扩展说明，在 Long 取值范围内，任何 2 的指数次整数都是绝对不会存在精度损失的，所
+
+以说精度损失是 个概率  若浮点数尾数位与指数位空 不 ，则可以精确表示任何整数，但很不幸，
+
+双精度浮点数的尾数位只有 52 位
+
+反例：通常在订单号或交易号大于等于 16 位，大概率会出现前后端单据不 致的情况，比如，"orderId":
+
+362909601374617692，前端拿到的值却是: 362909601374617660
+
+7. 强制 HTTP 请求通过 URL 传递参数时，不能超过 2048 字节
+
+     说明：不同浏览器对于 URL 的最大 度 制略有不同，并且对超出最大 度的处理逻辑也有差异，2048
+     字节是取所有浏览器的最小值
+
+                                                                                    26/59
+                                                                        Java 开发手册
+
+     反例：某业务将退货的商品 id 列表放在 URL 中作为参数传递，当 次退货商品数量过多时，URL 参数超 ，
+     传递到后端的参数被截断，导致部分商品未能正确退货
+
+8. 强制 HTTP 请求通过 body 传递内容时，必 控制 度，超出最大 度后，后端解析会出
+    错
+
+     说明：nginx 认 制是 1MB，tomcat 认 制为 2MB，当确实有业务 要传较大内容时，可以通过调
+     大服务器端的 制
+
+9. 强制 在翻 场景中，用户输入参数的小于 1，则前端返回第  参数给后端；后端发现用
+    户输入的参数大于总 数，直接返回最后
+
+10. 强制 服务器内部重定向必 使用 forward；外部重定向地址必 使用 URL 统 代理模块
+    生成，否则会因线上采用 HTTPS 协议而导致浏览器提示“不安全”，并且还会带来 URL 维护
+    不 致的
+
+11. 推荐 服务器返回信息必 被标记是否可以缓存，如果缓存，客户端可能会重用之前的请求
+    结果
+
+     说明：缓存有利于减少交互次数，减少交互的平均延迟
+     正例：http 1.1 中，s-maxage 告诉服务器进行缓存，时 单位为秒，用法如下，
+     response.setHeader("Cache-Control", "s-maxage=" + cacheSeconds);
+
+12. 推荐 服务端返回的数据，使用 JSON 格式而 XML
+
+     说明：尽管 HTTP 支持使用不同的输出格式，例如纯文本，JSON，CSV，XML，RSS 甚至 HTML 如果我
+     们使用的 向用户的服务，应该选择 JSON 作为通信中使用的标准数据交换格式，包括请求和响应 此外，
+     application/JSON 是 种通用的 MIME 类型，具有实用 精简 易读的特点
+
+13. 推荐 前后端的时 格式统 为"yyyy-MM-dd HH:mm:ss"，统 为 GMT
+
+14. 参考 在接口路径中不要加入版本号，版本控制在 HTTP 头信息中体现，有利于向前兼容
+
+     说明：当用户在低版本与 版本之 反复切换工作时，会导致迁移复杂度升 ，存在数据错乱
+
+(十 ) 其他
+
+    1. 强制 在使用正则表达式时，利用好其 编译功能，可以有效加快正则匹配速度
+
+          说明：不要在方法体内定义：Pattern pattern = Pattern.compile(“规则”);
+
+    2. 强制 避免用 Apache Beanutils 进行属性的 copy
+
+          说明：Apache BeanUtils 性能较差，可以使用其他方案比如 Spring BeanUtils, Cglib BeanCopier，注意
+          均是浅拷贝
+
+                                                                                                                                                                         27/59
+                                                                        Java 开发手册
+
+3. 强制 velocity 调用 POJO 类的属性时，直接使用属性名取值即可，模板引擎会自动按规范
+    调用 POJO 的 getXxx()，如果是 boolean 基本数据类型变量（boolean 命名不 要加 is 前缀），
+    会自动调用 isXxx()方法
+
+     说明：注意如果是 Boolean 包装类对象，优先调用 getXxx()的方法
+
+4. 强制 后台输送给 的变量必 加$!{var}——中 的感叹号
+
+     说明：如果 var 等于 null 或者不存在，那么${var}会直接显示在 上
+
+5. 强制 注意 Math.random() 这个方法返回是 double 类型，注意取值的范围 0≤x<1（能够
+    取到 值，注意 异常），如果想获取整数类型的 机数，不要将 x 放大 10 的若干倍然后
+    取整，直接使用 Random 对象的 nextInt 或者 nextLong 方法
+
+6. 推荐 不要在视图模板中加入任何复杂的逻辑
+
+     说明：根据 MVC 理论，视图的职责是展示，不要抢模型和控制器的活
+
+7. 推荐 任何数据结构的构造或初始化，都应指定大小，避免数据结构无 增 吃光内存
+8. 推荐 及时清理不再使用的代码段或配置信息
+
+     说明：对于垃圾代码或过时配置，坚决清理干净，避免程序过度 ，代码冗余
+     正例：对于暂时被注释掉，后续可能恢复使用的代码片断，在注释代码上方，统 规定使用三个斜杠(///)
+     来说明注释掉代码的理由 如：
+
+           public static void hello() {
+                /// 业务方通知活动暂停
+                // Business business = new Business();
+                // business.active();
+                System.out.println("it's finished");
+
+          }
+
+                                                                                                                                                                   28/59
+         Java 开发手册
+
+二 异常日志
+
+(一) 错误码
+
+1. 强制 错误码的制定原则：快速 源 通标准化
+
+     说明： 错误码想得过于完美和复杂，就像康熙字典中的生 字 样，用词似乎精准，但是字典不容易 身
+     携带并且简单易懂
+     正例：错误码回答的 是谁的错？错在哪？1）错误码必 能够快速知晓错误来源，可快速判断是谁的
+
+           2）错误码必 能够进行清晰地比对（代码中容易 equals） 3）错误码有利于团 快速对错误原因达
+     到 致认知
+
+2. 强制 错误码不体现版本号和错误等级信息
+
+     说明：错误码以不断追加的方式进行兼容 错误等级由日志和错误码本身的释义来决定
+
+3. 强制 全部正常，但不得不填充错误码时返回五个 ：00000
+
+4. 强制 错误码为字符串类型，共 5 位，分成两个部分：错误产生来源+四位数字编号
+
+     说明：错误产生来源分为 A/B/C，A 表示错误来源于用户，比如参数错误，用户安装版本过低，用户支付
+     超时等 ；B 表示错误来源于当前系统，往往是业务逻辑出错，或程序健 性差等 ；C 表示错误来源
+     于第三方服务，比如 CDN 服务出错，消息投递超时等 ；四位数字编号从 0001 到 9999，大类之 的
+     步 距 留 100，参考文末 表 3
+
+5. 强制 编号不与公司业务架构，更不与组织架构挂钩，以先到先得的原则在统 平台上进行，
+    审批生效，编号即被永久固定
+
+6. 强制 错误码使用者避免 意定义新的错误码
+
+     说明：尽可能在原有错误码 表中找到语义相同或者相近的错误码在代码中使用即可
+
+7. 强制 错误码不能直接输出给用户作为提示信息使用
+
+     说明：堆栈（stack_trace） 错误信息(error_message) 错误码（error_code） 提示信息（user_tip）
+     是 个有效关联并互相转义的和谐整体，但是请勿互相越 代
+
+8. 推荐 错误码之外的业务独特信息由 error_message 来承载，而不是让错误码本身 盖过
+    多具体业务属性
+
+9. 推荐 在获取第三方服务错误码时，向上抛出允许本系统转义，由 C 转为 B，并且在错误信
+    息上带上原有的第三方错误码
+
+10. 参考 错误码分为 级宏观错误码 二级宏观错误码 三级宏观错误码
+
+     说明：在无法更加具体确定的错误场景中，可以直接使用 级宏观错误码，分别是：A0001（用户端错误）
+
+                                                                                                                                                                   29/59
+                                                                              Java 开发手册
+
+          B0001（系统执行出错） C0001（调用第三方服务出错）
+          正例：调用第三方服务出错是 级，中 件错误是二级，消息服务出错是三级
+
+    11. 参考 错误码的后三位编号与 HTTP 状态码没有任何关系
+
+    12. 参考 错误码有利于不同文化背景的开发者进行交流与代码协作
+
+          说明：英文单词形式的错误码不利于 英语母语国家（如 拉伯语 希伯来语 俄罗斯语等）之 的开发
+          者互相协作
+
+    13. 参考 错误码即人性，感性认知+口口相传，使用纯数字来进行错误码编排不利于感性记忆
+         和分类
+
+          说明：数字是 个整体，每位数字的地位和含义是相同的
+          反例： 个五位数字 12345，第 1 位是错误等级，第 2 位是错误来源，345 是编号，人的大脑不会主动地
+          拆开并分辨每位数字的不同含义
+
+( ) 异常处理
+
+    1. 强制 Java 类库中定义的可以通过 检查方式规避的 RuntimeException 异常不应该通过
+         catch 的方式来处理，比如：NullPointerException，IndexOutOfBoundsException 等等
+
+          说明：无法通过 检查的异常 外，比如，在解析字符串形式的数字时，可能存在数字格式错误，不得不
+          通过 catch NumberFormatException 来实现
+          正例：if (obj != null) {...}
+          反例：try { obj.method(); } catch (NullPointerException e) {…}
+
+    2. 强制 异常捕获后不要用来做流程控制，条件控制
+
+          说明：异常设计的初衷是解决程序运行中的各种意外情况，且异常的处理效率比条件判断方式要低很多
+
+    3. 强制 catch 时请分清稳定代码和 稳定代码，稳定代码指的是无论如何不会出错的代码
+         对于 稳定代码的 catch 尽可能进行区分异常类型，再做对应的异常处理
+
+          说明：对大段代码进行 try-catch，使程序无法根据不同的异常做出正确的应激反应，也不利于定位 ，
+          这是 种不负责任的表现
+          正例：用户注册的场景中，如果用户输入 法字符，或用户名称已存在，或用户输入密码过于简单，在程
+          序上作出分 别类的判断，并提示给用户
+
+    4. 强制 捕获异常是为了处理它，不要捕获了却什么都不处理而抛弃之，如果不想处理它，请
+         将该异常抛给它的调用者 最外层的业务使用者，必 处理异常，将其转化为用户可以理解的
+         内容
+
+    5. 强制 事务场景中，抛出异常被 catch 后，如果 要回滚， 定要注意手动回滚事务
+
+                                                                                                                                                                         30/59
+                                                                        Java 开发手册
+
+6. 强制 finally 块必 对资源对象 流对象进行关 ，有异常也要做 try-catch
+
+     说明：如果 JDK7 及以上，可以使用 try-with-resources 方式
+
+7. 强制 不要在 finally 块中使用 return
+
+     说明：try 块中的 return 语句执行成功后，并不 上返回，而是继续执行 finally 块中的语句，如果此处存
+     在 return 语句，则在此直接返回，无情丢弃掉 try 块中的返回点
+     反例：
+
+          private int x = 0;
+
+   public int checkReturn() {
+         try {
+               // x 等于 1，此处不返回
+               return ++x;
+         } finally {
+               // 返回的结果是 2
+               return ++x;
+         }
+
+   }
+
+8. 强制 捕获异常与抛异常，必 是完全匹配，或者捕获异常是抛异常的父类
+
+     说明：如果 期对方抛的是 球，实 接到的是铅球，就会产生意外情况
+
+9. 强制 在调用 RPC 二方包 或动态生成类的相关方法时，捕捉异常必 使用 Throwable
+    类来进行拦截
+
+     说明：通过反射机制来调用方法，如果找不到方法，抛出 NoSuchMethodException 什么情况会抛出
+     NoSuchMethodError ？二方包在类冲突时，仲裁机制可能导致引入 期的版本使类的方法签名不匹配，
+     或者在字节码修改框架（比如：ASM）动态创建或修改类时，修改了相应的方法签名 这些情况，即使代
+     码编译期是正确的，但在代码运行期时，会抛出 NoSuchMethodError
+
+10. 推荐 方法的返回值可以为 null，不强制返回空 合，或者空对象等，必 添加注释充分说
+
+明什么情况下会返回 null 值
+
+说明：本手册明确 止 NPE 是调用者的责任 即使被调用方法返回空 合或者空对象，对调用者来说，也
+
+并  无 ，必 考虑到远程调用失败 序列化失败 运行时异常等场景返回 null 的情况
+
+11. 推荐 止 NPE，是程序员的基本修 ，注意 NPE 产生的场景：
+
+      1） 返回类型为基本数据类型，return 包装数据类型的对象时，自动拆箱有可能产生 NPE
+           反例：public int f() { return Integer 对象}， 如果为 null，自动解箱抛 NPE
+
+      2） 数据库的查询结果可能为 null
+      3） 合里的元素即使 isNotEmpty，取出的数据元素也可能为 null
+      4） 远程调用返回对象时， 律要求进行空指针判断， 止 NPE
+      5） 对于 Session 中获取的数据，建议进行 NPE 检查，避免空指针
+      6） 级联调用 obj.getA().getB().getC()； 连串调用，易产生 NPE
+     正例：使用 JDK8 的 Optional 类来 止 NPE
+
+                                                                                   31/59
+                                                                              Java 开发手册
+
+    12. 推荐 定义时区分 unchecked / checked 异常，避免直接抛出 new RuntimeException()，
+         更不允许抛出 Exception 或者 Throwable，应使用有业务含义的自定义异常 推荐业界已定
+         义过的自定义异常，如：DAOException / ServiceException 等
+
+    13. 参考 对于公司外的 http/api 开放接口必 使用 errorCode；而应用内部推荐异常抛出；
+         跨应用 RPC 调用优先考虑使用 Result 方式，封装 isSuccess()方法 errorCode
+         errorMessage；而应用内部直接抛出异常即可
+
+          说明：关于 RPC 方法返回方式使用 Result 方式的理由：
+           1）使用抛异常返回方式，调用方如果没有捕获到就会产生运行时错误
+           2）如果不加栈信息，只是 new 自定义异常，加入自己的理解的 error message，对于调用端解决
+          的帮助不会太多 如果加了栈信息，在 繁调用出错的情况下，数据序列化和传输的性能损耗也是
+
+(三) 日志规约
+
+    1. 强制 应用中不可直接使用日志系统（Log4j Logback）中的 API，而应依赖使用日志框架
+         （SLF4J JCL--Jakarta Commons Logging）中的 API，使用 模式的日志框架，有利于维护和
+         各个类的日志处理方式统
+
+          说明：日志框架（SLF4J JCL--Jakarta Commons Logging）的使用方式（推荐使用 SLF4J）
+               使用 SLF4J：
+
+                 import org.slf4j.Logger;
+                 import org.slf4j.LoggerFactory;
+                 private static final Logger logger = LoggerFactory.getLogger(Test.class);
+
+              使用 JCL：
+
+                 import org.apache.commons.logging.Log;
+                 import org.apache.commons.logging.LogFactory;
+                 private static final Log log = LogFactory.getLog(Test.class);
+
+    2. 强制 所有日志文件至少保存 15 天，因为有些异常具备以“周”为 次发生的特点 对于
+         当天日志，以“应用名.log”来保存，保存在/home/admin/应用名/logs/目录下，过往日志
+         格式为: {logname}.log.{保存日期}，日期格式：yyyy-MM-dd
+
+          正例：以 aap 应用为例，日志保存在/home/admin/aapserver/logs/aap.log，历史日志名称为
+          aap.log.2016-08-01
+
+    3. 强制 根据国家法律，网络运行状态 网络安全事件 个人敏感信息操作等相关记录，留存
+         的日志不少于六个月，并且进行网络多机备份
+
+    4. 强制 应用中的扩展日志（如打点 临时监控 访 日志等）命名方式：
+
+          appName_logType_logName.log logType:日志类型，如 stats/monitor/access 等；logName:日志描
+          述 这种命名的好处：通过文件名就可知道日志文件属于什么应用，什么类型，什么目的，也有利于归类查
+          找
+
+                                                                                                                                                                         32/59
+                                                                        Java 开发手册
+
+     说明：推荐对日志进行分类，如将错误日志和业务日志分开存放，便于开发人员查看，也便于通过日志对系
+     统进行及时监控
+     正例：mppserver 应用中单独监控时区转换异常，如：mppserver_monitor_timeZoneConvert.log
+
+5. 强制 在日志输出时，字符串变量之 的拼接使用占位符的方式
+
+     说明：因为 String 字符串的拼接会使用 StringBuilder 的 append()方式，有 定的性能损耗 使用占位符仅
+     是替换动作，可以有效提升性能
+     正例：logger.debug("Processing trade with id: {} and symbol: {}", id, symbol);
+
+6. 强制 对于 trace/debug/info 级别的日志输出，必 进行日志级别的开关判断
+
+     说明：虽然在 debug(参数)的方法体内第 行代码 isDisabled(Level.DEBUG_INT)为真时（Slf4j 的常见实现
+     Log4j 和 Logback），就直接 return，但是参数可能会进行字符串拼接运算 此外，如果 debug(getName())
+     这种参数内有 getName()方法调用，无谓浪费方法调用的开销
+     正例：
+
+          // 如果判断为真，那么可以输出 trace 和 debug 级别的日志
+          if (logger.isDebugEnabled()) {
+
+                logger.debug("Current ID is: {} and name is: {}", id, getName());
+          }
+
+7. 强制 避免重复打印日志，浪费磁盘空 ，务必在日志配置文件中设置 additivity=false
+
+     正例：<logger name="com.taobao.dubbo.config" additivity="false">
+
+8. 强制 生产环境禁止直接使用 System.out 或 System.err 输出日志或使用
+    e.printStackTrace()打印异常堆栈
+
+     说明：标准日志输出与标准错误输出文件每次 Jboss 重启时才滚动，如果大量输出送往这两个文件，容易
+     造成文件大小超过操作系统大小 制
+
+9. 强制 异常信息应该包括两类信息：案发现场信息和异常堆栈信息 如果不处理，那么通过
+    关 字 throws 往上抛出
+
+     正例：logger.error("inputParams:{} and errorMessage:{}", 各类参数或者对象 toString(), e.getMessage(), e);
+
+10. 强制 日志打印时禁止直接用 JSON 工具将对象转换成 String
+
+     说明：如果对象里某些 get 方法被覆写，存在抛出异常的情况，则可能会因为打印日志而影响正常业务流
+     程的执行
+     正例：打印日志时仅打印出业务相关属性值或者调用其对象的 toString()方法
+
+11. 推荐 慎地记录日志 生产环境禁止输出 debug 日志；有选择地输出 info 日志；如果使用
+    warn 来记录刚上线时的业务行为信息， 定要注意日志输出量的 ，避免把服务器磁盘
+    爆，并记得及时删 这些观察日志
+
+     说明：大量地输出无效日志，不利于系统性能提升，也不利于快速定位错误点 记录日志时请思考：这些
+     日志真的有人看吗？看到这条日志你能做什么？能不能给 排查带来好处？
+
+                                                                                                                                                                   33/59
+                                                                        Java 开发手册
+
+12. 推荐 可以使用 warn 日志级别来记录用户输入参数错误的情况，避免用户投诉时，无所适
+    从 如 必要，请不要在此场景打出 error 级别，避免 繁报警
+
+     说明：注意日志输出的级别，error 级别只记录系统逻辑出错 异常或者重要的错误信息
+
+13. 推荐 尽量用英文来描述日志错误信息，如果日志中的错误信息用英文描述不清楚的话使用
+
+中文描述即可，否则容易产生歧义
+
+说明：国 化团 或海外部署的服务器由于字符  ，使用全英文来注释和描述日志错误信息
+
+                                           34/59
+           Java 开发手册
+
+三 单元测试
+
+1. 强制 好的单元测试必 遵守 AIR 原则
+
+     说明：单元测试在线上运行时，感觉像空气（AIR） 样感觉不到，但在测试质量的保 上，却是 常关
+     的 好的单元测试宏观上来说，具有自动化 独立性 可重复执行的特点
+
+          z A：Automatic（自动化）
+          z I：Independent（独立性）
+          z R：Repeatable（可重复）
+
+2. 强制 单元测试应该是全自动执行的，并且 交互式的 测试用例通常是被定期执行的，执
+    行过程必 完全自动化才有意义 输出结果 要人工检查的测试不是 个好的单元测试 单元
+    测试中不准使用 System.out 来进行人肉 证，必 使用 assert 来 证
+
+3. 强制 保持单元测试的独立性 为了保证单元测试稳定可 且便于维护，单元测试用例之
+    决不能互相调用，也不能依赖执行的先后次序
+
+     反例：method2 要依赖 method1 的执行，将执行结果作为 method2 的输入
+
+4. 强制 单元测试是可以重复执行的，不能受到外界环境的影响
+
+     说明：单元测试通常会被放到持续 成中，每次有代码 check in 时单元测试都会被执行 如果单测对外部
+     环境（网络 服务 中 件等）有依赖，容易导致持续 成机制的不可用
+     正例：为了不受外界环境影响，要求设计代码时就把 SUT 的依赖改成注入，在测试时用 spring 这样的 DI
+     框架注入 个本地（内存）实现或者 Mock 实现
+
+5. 强制 对于单元测试，要保证测试粒度足够小，有助于精确定位  单测粒度至多是类级
+
+别， 般是方法级别
+
+说明：只有测试粒度小才能在出错时尽快定位到出错位置 单测不负责检查跨类或者跨系统的交互逻辑，
+
+那是 成测试的 域
+
+6. 强制 核心业务 核心应用 核心模块的增量代码确保单元测试通过
+
+     说明：新增代码及时补充单元测试，如果新增代码影响了原有单元测试，请及时修正
+
+7. 强制 单元测试代码必 写在如下工程目录：src/test/java，不允许写在业务代码目录下
+
+     说明：源码编译时会跳过此目录，而单元测试框架 认是扫描此目录
+
+8. 推荐 单元测试的基本目标：语句覆盖率达到 70%；核心模块的语句覆盖率和分支覆盖率都
+    要达到 100%
+
+     说明：在工程规约的应用分层中提到的 DAO 层，Manager 层，可重用度 的 Service，都应该进行单元测
+     试
+
+                                            35/59
+                                                                        Java 开发手册
+
+9. 推荐 编写单元测试代码遵守 BCDE 原则，以保证被测试模块的交付质量
+
+          z B：Border，边界值测试，包括循环边界 特殊取值 特殊时 点 数据 序等
+          z C：Correct，正确的输入，并得到 期的结果
+          z D：Design，与设计文档相结合，来编写单元测试
+          z E：Error，强制错误信息输入（如： 法数据 异常流程 业务允许外等），并得到 期的结果
+
+10. 推荐 对于数据库相关的查询，更新，删 等操作，不能假设数据库里的数据是存在的，或
+    者直接操作数据库把数据插入进去，请使用程序插入或者导入数据的方式来准备数据
+
+     反例：删 某 行数据的单元测试，在数据库中，先直接手动增加 行作为删 目标，但是这 行新增数
+     据并不符合业务插入规则，导致测试结果异常
+
+11. 推荐 和数据库相关的单元测试，可以设定自动回滚机制，不给数据库造成脏数据 或者对
+    单元测试产生的数据有明确的前后缀标识
+    正例：在 里巴巴企业智能事业部的内部单元测试中，使用 ENTERPRISE_INTELLIGENCE _UNIT_TEST_
+
+     的前缀来标识单元测试相关代码
+
+12. 推荐 对于不可测的代码在适当的时机做必要的重构，使代码变得可测，避免为了达到测试
+    要求而书写不规范测试代码
+
+13. 推荐 在设计评审 段，开发人员 要和测试人员 起确定单元测试范围，单元测试最好覆
+    盖所有测试用例（UC）
+
+14. 推荐 单元测试作为 种质量保 手段，在 目提测前完成单元测试，不建议 目发布后补
+    充单元测试用例
+
+15. 参考 为了更方便地进行单元测试，业务代码应避免以下情况：
+
+          z 构造方法中做的事情过多
+          z 存在过多的全局变量和 态方法
+          z 存在过多的外部依赖
+          z 存在过多的条件语句
+      说明：多层条件语句建议使用卫语句 策略模式 状态模式等方式重构
+
+16. 参考 不要对单元测试存在如下误解：
+
+          z 那是测试同学干的事情 本文是开发手册，凡是本文内容都是与开发同学强相关的
+          z 单元测试代码是多余的 系统的整体功能与各单元部件的测试正常与否是强相关的
+          z 单元测试代码不 要维护 年半载后，那么单元测试几乎处于废弃状态
+          z 单元测试与线上故 没有辩证关系 好的单元测试能够最大 度地规避线上故
+
+                                                                                                                                                                   36/59
+        Java 开发手册
+
+四 安全规约
+
+1. 强制 属于用户个人的 或者功能必 进行权 控制校
+
+     说明： 止没有做水平权 校 就可 意访 修改 删 别人的数据，比如查看他人的私信内容
+
+2. 强制 用户敏感数据禁止直接展示，必 对展示数据进行脱敏
+
+     说明：中国大 个人手机号码显示：139****1219， 藏中 4 位， 止 私泄
+
+3. 强制 用户输入的 SQL 参数严格使用参数绑定或者 METADATA 字段值 定， 止 SQL 注入，
+    禁止字符串拼接 SQL 访 数据库
+
+     反例：某系统签名大量被恶意修改，即是因为对于危 字符 # --没有进行转义，导致数据库更新时，where
+     后边的信息被注释掉，对全库进行更新
+
+4. 强制 用户请求传入的任何参数必 做有效性 证                       ，但是如果攻击人员使用
+
+     说明：忽略参数校 可能导致：
+          z page size 过大导致内存溢出
+          z 恶意 order by 导致数据库慢查询
+          z 缓存击穿
+          z SSRF
+          z 任意重定向
+          z SQL 注入，Shell 注入，反序列化注入
+          z 正则输入源串拒绝服务 ReDoS
+
+     Java 代码用正则来 证客户端的输入，有些正则写法 证普通用户输入没有
+     的是特殊构造的字符串来 证，有可能导致死循环的结果
+
+5. 强制 禁止向 HTML 输出未经安全过滤或未正确转义的用户数据
+
+6. 强制 表单 AJAX 提交必 执行 CSRF 安全 证
+
+     说明：CSRF(Cross-site request forgery)跨站请求伪造是 类常见编程漏洞 对于存在 CSRF 漏洞的应用/
+     网站，攻击者可以事先构造好 URL，只要受害者用户 访 ，后台便在用户不知情的情况下对数据库中用
+     户参数进行相应修改
+
+7. 强制 URL 外部重定向传入的目标地址必 执行白名单过滤
+
+8. 强制 在使用平台资源， 如短信 邮件 电话 下单 支付，必 实现正确的 重放的机
+    制，如数量 制 劳度控制 证码校 ，避免被滥刷而导致资损
+
+     说明：如注册时发送 证码到手机，如果没有 制次数和 率，那么可以利用此功能 扰到其它用户，并
+     造成短信平台资源浪费
+
+9. 推荐 发贴 评论 发送即时消息等用户生成内容的场景必 实现 刷 文本内容违禁词过
+    滤等 控策略
+
+                                                 37/59
+             Java 开发手册
+
+五 MySQL 数据库
+
+( ) 建表规约
+
+    1. 强制 表达是与否概念的字段，必 使用 is_xxx 的方式命名，数据类型是 unsigned tinyint
+         （1 表示是，0 表示否）
+
+          说明：任何字段如果为 负数，必 是 unsigned
+          注意：POJO 类中的任何布尔类型的变量，都不要加 is 前缀，所以， 要在<resultMap>设置从 is_xxx 到
+          Xxx 的映射关系 数据库表示是与否的值，使用 tinyint 类型，坚持 is_xxx 的命名方式是为了明确其取值含
+          义与取值范围
+          正例：表达逻辑删 的字段名 is_deleted，1 表示删 ，0 表示未删
+
+    2. 强制 表名 字段名必 使用小写字母或数字，禁止出现数字开头，禁止两个下划线中 只
+         出现数字 数据库字段名的修改代价很大，因为无法进行 发布，所以字段名称 要慎重考虑
+
+          说明：MySQL 在 Windows 下不区分大小写，但在 Linux 下 认是区分大小写 因此，数据库名 表名
+          字段名，都不允许出现任何大写字母，避免节外生枝
+          正例：aliyun_admin，rdc_config，level3_name
+          反例：AliyunAdmin，rdcConfig，level_3_name
+
+    3. 强制 表名不使用复数名词
+
+          说明：表名应该仅仅表示表里 的实体内容，不应该表示实体数量，对应于 DO 类名也是单数形式，符合
+          表达习惯
+
+    4. 强制 禁用保留字，如 desc range match delayed 等，请参考 MySQL 官方保留字
+
+    5. 强制 主 索引名为 pk_字段名；唯 索引名为 uk_字段名；普通索引名则为 idx_字段名
+
+          说明：pk_ 即 primary key；uk_ 即 unique key；idx_ 即 index 的简称
+
+    6. 强制 小数类型为 decimal，禁止使用 float 和 double
+
+          说明：在存储的时候，float 和 double 都存在精度损失的 ，很可能在比较值的时候，得到不正确的
+          结果 如果存储的数据范围超过 decimal 的范围，建议将数据拆成整数和小数并分开存储
+
+    7. 强制 如果存储的字符串 度几乎相等，使用 char 定 字符串类型
+
+    8. 强制 varchar 是可变 字符串，不 先分配存储空 ， 度不要超过 5000，如果存储 度
+         大于此值，定义字段类型为 text，独立出来 张表，用主 来对应，避免影响其它字段索引效
+         率
+
+    9. 强制 表必备三字段：id, create_time, update_time
+
+          说明：其中 id 必为主 ，类型为 bigint unsigned 单表时自增 步 为 1 create_time, update_time
+          的类型均为 datetime 类型，前者现在时表示主动式创建，后者过去分词表示被动式更新
+
+                                                                                                                                                                         38/59
+                                                                        Java 开发手册
+
+10. 推荐 表的命名最好是遵循“业务名称_表的作用”
+
+     正例：alipay_task / force_project / trade_config
+
+11. 推荐 库名与应用名称尽量 致
+
+12. 推荐 如果修改字段含义或对字段表示的状态追加时， 要及时更新字段注释
+
+13. 推荐 字段允许适当冗余，以提 查询性能，但必 考虑数据 致 冗余字段应遵循：
+
+      1） 不是 繁修改的字段
+      2） 不是唯 索引的字段
+      3） 不是 varchar 超 字段，更不能是 text 字段
+     正例：各业务线经常冗余存储商品名称，避免查询时 要调用 IC 服务获取
+
+14. 推荐 单表行数超过 500 万行或者单表容量超过 2GB，才推荐进行分库分表
+
+     说明：如果 计三年后的数据量根本达不到这个级别，请不要在创建表时就分库分表
+
+15. 参考 合适的字符存储 度，不但节约数据库表空                                                            节约索引存储，更重要的是提升检索
+    速度
+
+     正例：无符号值可以避免误存负数，且扩大了表示范围
+
+   对象    年区             类型         字节                                                              表示范围
+
+人      150 岁之内  tinyint unsigned     1                                                无符号值：0 到 255
+
+       数百岁      smallint unsigned                                                  2  无符号值：0 到 65535
+
+   化石  数千万年     int unsigned                                                       4  无符号值：0 到约 43 亿
+
+太      约 50 亿年  bigint unsigned                                                    8  无符号值：0 到约 10 的 19 次方
+
+(二) 索引规约
+
+    1. 强制 业务上具有唯 特性的字段，即使是组合字段，也必 建成唯 索引
+
+          说明：不要以为唯 索引影响了 insert 速度，这个速度损耗可以忽略，但提 查找速度是明显的；另外，
+          即使在应用层做了 常完善的校 控制，只要没有唯 索引，根据墨菲定律，必然有脏数据产生
+
+    2. 强制 超过三个表禁止 join 要 join 的字段，数据类型保持绝对 致；多表关联查询时，
+         保证被关联的字段 要有索引
+
+          说明：即使双表 join 也要注意表索引 SQL 性能
+
+    3. 强制 在 varchar 字段上建立索引时，必 指定索引 度，没必要对全字段建立索引，根据
+         实 文本区分度决定索引 度
+
+                                                                                                                                                                         39/59
+                                                                  Java 开发手册
+
+说明：索引的 度与区分度是 对矛盾体， 般对字符串类型数据， 度为 20 的索引，区分度会 达 90%
+以上，可以使用 count(distinct left(列名, 索引 度))/count(*)的区分度来确定
+
+4. 强制  搜索严禁左模糊或者全模糊，如果 要请走搜索引擎来解决
+
+说明：索引文件具有 B-Tree 的最左前缀匹配特性，如果左边的值未确定，那么无法使用此索引
+
+5. 推荐 如果有 order by 的场景，请注意利用索引的有序性 order by 最后的字段是组合索
+    引的 部分，并且放在索引组合 序的最后，避免出现 file_sort 的情况，影响查询性能
+
+     正例：where a=? and b=? order by c; 索引：a_b_c
+     反例：索引如果存在范围查询，那么索引有序性无法利用，如：WHERE a>10 ORDER BY b; 索引 a_b 无
+     法排序
+
+6. 推荐 利用覆盖索引来进行查询操作，避免回表
+
+     说明：如果 本书 要知道第 11 章是什么标 ，会翻开第 11 章对应的那 吗？目录浏览 下就好，这
+     个目录就是起到覆盖索引的作用
+     正例：能够建立索引的种类分为主 索引 唯 索引 普通索引三种，而覆盖索引只是 种查询的 种效
+     果，用 explain 的结果，extra 列会出现：using index
+
+7. 推荐 利用延迟关联或者子查询优化超多分 场景
+
+     说明：MySQL 并不是跳过 offset 行，而是取 offset+N 行，然后返回放弃前 offset 行，返回 N 行，那当
+     offset 特别大的时候，效率就 常的低下，要么控制返回的总 数，要么对超过特定 值的 数进行 SQL
+     改写
+     正例：先快速定位 要获取的 id 段，然后再关联：
+
+               SELECT t1.* FROM 表 1 as t1, (select id from 表 1 where 条件 LIMIT 100000,20 ) as t2 where t1.id=t2.id
+
+8. 推荐 SQL 性能优化的目标：至少要达到 range 级别，要求是 ref 级别，如果可以是 consts
+    最好
+
+     说明：
+      1） consts 单表中最多只有 个匹配行（主 或者唯 索引），在优化 段即可读取到数据
+      2） ref 指的是使用普通的索引（normal index）
+      3） range 对索引进行范围检索
+     反例：explain 表的结果，type=index，索引物理文件全扫描，速度 常慢，这个 index 级别比较 range
+     还低，与全表扫描是小 见大
+
+9. 推荐 建组合索引的时候，区分度最 的在最左边
+
+     正例：如果 where a=? and b=?，a 列的几乎接近于唯 值，那么只 要单建 idx_a 索引即可
+     说明：存在 等号和等号混合判断条件时，在建索引时，请把等号条件的列前置 如：where c>? and d=?
+     那么即使 c 的区分度更 ，也必 把 d 放在索引的最前列，即建立组合索引 idx_d_c
+
+10. 推荐 止因字段类型不同造成的 式转换，导致索引失效
+
+                                                40/59
+                                                                              Java 开发手册
+
+    11. 参考 创建索引时避免有如下极端误解：
+
+           1） 索引宁滥勿缺 认为 个查询就 要建 个索引
+           2） 索引的创建 认为索引会消耗空 严重拖慢记录的更新以及行的新增速度
+           3） 抵制惟 索引 认为惟 索引 律 要在应用层通过“先查后插”方式解决
+
+(三) SQL 语句
+
+    1. 强制 不要使用 count(列名)或 count(常量)来替代 count(*)，count(*)是 SQL92 定义的标
+         准统计行数的语法，跟数据库无关，跟 NULL 和 NULL 无关
+
+          说明：count(*)会统计值为 NULL 的行，而 count(列名)不会统计此列为 NULL 值的行
+
+    2. 强制 count(distinct col) 计算该列 NULL 之外的不重复行数，注意 count(distinct col1,
+         col2) 如果其中 列全为 NULL，那么即使另 列有不同的值，也返回为 0
+
+    3. 强制 当某 列的值全是 NULL 时，count(col)的返回结果为 0，但 sum(col)的返回结果为
+         NULL，因此使用 sum()时 注意 NPE
+
+          正例：可以使用如下方式来避免 sum 的 NPE ：SELECT IFNULL(SUM(column), 0) FROM table;
+
+    4. 强制 使用 ISNULL()来判断是否为 NULL 值
+
+          说明：NULL 与任何值的直接比较都为 NULL
+           1） NULL<>NULL 的返回结果是 NULL，而不是 false
+           2） NULL=NULL 的返回结果是 NULL，而不是 true
+           3） NULL<>1 的返回结果是 NULL，而不是 true
+          反例：在 SQL 语句中，如果在 null 前换行，影响可读性 select * from table where column1 is null and
+          column3 is not null; 而`ISNULL(column)`是 个整体，简洁易懂 从性能数据上分析，`ISNULL(column)`
+          执行效率更快 些
+
+    5. 强制 代码中写分 查询逻辑时，若 count 为 0 应直接返回，避免执行后 的分 语句
+    6. 强制 不得使用外 与级联， 切外 概念必 在应用层解决
+
+          说明：（概念解释）学生表中的 student_id 是主 ，那么成 表中的 student_id 则为外 如果更新学
+          生表中的 student_id，同时触发成 表中的 student_id 更新，即为级联更新 外 与级联更新适用于单机
+          低并发，不适合分布式 并发 群；级联更新是强 塞，存在数据库更新 暴的 ；外 影响数据库
+          的插入速度
+
+    7. 强制 禁止使用存储过程，存储过程 以调试和扩展，更没有移植性
+    8. 强制 数据订正（特别是删 或修改记录操作）时，要先 select，避免出现误删 ，确认无
+
+         误才能执行更新语句
+
+                                                                                                                                                                         41/59
+                                                                              Java 开发手册
+
+    9. 强制 对于数据库中表记录的查询和变更，只要涉及多个表，都 要在列名前加表的别名（或
+         表名）进行 定
+
+          说明：对多表进行查询记录 更新记录 删 记录时，如果对操作列没有 定表的别名（或表名），并且
+          操作列在多个表中存在时，就会抛异常
+          正例：select t1.name from table_first as t1 , table_second as t2 where t1.id=t2.id;
+          反例：在某业务中，由于多表关联查询语句没有加表的别名（或表名）的 制，正常运行两年后，最近在
+          某个表中增加 个同名字段，在 发布环境做数据库变更后，线上查询语句出现出 1052 异常：Column
+          'name' in field list is ambiguous
+
+    10. 推荐 SQL 语句中表的别名前加 as，并且以 t1 t2 t3 ...的 序依次命名
+
+          说明：1）别名可以是表的简称，或者是依照表在 SQL 语句中出现的 序，以 t1 t2 t3 的方式命名 2）
+          别名前加 as 使别名更容易识别
+          正例：select t1.name from table_first as t1, table_second as t2 where t1.id=t2.id;
+
+    11. 推荐 in 操作能避免则避免，若实在避免不了， 要仔细评估 in 后边的 合元素数量，控
+         制在 1000 个之内
+
+    12. 参考 因国 化 要，所有的字符存储与表示，均采用 utf8 字符 ，那么字符计数方法
+         要注意
+
+          说明：
+                   SELECT LENGTH("轻松工作")； 返回为 12
+                   SELECT CHARACTER_LENGTH("轻松工作")； 返回为 4
+                   如果 要存储表情，那么选择 utf8mb4 来进行存储，注意它与 utf8 编码的区别
+
+    13. 参考 TRUNCATE TABLE 比 DELETE 速度快，且使用的系统和事务日志资源少，但 TRUNCATE
+         无事务且不触发 trigger，有可能造成事故，故不建议在开发代码中使用此语句
+
+          说明：TRUNCATE TABLE 在功能上与不带 WHERE 子句的 DELETE 语句相同
+
+(四) ORM 映射
+
+    1. 强制 在表查询中， 律不要使用 * 作为查询的字段列表， 要哪些字段必 明确写明
+
+          说明：1）增加查询分析器解析成本 2）增减字段容易与 resultMap 配置不 致 3）无用字段增加网络
+          消耗，尤其是 text 类型的字段
+
+    2. 强制 POJO 类的布尔属性不能加 is，而数据库字段必 加 is_，要求在 resultMap 中进行
+         字段与属性之 的映射
+
+          说明：参见定义 POJO 类以及数据库字段定义规定，在 sql.xml 增加映射，是必 的
+
+                                                                                                                                                                         42/59
+                                                                        Java 开发手册
+
+3. 强制 不要用 resultClass 当返回参数，即使所有类属性名与数据库字段 对应，也 要
+    定义<resultMap>；反过来，每 个表也必然有 个<resultMap>与之对应
+
+     说明：配置映射关系，使字段与 DO 类解 ，方便维护
+
+4. 强制 sql.xml 配置参数使用：#{}，#param# 不要使用${} 此种方式容易出现 SQL 注入
+5. 强制 iBATIS 自带的 queryForList(String statementName,int start,int size)不推荐使用
+
+     说明：其实现方式是在数据库取到 statementName 对应的 SQL 语句的所有记录，再通过 subList 取
+     start,size 的子 合
+     正例：
+
+          Map<String, Object> map = new HashMap<>(16);
+          map.put("start", start);
+          map.put("size", size);
+
+6. 强制 不允许直接拿 HashMap 与 Hashtable 作为查询结果 的输出
+
+     反例：某同学为避免写 个<resultMap>xxx</resultMap>，直接使用 HashTable 来接收数据库返回结
+     果，结果出现日常是把 bigint 转成 Long 值，而线上由于数据库版本不 样，解析成 BigInteger，导致线
+     上
+
+7. 强制 更新数据表记录时，必 同时更新记录对应的 update_time 字段值为当前时
+8. 推荐 不要写 个大而全的数据更新接口 传入为 POJO 类，不管是不是自己的目标更新字
+
+    段，都进行 update table set c1=value1,c2=value2,c3=value3; 这是不对的 执行 SQL 时，
+    不要更新无改动的字段， 是易出错；二是效率低；三是增加 binlog 存储
+9. 参考 @Transactional 事务不要滥用 事务会影响数据库的 QPS，另外使用事务的地方
+    要考虑各方 的回滚方案，包括缓存回滚 搜索引擎回滚 消息补偿 统计修正等
+10. 参考 <isEqual>中的 compareValue 是与属性值对比的常量， 般是数字，表示相等时
+    带上此条件；<isNotEmpty>表示不为空且不为 null 时执行；<isNotNull>表示不为 null 值
+    时执行
+
+                                                                                                                                                                   43/59
+        Java 开发手册
+
+六 工程结构
+
+( ) 应用分层
+
+    1. 推荐 根据业务架构实践，结合业界分层规范与流行技术框架分析，推荐分层结构如图所示，
+            认上层依赖于下层，箭头关系表示可直接依赖，如：开放 API 层可以依赖于 Web 层
+
+         （Controller 层），也可以直接依赖于 Service 层，依此类推：
+
+      x 开放 API 层：可直接封装 Service 接口暴 成 RPC 接口；通过 Web 封装成 http 接口；网关控制层等
+      x 终端显示层：各个端的模板 染并执行显示的层 当前主要是 velocity 染，JS 染，JSP 染，移
+
+           动端展示等
+      x Web 层：主要是对访 控制进行转发，各类基本参数校 ，或者不复用的业务简单处理等
+      x Service 层：相对具体的业务逻辑服务层
+      x Manager 层：通用业务处理层，它有如下特征：
+
+               1） 对第三方平台封装的层， 处理返回结果及转化异常信息，适配上层接口
+               2） 对 Service 层通用能力的下沉，如缓存方案 中 件通用处理
+               3） 与 DAO 层交互，对多个 DAO 的组合复用
+      x DAO 层：数据访 层，与底层 MySQL Oracle Hbase OB 等进行数据交互
+      x 第三方服务：包括其它部 RPC 服务接口，基础平台，其它公司的 HTTP 接口，如淘宝开放平台 支
+           付宝付款服务 德地图服务等
+      x 外部数据接口：外部（应用）数据存储服务提供的接口，多见于数据迁移场景中
+
+2. 参考 （分层异常处理规约）在 DAO 层，产生的异常类型有很多，无法用细粒度的异常进
+    行 catch，使用 catch(Exception e)方式，并 throw new DAOException(e)，不 要打印日志，因
+    为日志在 Manager/Service 层 定 要捕获并打印到日志文件中去，如果同台服务器再打日志，
+
+                                                                                                                                                                   44/59
+                                                                              Java 开发手册
+
+         浪费性能和存储 在 Service 层出现异常时，必 记录出错日志到磁盘，尽可能带上参数信息，
+         相当于保护案发现场 Manager 层与 Service 同机部署，日志方式与 DAO 层处理 致，如果是
+         单独部署，则采用与 Service 致的处理方式 Web 层绝不应该继续往上抛异常，因为已经处
+         于 层，如果意识到这个异常将导致 无法正常 染，那么就应该直接跳转到友好错误 ，
+         尽量加上友好的错误提示信息 开放接口层要将异常处理成错误码和错误信息方式返回
+    3. 参考 分层 域模型规约：
+
+          x DO（Data Object）：此对象与数据库表结构 对应，通过 DAO 层向上传输数据源对象
+          x DTO（Data Transfer Object）：数据传输对象，Service 或 Manager 向外传输的对象
+          x BO（Business Object）：业务对象，可以由 Service 层输出的封装业务逻辑的对象
+          x Query：数据查询对象，各层接收上层的查询请求 注意超过 2 个参数的查询封装，禁止使用 Map 类
+
+               来传输
+          x VO（View Object）：显示层对象，通常是 Web 向模板 染引擎层传输的对象
+
+(二) 二方库依赖
+
+    1. 强制 定义 GAV 遵从以下规则：
+
+           1） GroupID 格式：com.{公司/BU }.业务线 [.子业务线]，最多 4 级
+             说明：{公司/BU} 例如：alibaba/taobao/tmall/aliexpress 等 BU 级；子业务线可选
+             正例：com.taobao.jstorm 或 com.alibaba.dubbo.register
+
+           2） ArtifactID 格式：产品线名-模块名 语义不重复不遗漏，先到中央仓库去查证 下
+             正例：dubbo-client / fastjson-api / jstorm-tool
+
+           3） Version：详细规定参考下方
+
+    2. 强制 二方库版本号命名方式：主版本号.次版本号.修订号
+
+           1）主版本号：产品方向改变，或者大规模 API 不兼容，或者架构不兼容升级
+           2） 次版本号：保持相对兼容性，增加主要功能特性，影响范围极小的 API 不兼容修改
+           3） 修订号：保持完全兼容性，修复 BUG 新增次要功能特性等
+          说明：注意起始版本号必 为：1.0.0，而不是 0.0.1
+          反例：仓库内某二方库版本号从 1.0.0.0 开始， 直 “升级”成 1.0.0.64，完全失去版本的语义信息
+
+    3. 强制 线上应用不要依赖 SNAPSHOT 版本（安全包 外）；正式发布的类库必 先去中央仓
+         库进行查证，使 RELEASE 版本号有延续性，且版本号不允许覆盖升级
+
+          说明：不依赖 SNAPSHOT 版本是保证应用发布的 等性 另外，也可以加快编译时的打包构建
+
+    4. 强制 二方库的新增或升级，保持 功能点之外的其它 jar 包仲裁结果不变 如果有改变，
+         必 明确评估和 证
+
+                                                                                                                                                                         45/59
+                                                                              Java 开发手册
+
+          说明：在升级时，进行 dependency:resolve 前后信息比对，如果仲裁结果完全不 致，那么通过
+          dependency:tree 命令，找出差异点，进行<exclude>排 jar 包
+
+    5. 强制 二方库里可以定义枚举类型，参数可以使用枚举类型，但是接口返回值不允许使用枚
+         举类型或者包含枚举类型的 POJO 对象
+
+    6. 强制 依赖于 个二方库群时，必 定义 个统 的版本变量，避免版本号不 致
+
+          说明：依赖 springframework-core,-context,-beans，它们都是同 个版本，可以定义 个变量来保存版
+          本：${spring.version}，定义依赖的时候，引用该版本
+
+    7. 强制 禁止在子 目的 pom 依赖中出现相同的 GroupId，相同的 ArtifactId，但是不同的
+
+          Version
+          说明：在本地调试时会使用各子 目指定的版本号，但是合并成 个 war，只能有 个版本号出现在最后的
+          lib 目录中 曾经出现过线下调试是正确的，发布到线上却出故 的先例
+
+    8. 推荐 底层基础技术框架 核心数据管理平台 或近硬件端系统 慎引入第三方实现
+    9. 推荐 所有 pom 文件中的依赖声明放在<dependencies>语句块中，所有版本仲裁放在
+
+         <dependencyManagement>语句块中
+
+          说明：<dependencyManagement>里只是声明版本，并不实现引入，因此子 目 要显式的声明依赖，
+          version 和 scope 都读取自父 pom 而<dependencies>所有声明在主 pom 的<dependencies>里的依
+          赖都会自动引入，并 认被所有的子 目继承
+
+    10. 推荐 二方库不要有配置 ，最低 度不要再增加配置
+    11. 推荐 不要使用不稳定的工具包或者 Utils 类
+
+          说明：不稳定指的是提供方无法做到向下兼容，在编译 段正常，但在运行时产生异常，因此，尽量使用
+          业界稳定的二方工具包
+
+    12. 参考 为避免应用二方库的依赖冲突 ，二方库发布者应当遵循以下原则：
+
+          1）精简可控原则 移 切不必要的 API 和依赖，只包含 Service API 必要的 域模型对象 Utils 类
+          常量 枚举等 如果依赖其它二方库，尽量是 provided 引入，让二方库使用者去依赖具体版本号；无 log
+          具体实现，只依赖日志框架
+          2）稳定可 原则 每个版本的变化应该被记录，二方库由谁维护，源码在哪里，都 要能方便查到
+
+             用户主动升级版本，否则公共二方库的行为不应该发生变化
+
+(三) 服务器
+
+    1. 推荐 并发服务器建议调小 TCP 协议的 time_wait 超时时
+
+          说明：操作系统 认 240 秒后，才会关 处于 time_wait 状态的连接，在 并发访 下，服务器端会因为
+          处于 time_wait 的连接数太多，可能无法建立新的连接，所以 要在服务器上调小此等待值
+
+                                                                                                                                                                         46/59
+               Java 开发手册
+
+正例：在 linux 服务器上请通过变更/etc/sysctl.conf 文件去修改该缺省值（秒）：
+       net.ipv4.tcp_fin_timeout = 30
+
+2. 推荐 调大服务器所支持的最大文件句柄数（File Descriptor，简写为 fd）
+
+说明：主流操作系统的设计是将 TCP/UDP 连接采用与文件 样的方式去管理，即 个连接对应于 个 fd
+
+主流的 linux 服务器 认所支持最大 fd 数量为 1024，当并发连接数很大时很容易因为 fd 不足而出现“open
+
+too many files”错误，导致新的连接无法建立 建议将 linux 服务器所支持的最大句柄数调 数倍（与服
+
+务器的内存数量相关）
+
+3. 推荐 给 JVM 环境参数设置-XX:+HeapDumpOnOutOfMemoryError 参数，让 JVM 碰到 OOM
+
+场景时输出 dump 信息
+
+说明：OOM 的发生是有概率的，甚至相 数月才出现 例，出错时的堆内信息对解决             常有帮助
+
+4. 推荐 在线上生产环境，JVM 的 Xms 和 Xmx 设置 样大小的内存容量，避免在 GC 后调整
+    堆大小带来的压力
+
+5. 参考 服务器内部重定向必 使用 forward；外部重定向地址必 使用 URL Broker 生成，否
+    则因线上采用 HTTPS 协议而导致浏览器提示“不安全“ 此外，还会带来 URL 维护不 致的
+
+                                                    47/59
+        Java 开发手册
+
+七 设计规约
+
+1. 强制 存储方案和底层数据结构的设计获得评审 致通过，并沉淀成为文档
+
+     说明：有缺 的底层数据结构容易导致系统 上升，可扩展性下 ，重构成本也会因历史数据迁移和系
+     统平滑过渡而 然增加，所以，存储方案和数据结构 要认真地进行设计和评审，生产环境提交执行后，
+
+        要进行 double check
+     正例：评审内容包括存储介质选型 表结构设计能否满足技术方案 存取性能和存储空 能否满足业务发
+     展 表或字段之 的辩证关系 字段名称 字段类型 索引等；数据结构变更（如在原有表中新增字段）
+     也 要进行评审通过后上线
+
+2. 强制 在 求分析 段，如果与系统交互的 User 超过 类并且相关的 User Case 超过 5 个，
+    使用用例图来表达更加清晰的结构化 求
+
+3. 强制 如果某个业务对象的状态超过 3 个，使用状态图来表达并且明确状态变化的各个触发
+    条件
+
+     说明：状态图的核心是对象状态， 先明确对象有多少种状态，然后明确两两状态之 是否存在直接转换
+     关系，再明确触发状态转换的条件是什么
+     正例：淘宝订单状态有已下单 待付款 已付款 待发货 已发货 已收货等 比如已下单与已收货这两
+     种状态之 是不可能有直接转换关系的
+
+4. 强制 如果系统中某个功能的调用链路上的涉及对象超过 3 个，使用时序图来表达并且明确
+    各调用环节的输入与输出
+
+     说明：时序图反映了 系列对象 的交互与协作关系，清晰立体地反映系统的调用纵深链路
+
+5. 强制 如果系统中模型类超过 5 个，并且存在复杂的依赖关系，使用类图来表达并且明确类
+    之 的关系
+
+     说明：类图像建筑 域的施工图，如果搭平房，可能不 要，但如果建造 Z 空 大楼，肯定 要详细
+     的施工图
+
+6. 强制 如果系统中超过 2 个对象之 存在协作关系，并且 要表示复杂的处理流程，使用活
+    动图来表示
+
+     说明：活动图是流程图的扩展，增加了能够体现协作关系的对象 道，支持表示并发等
+
+7. 推荐 系统架构设计时明确以下目标：
+
+          z 确定系统边界 确定系统在技术层 上的做与不做
+          z 确定系统内模块之 的关系 确定模块之 的依赖关系及模块的宏观输入与输出
+          z 确定指导后续设计与演化的原则 使后续的子系统或模块设计在 个既定的框架内和技术方向上继
+
+               续演化
+
+                                                                                                                                                                   48/59
+z 确定 功能性 求                    Java 开发手册
+
+            功能性 求是指安全性 可用性 可扩展性等
+
+8. 推荐 求分析与系统设计在考虑主干功能的同时， 要充分评估异常流程与业务边界
+
+     反例：用户在淘宝付款过程中，银行扣款成功，发送给用户扣款成功短信，但是支付宝入款时由于断网演
+     练产生异常，淘宝订单 依然显示未付款，导致用户投诉
+
+9. 推荐 类在设计与实现时要符合单 原则
+
+     说明：单 原则最易理解却是最 实现的 条规则， 着系统演进，很多时候，忘记了类设计的初衷
+
+10. 推荐 慎使用继承的方式来进行扩展，优先使用聚合/组合的方式来实现
+
+     说明：不得已使用继承的话，必 符合里氏代换原则，此原则说父类能够出现的地方子类 定能够出现，
+     比如，“把钱交出来”，钱的子类美元 欧元 人民币等都可以出现
+
+11. 推荐 系统设计 段，根据依赖倒置原则，尽量依赖抽象类与接口，有利于扩展与维护
+
+     说明：低层次模块依赖于 层次模块的抽象，方便系统 的解
+
+12. 推荐 系统设计 段，注意对扩展开放，对修改 合
+
+     说明：极端情况下，交付的代码是不可修改的，同 业务域内的 求变化，通过模块或类的扩展来实现
+
+13. 推荐 系统设计 段，共性业务或公共行为抽取出来公共模块 公共配置 公共类 公共方
+    法等，在系统中不出现重复代码的情况，即 DRY 原则（Don't Repeat Yourself）
+
+     说明： 着代码的重复次数不断增加，维护成本指数级上升 意复制和粘贴代码，必然会导致代码的重复，
+     在维护代码时， 要修改所有的副本，容易遗漏 必要时抽取共性方法，或者抽象公共类，甚至是组件化
+     正例： 个类中有多个 public 方法，都 要进行数行相同的参数校 操作，这个时候请抽取：
+
+               private boolean checkParam(DTO dto) {...}
+
+14. 推荐 避免如下误解：敏捷开发 = 讲故事 + 编码 + 发布
+
+     说明：敏捷开发是快速交付迭代可用的系统，省略多余的设计方案， 弃传统的审批流程，但核心关 点上
+     的必要设计和文档沉淀是 要的
+     反例：某团 为了业务快速发展，敏捷成了产品经理 进度的借口，系统中均是 强能运行但像 条 样
+     的代码，可维护性和可扩展性极差， 年之后，不得不进行大规模重构，得不偿失
+
+15. 参考 设计文档的作用是明确 求 理 逻辑 后期维护，次要目的用于指导编码
+
+     说明：避免为了设计而设计，系统设计文档有助于后期的系统维护和重构，所以设计结果 要进行分类归
+     档保存
+
+16. 参考 可扩展性的本质是找到系统的变化点，并 离变化点
+
+     说明：世 众多设计模式其实就是 种设计模式即 离变化点的模式
+     正例：极致扩展性的标志，就是 求的新增，不会在原有代码交付物上进行任何形式的修改
+
+                                         49/59
+                                                                        Java 开发手册
+
+17. 参考 设计的本质就是识别和表达系统 点
+
+     说明：识别和表达完全是两回事，很多人错误地认为识别到系统 点在哪里，表达只是自然而然的事情，
+     但是大家在设计评审中经常出现语 不详，甚至是词不达意的情况 准确地表达系统 点 要具备如下能
+     力： 表达规则和表达工具的熟练性 抽象思维和总结能力的局 性 基础知识体系的完备性 深入浅出的
+     生动表达力
+
+18. 参考 代码即文档的观点是错误的，清晰的代码只是文档的某个片断，而不是全部
+
+     说明：代码的深度调用，模块层 上的依赖关系网，业务场景逻辑， 功能性 求等 是 要相应的文
+     档来完整地呈现的
+
+19. 参考 在做无 碍产品设计时， 要考虑到：
+
+          z 所有可交互的控件元素必 能被 tab 聚焦，并且焦点 序 符合自然操作逻辑
+          z 用于登录校 和请求拦截的 证码均 提供图形 证以外的其它方式
+          z 自定义的控件类型 明确交互方式
+     正例：用户登录场景中，输入框的按钮都 要考虑 tab 聚焦，符合自然逻辑的操作 序如下，“输入用
+     户名，输入密码，输入 证码，点击登录”，其中 证码实现语 证方式 如果有自定义标签实现的控
+     件设置控件类型可使用 role 属性
+
+                                                                                                                                                                   50/59
+                                Java 开发手册
+
+1：版本历史
+
+版本号    版本名 发布日期                                 备注
+
+--     --   2016.12.07 试读版本 次对外发布
+
+1.0.0  正式版 2017.02.09 里巴巴 团正式对外发布
+
+                        1）修正 String[]的前后矛盾
+
+                        2）vm 修正成 velocity
+
+1.0.1  --   2017.02.13
+
+                        3）修正 countdown 描述错误
+
+                        1）去 文底水印
+
+                        2）数据类型中引用太 系年
+
+                        3）修正关于异常和方法签名的部分描述
+
+1.0.2  --   2017.02.20
+
+                        4）修正 final 描述
+
+                        5）去 Comparator 部分描述
+
+                        1）增加前言
+
+                        2）增加<? extends T>描述和说明
+
+1.1.0  --   2017.02.27 3）增加版本历史
+
+                        4）增加专有名词解释
+
+1.1.1  --   2017.03.31 修正 码总数和部分示例
+1.2.0
+       完美版                      1）根据云 社区的“聚能聊”活动反 ，对手册的 码 排版 描述进行修正
+                                2）增加 final 的适用场景描述
+                                3）增加关于锁的粒度的说明
+            2017.05.20 4）增加“指定 合大小”的详细说明以及正反例
+                                5）增加卫语句的示例代码
+                                6）明确数据库表示删 概念的字段名为 is_deleted
+
+1.3.0  终极版 2017.09.25 增加单元测试规约， 里开源的 IDE 代码规约检测插件：点此下载
+1.3.1  纪念版 2017.11.30 修正部分描述；采用和 P3C 开源 IDE 检测插件相同的 Apache2.0 协议
+1.4.0  详尽版 2018.05.20 增加设计规约大类，共 16 条
+
+                                                                     51/59
+                             Java 开发手册
+
+版本号    版本名 发布日期                          备注
+
+                        1）鉴于本手册是社区开发者 体智 的结晶，本版本移 里巴巴 Java 开发手册的
+
+                        定词“ 里巴巴”
+
+                        2）新增 21 条新规约 比如，switch 的 NPE  浮点数的比较 无泛型 制 锁的
+
+1.5.0  华山版  2019.06.19 使用方式 判断表达式 日期格式等
+
+                        3）修改描述 112 处 比如，IFNULL 的判断 合的 toArray 日志处理等
+
+                        4）完善若干处示例 比如，命名示例 卫语句示例 enum 示例 finally 的 return
+
+                        示例等
+
+                        1）发布错误码统 解决方案，详细参考 表 3
+
+                        2）新增 34 条新规约 比如，日期时 的 年 月 ，三目运算的自动拆箱，SQL
+
+1.6.0  泰山版  2020.04.22  查询的表别名 定，Collectors 类的 toMap()方法使用注意等
+                        3）修改描述 90 处 比如， 塞等待锁 建表的小数类型等
+
+                        4）完善若干处示例 比如，ISNULL 的示例等
+
+1.7.0  山版                       1）新增前后端规约 14 条
+                                2）新增禁止任何歧视性用语的约定
+                                3）新增涉及敏感操作的情况下日志 要保存六个月的约定
+            2020.08.03 4）修正 BigDecimal 类中关于 compareTo 和 equals 的等值比较
+                                5）修正 HashMap 关于 1024 个元素扩容的次数
+                                6）修正架构分层规范与相关说明
+                                7）修正泰山版中部分格式错误和描述错误
+
+                                                                      52/59
+          Java 开发手册
+
+2：专有名词解释
+
+1. POJO（Plain Ordinary Java Object）: 在本规约中，POJO 专指只有 setter/getter/toString 的
+    简单类，包括 DO/DTO/BO/VO 等
+
+2. DO（Data Object）： 里巴巴专指数据库表  对应的 POJO 类 此对象与数据库表结构
+       对应，通过 DAO 层向上传输数据源对象
+
+3. DTO（Data Transfer Object）：数据传输对象，Service 或 Manager 向外传输的对象
+
+4. BO（Business Object）：业务对象，可以由 Service 层输出的封装业务逻辑的对象
+
+5. Query：数据查询对象，各层接收上层的查询请求 注意超过 2 个参数的查询封装，禁止使用
+    Map 类来传输
+
+6. VO（View Object）：显示层对象，通常是 Web 向模板 染引擎层传输的对象
+
+7. AO（Application Object）: 里巴巴专指 Application Object，即在 Service 层上，极为贴近
+    业务的复用代码
+
+8. CAS（Compare And Swap）：解决多线程并行情况下使用锁造成性能损耗的 种机制，这是
+    硬件实现的原子操作 CAS 操作包含三个操作数：内存位置 期原值和新值 如果内存位
+    置的值与 期原值相匹配，那么处理器会自动将该位置值更新为新值 否则，处理器不做任何
+    操作
+
+9. GAV（GroupId ArtifactId Version）: Maven 坐标，是用来唯 标识 jar 包
+
+10.OOP（Object Oriented Programming）: 本文泛指类 对象的编程处理方式
+
+11.AQS（AbstractQueuedSynchronizer）: 利用先进先出 列实现的底层同步工具类，它是很多上
+    层同步实现类的基础，比如：ReentrantLock CountDownLatch Semaphore 等，它们通
+    过继承 AQS 实现其模版方法，然后将 AQS 子类作为同步组件的内部类，通常命名为 Sync
+
+12.ORM（Object Relation Mapping）: 对象关系映射，对象 域模型与底层数据之 的转换，本
+    文泛指 iBATIS, mybatis 等框架
+
+13. NPE（java.lang.NullPointerException）: 空指针异常
+
+14. OOM（Out Of Memory）: 源于 java.lang.OutOfMemoryError，当 JVM 没有足够的内存
+    来为对象分配空 并且垃圾回收器也无法回收空 时，系统出现的严重状况
+
+15. 方库: 本工程内部子 目模块依赖的库（jar 包）
+
+16. 二方库: 公司内部发布到中央仓库，可供公司内部其它应用依赖的库（jar 包）
+
+17. 三方库: 公司之外的开源库（jar 包）
+
+                                                               53/59
+                                   Java 开发手册
+
+3：错误码列表
+
+   错误码                       中文描述             说明
+00000      切 ok
+A0001   用户端错误                      正确执行后的返回
+A0100   用户注册错误                        级宏观错误码
+A0101   用户未同意 私协议
+A0102   注册国家或地区受                   二级宏观错误码
+A0110   用户名校 失败
+A0111   用户名已存在                     二级宏观错误码
+A0112   用户名包含敏感词
+A0113   用户名包含特殊字符
+A0120   密码校 失败
+A0121   密码 度不够
+A0122   密码强度不够
+A0130   校 码输入错误
+A0131   短信校 码输入错误
+A0132   邮件校 码输入错误
+A0133   语 校 码输入错误
+A0140   用户证件异常
+A0141   用户证件类型未选择
+A0142   大 身份证编号校 法
+A0143   护照编号校 法
+A0144   军官证编号校 法
+A0150   用户基本信息校 失败
+A0151   手机格式校 失败
+A0152   地址格式校 失败
+A0153   邮箱格式校 失败
+A0200   用户登录异常
+A0201   用户账户不存在
+
+                                                  54/59
+A0202  用户账户被冻结       Java 开发手册
+A0203  用户账户已作废                        二级宏观错误码
+A0210  用户密码错误                         二级宏观错误码
+A0211  用户输入密码错误次数超
+A0220  用户身份校 失败
+A0221  用户指纹识别失败
+A0222  用户 容识别失败
+A0223  用户未获得第三方登录授权
+A0230  用户登录已过期
+A0240  用户 证码错误
+A0241  用户 证码尝试次数超
+A0300  访 权 异常
+A0301  访 未授权
+A0302  正在授权中
+A0303  用户授权申请被拒绝
+A0310  因访 对象 私设置被拦截
+A0311  授权已过期
+A0312  无权 使用 API
+A0320  用户访 被拦截
+A0321
+A0322     名单用户
+A0323  账号被冻结
+A0324
+A0325     法 IP 地址
+A0330  网关访 受
+A0340  地域 名单
+A0341  服务已 费
+A0400  用户签名异常
+A0401  RSA 签名错误
+A0402  用户请求参数错误
+       包含 法恶意跳转链接
+       无效的用户输入
+
+                                               55/59
+                       Java 开发手册
+
+A0410  请求必填参数为空
+A0411
+A0412  用户订单号为空
+A0413
+A0414  订购数量为空
+A0420
+A0421  缺少时 戳参数
+A0422
+A0423  法的时 戳参数
+A0424
+A0425  请求参数值超出允许的范围
+A0426
+A0427  参数格式不匹配
+A0430
+A0431  地址不在服务范围
+A0432
+A0433  时 不在服务范围
+A0440
+A0441  金 超出 制
+A0442
+A0443  数量超出 制
+A0500
+A0501  请求批量处理总个数超出 制
+A0502
+A0503  请求 JSON 解析失败
+A0504
+A0505  用户输入内容 法
+A0506
+A0600  包含违禁敏感词
+A0601
+       图片包含违禁信息
+
+       文件侵犯版权
+
+       用户操作异常
+
+       用户支付超时
+
+       确认订单超时
+
+       订单已关
+
+       用户请求服务异常        二级宏观错误码
+
+       请求次数超出 制
+
+       请求并发数超出 制
+
+       用户操作请等待
+
+       WebSocket 连接异常
+
+       WebSocket 连接断开
+
+       用户重复请求
+
+       用户资源异常          二级宏观错误码
+
+       账户余 不足
+
+                                  56/59
+A0602  用户磁盘空 不足        Java 开发手册
+A0603  用户内存空 不足                               森林 水数或每天抽奖数
+A0604  用户 OSS 容量不足
+A0605  用户配 已用光                          二级宏观错误码
+A0700  用户上传文件异常                         二级宏观错误码
+A0701  用户上传文件类型不匹配
+A0702  用户上传文件太大                         二级宏观错误码
+A0703  用户上传图片太大
+A0704  用户上传视 太大                         二级宏观错误码
+A0705  用户上传压缩文件太大
+A0800  用户当前版本异常
+A0801  用户安装版本与系统不匹配
+A0802  用户安装版本过低
+A0803  用户安装版本过
+A0804  用户安装版本已过期
+A0805  用户 API 请求版本不匹配
+A0806  用户 API 请求版本过
+A0807  用户 API 请求版本过低
+A0900  用户 私未授权
+A0901  用户 私未签署
+A0902  用户摄像头未授权
+A0903  用户相机未授权
+A0904  用户图片库未授权
+A0905  用户文件未授权
+A0906  用户位置信息未授权
+A0907  用户通讯录未授权
+A1000  用户设备异常
+A1001  用户相机异常
+A1002  用户 克 异常
+A1003  用户听筒异常
+
+                                                           57/59
+                    Java 开发手册
+
+A1004  用户扬声器异常
+A1005  用户 GPS 定位异常
+
+B0001  系统执行出错          级宏观错误码
+-      系统执行超时       二级宏观错误码
+B0100  系统订单处理超时     二级宏观错误码
+       系统容灾功能被触发
+-      系统 流         二级宏观错误码
+       系统功能 级
+B0101  系统资源异常
+B0200  系统资源耗尽
+B0210  系统磁盘空 耗尽
+B0220  系统内存耗尽
+B0300  文件句柄耗尽
+B0310  系统连接池耗尽
+B0311  系统线程池耗尽
+B0312  系统资源访 异常
+B0313  系统读取磁盘文件失败
+B0314
+B0315
+B0320
+B0321
+
+C0001  调用第三方服务出错       级宏观错误码
+-      中 件服务出错      二级宏观错误码
+C0100  RPC 服务出错
+-      RPC 服务未找到
+C0110  RPC 服务未注册
+C0111  接口不存在
+C0112  消息服务出错
+C0113  消息投递出错
+C0120  消息消费出错
+C0121  消息订 出错
+C0122  消息分组未查到
+C0123
+C0124
+
+                               58/59
+                    Java 开发手册
+
+C0130  缓存服务出错
+C0131
+C0132  key 度超过 制
+C0133
+C0134  value 度超过 制
+C0140
+C0150  存储容量已满
+C0151
+C0152  不支持的数据格式
+C0153
+C0154  配置服务出错
+C0200
+C0210  网络资源服务出错
+C0220
+C0230  VPN 服务出错
+C0240
+C0250  CDN 服务出错
+C0300
+C0311  域名解析服务出错
+C0312
+C0321  网关服务出错
+C0331
+C0341  第三方系统执行超时        二级宏观错误码
+C0400
+C0401  RPC 执行超时
+C0402
+C0500  消息投递超时
+C0501
+C0502  缓存服务超时
+C0503
+       配置服务超时
+
+       数据库服务超时
+
+       数据库服务出错          二级宏观错误码
+
+       表不存在
+
+       列不存在
+
+       多表关联中存在多个相同名称的列
+
+       数据库死锁
+
+       主 冲突
+
+       第三方容灾系统被触发       二级宏观错误码
+
+       第三方系统 流
+
+       第三方功能 级
+
+       通知服务出错           二级宏观错误码
+
+       短信提醒服务失败
+
+       语 提醒服务失败
+
+       邮件提醒服务失败
+
+                                 59/59
+Java 开发手册
+                                                                                          60/59
+

pom.xml

@@ -0,0 +1,237 @@
+<?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>
+
+    <properties>
+        <revision>0.0.1-SNAPSHOT</revision>
+        <forecast.version>${revision}</forecast.version>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        <java.version>21</java.version>
+        <spring-boot.version>3.4.7</spring-boot.version>
+        <druid.version>1.2.23</druid.version>
+        <bitwalker.version>1.21</bitwalker.version>
+        <swagger.version>3.0.0</swagger.version>
+        <kaptcha.version>2.3.3</kaptcha.version>
+        <pagehelper.boot.version>1.4.7</pagehelper.boot.version>
+        <fastjson.version>2.0.57</fastjson.version>
+        <oshi.version>6.8.2</oshi.version>
+        <commons.io.version>2.19.0</commons.io.version>
+        <poi.version>4.1.2</poi.version>
+        <velocity.version>2.3</velocity.version>
+    </properties>
+
+    <name>forecast</name>
+    <url>http://www.oleauto.cn/</url>
+    <description>光伏功率预测系统</description>
+    <groupId>cn.oleauto</groupId>
+    <artifactId>forecast</artifactId>
+    <version>${revision}</version>
+
+    <!-- 依赖声明 -->
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>jakarta.xml.bind</groupId>
+                <artifactId>jakarta.xml.bind-api</artifactId>
+                <version>4.0.2</version>
+            </dependency>
+
+            <dependency>
+                <groupId>jakarta.servlet</groupId>
+                <artifactId>jakarta.servlet-api</artifactId>
+                <version>6.1.0</version>
+                <scope>provided</scope>
+            </dependency>
+
+            <dependency>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-dependencies</artifactId>
+                <version>${spring-boot.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+
+            <dependency>
+                <groupId>org.apache.iotdb</groupId>
+                <artifactId>iotdb-session</artifactId>
+                <version>1.3.1</version>
+            </dependency>
+<!--            <dependency>-->
+<!--                <groupId>com.mysql</groupId>-->
+<!--                <artifactId>mysql-connector-j</artifactId>-->
+<!--                <version>9.3.0</version>-->
+<!--            </dependency>-->
+            <!-- https://mvnrepository.com/artifact/com.baomidou/mybatis-plus-spring-boot3-starter -->
+            <dependency>
+                <groupId>com.baomidou</groupId>
+                <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
+                <version>3.5.9</version>
+            </dependency>
+            <!-- 阿里数据库连接池 -->
+            <dependency>
+                <groupId>com.alibaba</groupId>
+                <artifactId>druid-spring-boot-starter</artifactId>
+                <version>${druid.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>cn.hutool</groupId>
+                <artifactId>hutool-all</artifactId>
+                <version>5.8.39</version>
+            </dependency>
+            <!-- 解析客户端操作系统、浏览器等 -->
+            <dependency>
+                <groupId>eu.bitwalker</groupId>
+                <artifactId>UserAgentUtils</artifactId>
+                <version>${bitwalker.version}</version>
+            </dependency>
+
+            <!-- pagehelper 分页插件 -->
+            <dependency>
+                <groupId>com.github.pagehelper</groupId>
+                <artifactId>pagehelper-spring-boot-starter</artifactId>
+                <version>${pagehelper.boot.version}</version>
+            </dependency>
+
+            <!-- 获取系统信息 -->
+            <dependency>
+                <groupId>com.github.oshi</groupId>
+                <artifactId>oshi-core</artifactId>
+                <version>${oshi.version}</version>
+            </dependency>
+
+            <!-- Swagger3依赖 -->
+            <dependency>
+                <groupId>org.springdoc</groupId>
+                <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+                <version>2.8.8</version>
+            </dependency>
+            <dependency>
+                <groupId>org.springdoc</groupId>
+                <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+                <version>2.8.8</version>
+            </dependency>
+            <!-- https://mvnrepository.com/artifact/com.lmax/disruptor -->
+            <dependency>
+                <groupId>com.lmax</groupId>
+                <artifactId>disruptor</artifactId>
+                <version>4.0.0</version>
+            </dependency>
+
+            <!-- io常用工具类 -->
+            <dependency>
+                <groupId>commons-io</groupId>
+                <artifactId>commons-io</artifactId>
+                <version>${commons.io.version}</version>
+            </dependency>
+            <!-- https://mvnrepository.com/artifact/org.apache.httpcomponents.client5/httpclient5 -->
+            <dependency>
+                <groupId>org.apache.httpcomponents.client5</groupId>
+                <artifactId>httpclient5</artifactId>
+                <version>5.5</version>
+            </dependency>
+
+            <!-- excel工具 -->
+            <dependency>
+                <groupId>org.apache.poi</groupId>
+                <artifactId>poi-ooxml</artifactId>
+                <version>${poi.version}</version>
+            </dependency>
+
+            <!-- velocity代码生成使用模板 -->
+            <dependency>
+                <groupId>org.apache.velocity</groupId>
+                <artifactId>velocity-engine-core</artifactId>
+                <version>${velocity.version}</version>
+            </dependency>
+
+            <!-- 阿里JSON解析器 -->
+            <dependency>
+                <groupId>com.alibaba.fastjson2</groupId>
+                <artifactId>fastjson2</artifactId>
+                <version>${fastjson.version}</version>
+            </dependency>
+
+            <!-- Token生成与解析-->
+            <dependency>
+                <groupId>io.jsonwebtoken</groupId>
+                <artifactId>jjwt</artifactId>
+                <version>0.12.6</version>
+            </dependency>
+
+            <!-- 验证码 -->
+            <dependency>
+                <groupId>pro.fessional</groupId>
+                <artifactId>kaptcha</artifactId>
+                <version>${kaptcha.version}</version>
+            </dependency>
+
+        </dependencies>
+    </dependencyManagement>
+
+    <modules>
+        <module>gateway</module>
+    </modules>
+    <packaging>pom</packaging>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.1</version>
+                <configuration>
+                    <source>${java.version}</source>
+                    <target>${java.version}</target>
+                    <encoding>${project.build.sourceEncoding}</encoding>
+                    <compilerArgs>
+                        <arg>-parameters</arg>
+                    </compilerArgs>
+                </configuration>
+            </plugin>
+
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>flatten-maven-plugin</artifactId>
+                <version>1.5.0</version>
+                <configuration>
+                    <updatePomFile>true</updatePomFile>
+                    <flattenMode>resolveCiFriendliesOnly</flattenMode>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>flatten</id>
+                        <phase>process-resources</phase>
+                        <goals>
+                            <goal>flatten</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>flatten.clean</id>
+                        <phase>clean</phase>
+                        <goals>
+                            <goal>clean</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+    <pluginRepositories>
+        <pluginRepository>
+            <id>public</id>
+            <name>aliyun nexus</name>
+            <url>https://maven.aliyun.com/repository/public</url>
+            <releases>
+                <enabled>true</enabled>
+            </releases>
+            <snapshots>
+                <enabled>false</enabled>
+            </snapshots>
+        </pluginRepository>
+    </pluginRepositories>
+
+</project>