阿里巴巴 Java 开发手册（黄山版）
链接：https://pan.baidu.com/s/1iKsXlq1DSbePLvuysYbA4A
提取码：yyds

阿里巴巴将 Java 开发手册 从 1.7.0 的嵩山版更新至 1.7.1 的黄山版，新增 11 条新规约，具体变动如下：

一、编程规约

 (二) 常量定义

  3. 【强制】浮点数类型的数值后缀统一为大写的 D 或 F。

 (十一) 其他

  6. 【强制】枚举 enum(括号内)的属性字段必须是私有且不可变。

二、异常日志

 (三) 日志规约

  14. 【推荐】为了保护用户隐私，日志文件中的用户敏感信息需要进行脱敏处理。

四、安全规约

  9. 【强制】对于文件上传功能，需要对于文件大小、类型进行严格检查和控制。

  10. 【强制】配置文件中的密码需要加密。

五、数据库

 (一) 建表规约

  10. 【强制】在数据库中不能使用物理删除操作，要使用逻辑删除。

六、工程结构

 (二) 二方库依赖

  6. 【强制】二方库定制包的命名方式，在规定的版本号之后加“-英文说明[序号]”，英文说明可以是部门简称、业务名称，序号直接紧跟在英文说明之后，表示此定制包的顺序号。

 (三) 服务器

  1. 【强制】调用远程操作必须有超时设置。

  2. 【推荐】客户端设置远程接口方法的具体超时时间（单位 ms），超时设置生效顺序一般为：1）客户端 Special Method；2）客户端接口级别；3）服务端 Special Method；4）服务端接口级别。

  7. 【推荐】了解每个服务大致的平均耗时，可以通过独立配置线程池，将较慢的服务与主线程池隔离开，免得不同服务的线程同归于尽。

七、设计规约

  7. 【强制】系统设计时要准确识别出弱依赖，并针对性地设计降级和应急预案，保证核心系统正常可用。