工作实战之代码规范

说明：以学生和成绩的关系为例，学生表中的 student_id 是主键，那么成绩表中的 student_id 则为外键。如果更新学生表中的 student_id，同时触发成绩表中的 student_id 更新，即为级联更新。外键与级联更新适用于单机低并发，不适合分布式、高并发集群；级联更新是强阻塞，存在数据库更新风暴的风险；外键影响数据库的插入速度。

6）【强制】禁止使用存储过程，存储过程难以调试和扩展，更没有移植性。

7）【强制】数据订正（特别是删除、修改记录操作）时，要先 select，避免出现误删除，确认无误才能执行更新语句。

8）【推荐】in 操作能避免则避免，若实在避免不了，需要仔细评估 in 后边的集合元素数量，控制在 1000 个之内。

9）【参考】如果有国际化需要，所有的字符存储与表示，均以 utf-8 编码，注意字符统计函数的区别。

本人整理mysql数据规范https://download.csdn.net/download/zengliangxi/87526913

3.设计规范（工程结构，二方库规范，设计规约）

1）【强制】定义 GAV 遵从以下规则：

GroupID 格式：com.{公司/BU }.业务线 [.子业务线]，最多 4 级。

说明：{公司/BU} 例如：alibaba/taobao/tmall/aliexpress 等 BU 一级；子业务线可选。

正例：com.taobao.jstorm 或 com.alibaba.dubbo.register

ArtifactID 格式：产品线名-模块名。语义不重复不遗漏，先到中央仓库去查证一下。

正例：dubbo-client / fastjson-api / jstorm-tool

Version：详细规定参考下方。

2）【强制】二方库版本号命名方式：主版本号.次版本号.修订号

主版本号：产品方向改变，或者大规模 API 不兼容，或者架构不兼容升级。

次版本号：保持相对兼容性，增加主要功能特性，影响范围极小的 API 不兼容修改。

修订号：保持完全兼容性，修复 BUG、新增次要功能特性等。

说明：注意起始版本号必须为：1.0.0，而不是 0.0.1，正式发布的类库必须先去中央仓库进行查证，使版本号有延续性，正式版本号不允许覆盖升级。如当前版本：1.3.3，那么下一个合理的版本号：1.3.4 或 1.4.0 或 2.0.0

3）【强制】线上应用不要依赖 SNAPSHOT 版本（安全包除外）。

说明：不依赖 SNAPSHOT 版本是保证应用发布的幂等性。另外，也可以加快编译时的打包构建。

4）【强制】在需求分析阶段，如果与系统交互的 User 超过一类并且相关的 User Case 超过 5 个，使用用例图来表达更加清晰的结构化需求。

5）【强制】如果某个业务对象的状态超过 3 个，使用状态图来表达并且明确状态变化的各个触发条件。

说明：状态图的核心是对象状态，首先明确对象有多少种状态，然后明确两两状态之间是否存在直接转换关系，再明确触发状态转换的条件是什么。

正例：淘宝订单状态有已下单、待付款、已付款、待发货、已发货、已收货等。比如已下单与已收货这两种状态之间是不可能有直接转换关系的。

6）【强制】如果系统中某个功能的调用链路上的涉及对象超过 3 个，使用时序图来表达并且明确各调用环节的输入与输出。

说明：时序图反映了一系列对象间的交互与协作关系，清晰立体地反映系统的调用纵深链路。

7）【强制】如果系统中模型类超过 5 个，并且存在复杂的依赖关系，使用类图来表达并且明确类之间的关系。

说明：类图像建筑领域的施工图，如果搭平房，可能不需要，但如果建造蚂蚁 Z 空间大楼，肯定需要详细的施工图。

8）【强制】如果系统中超过 2 个对象之间存在协作关系，并且需要表示复杂的处理流程，使用活动图来表示。

本人整理设计规约https://download.csdn.net/download/zengliangxi/87526919

三、Maven插件保证代码质量

1.装上插件运行效果

1）代码未格式化

执行formatter命令自动恢复

2）无效引用

2.checkstyle插件

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-checkstyle-plugin</artifactId>
    <version>3.2.0</version>
    <dependencies>
        <dependency>
            <groupId>com.puppycrawl.tools</groupId>
            <artifactId>checkstyle</artifactId>
            <version>8.42</version>
        </dependency>
    </dependencies>
    <configuration>
        <configLocation>${project-root}/qa/checkstyle.xml</configLocation>
    </configuration>
</plugin>

3.pmd插件

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-pmd-plugin</artifactId>
    <version>3.19.0</version>
    <configuration>
        <linkXRef>false</linkXRef>
        <inputEncoding>${project.build.sourceEncoding}</inputEncoding>
        <rulesets>
            <ruleset>${project-root}/qa/pmd-custom-java-rulesets.xml</ruleset>
        </rulesets>
        <printFailingErrors>true</printFailingErrors>
    </configuration>
</plugin>

4.formatter插件

<plugin>
    <groupId>net.revelc.code.formatter</groupId>
    <artifactId>formatter-maven-plugin</artifactId>
    <version>2.11.0</version>
    <configuration>
        <compilerSource>${java.version}</compilerSource>
        <compilerCompliance>${java.version}</compilerCompliance>
        <compilerTargetPlatform>${java.version}</compilerTargetPlatform>
        <lineEnding>LF</lineEnding>
        <encoding>${project.build.sourceEncoding}</encoding>
        <configFile>${project-root}/qa/java-code-format.xml</configFile>
    </configuration>
</plugin>

本人搭建的基础代码检查与格式化项目https://download.csdn.net/download/zengliangxi/87527199