《唯品会Java开发手册》1.0.3版

1. 概述

《阿里巴巴Java开发手册》，是首个对外公布的企业级Java开发手册，对整个业界都有重要的意义。

我们结合唯品会的内部经验，参考《Clean Code》、《Effective Java》等重磅资料，增补了一些条目，也做了些精简。

感谢阿里授权我们定制和再发布。

2. 规范正文

1. 命名规约
2. 格式规约
3. 注释规约
4. 方法设计
5. 类设计
6. 控制语句
7. 基本类型
8. 集合处理
9. 并发处理
10. 异常处理
11. 日志规约
12. 其他设计

注意： 如需全文pdf版，请下载源码，在docs/standard/目录运行merge.sh生成。

3. 规范落地

规则落地主要依靠代码格式模版与Sonar代码规则检查。

其中Sonar规则不如人意的地方，我们进行了定制。

• Eclipse/Intellij 格式模板
• Sonar 规则修改示例

4. 参考资料

• 《Clean Code》
• 《Effective Java 2nd》
• 《SEI CERT Oracle Coding Standard for Java》(在线版)
• Sonar Java Rules

5. 定制记录

• 《唯品会Java开发手册》－与阿里手册的比较文学I
• 阿里手册的增补与删减记录