java编码规范-阿里巴巴
2018-03-19 16:10
267 查看
阿里巴巴 Java 开发手册
前言《阿里巴巴 Java 开发手册》是阿里巴巴集团技术团队的集体智慧结晶和经验总结,经历了多次大规模一线实战的检验及不断的完善,系统化地整理成册,回馈给广大开发者。现代软件行业的高速发展对开发者的综合素质要求越来越高,因为不仅是编程知识点,其它维度的知识点也会影响到软件的最终交付质量。比如:数据库的表结构和索引设计缺陷可能带来软件上的架构缺陷或性能风险;工程结构混乱导致后续维护艰难;没有鉴权的漏洞代码易被黑客攻击等等。所以本手册以 Java 开发者为中心视角,划分为编程规约、异常日志、单元测试、安全规约、工程结构、MySQL 数据库六个维度,再根据内容特征,细分成若干二级子目录。根据约束力强弱及故障敏感性,规约依次分为强制、推荐、参考三大类。对于规约条目的延伸信息中,“说明”对内容做了适当扩展和解释;“正例”提倡什么样的编码和实现方式;“反例”说明需要提防的雷区,以及真实的错误案例。本手册的愿景是码出高效,码出质量。现代软件架构都需要协同开发完成,高效协作即降低协同成本,提升沟通效率,所谓无规矩不成方圆,无规范不能协作。众所周知,制订交通法规表面上是要限制行车权,实际上是保障公众的人身安全。试想如果没有限速,没有红绿灯,谁还敢上路行驶。对软件来说,适当的规范和标准绝不是消灭代码内容的创造性、优雅性,而是限制过度个性化,以一种普遍认可的统一方式一起做事,提升协作效率。代码的字里行间流淌的是软件生命中的血液,质量的提升是尽可能少踩坑,杜绝踩重复的坑,切实提升质量意识。考虑到可以零距离地与众多开发同学进行互动,决定未来在线维护《手册》内容,此 1.3.1 的 PDF 版本,是对外释放的最终纪念版,铭记发布第一版以来的 358 天旅程;我们已经在杭州云栖大会上进行了阿里巴巴 Java 开发规约插件点此下载,阿里云效(一站式企业协同研发云)也集成了代码规约扫描引擎。最后,《码出高效——阿里巴巴Java 开发手册详解》即将出版,敬请关注。 目录
前言一、编程规约 ......................................................................... 1
(一) 命名风格 ...................................................................1
(二) 常量定义 ...................................................................3
(三) 代码格式 ...................................................................4
(四) OOP 规约...................................................................6
(五) 集合处理 ...................................................................9
(六) 并发处理 ..................................................................12
(七) 控制语句 ..................................................................14
(八) 注释规约 ..................................................................16
(九) 其它 ......................................................................17
二、异常日志 ........................................................................ 1
(一) 异常处理 .................................................................. 17
(二) 日志规约 .................................................................. 19
三、单元测试 ........................................................................ 22
四、安全规约 ........................................................................ 24
五、MySQL 数据库 .................................................................... 25
(一) 建表规约 ..................................................................25
(二) 索引规约 ..................................................................26
(三) SQL 语句..................................................................28
(四) ORM 映射..................................................................29
六、工程结构 ........................................................................ 31
(一) 应用分层 ..................................................................31
(二) 二方库依赖 ................................................................32
(三) 服务器 .................................................................... 33
附 1:版本历史 ....................................................................... 35附
2:本手册专有名词 ................................................................. 36
点击下载《阿里巴巴Java开发手册》
前言《阿里巴巴 Java 开发手册》是阿里巴巴集团技术团队的集体智慧结晶和经验总结,经历了多次大规模一线实战的检验及不断的完善,系统化地整理成册,回馈给广大开发者。现代软件行业的高速发展对开发者的综合素质要求越来越高,因为不仅是编程知识点,其它维度的知识点也会影响到软件的最终交付质量。比如:数据库的表结构和索引设计缺陷可能带来软件上的架构缺陷或性能风险;工程结构混乱导致后续维护艰难;没有鉴权的漏洞代码易被黑客攻击等等。所以本手册以 Java 开发者为中心视角,划分为编程规约、异常日志、单元测试、安全规约、工程结构、MySQL 数据库六个维度,再根据内容特征,细分成若干二级子目录。根据约束力强弱及故障敏感性,规约依次分为强制、推荐、参考三大类。对于规约条目的延伸信息中,“说明”对内容做了适当扩展和解释;“正例”提倡什么样的编码和实现方式;“反例”说明需要提防的雷区,以及真实的错误案例。本手册的愿景是码出高效,码出质量。现代软件架构都需要协同开发完成,高效协作即降低协同成本,提升沟通效率,所谓无规矩不成方圆,无规范不能协作。众所周知,制订交通法规表面上是要限制行车权,实际上是保障公众的人身安全。试想如果没有限速,没有红绿灯,谁还敢上路行驶。对软件来说,适当的规范和标准绝不是消灭代码内容的创造性、优雅性,而是限制过度个性化,以一种普遍认可的统一方式一起做事,提升协作效率。代码的字里行间流淌的是软件生命中的血液,质量的提升是尽可能少踩坑,杜绝踩重复的坑,切实提升质量意识。考虑到可以零距离地与众多开发同学进行互动,决定未来在线维护《手册》内容,此 1.3.1 的 PDF 版本,是对外释放的最终纪念版,铭记发布第一版以来的 358 天旅程;我们已经在杭州云栖大会上进行了阿里巴巴 Java 开发规约插件点此下载,阿里云效(一站式企业协同研发云)也集成了代码规约扫描引擎。最后,《码出高效——阿里巴巴Java 开发手册详解》即将出版,敬请关注。 目录
前言一、编程规约 ......................................................................... 1
(一) 命名风格 ...................................................................1
(二) 常量定义 ...................................................................3
(三) 代码格式 ...................................................................4
(四) OOP 规约...................................................................6
(五) 集合处理 ...................................................................9
(六) 并发处理 ..................................................................12
(七) 控制语句 ..................................................................14
(八) 注释规约 ..................................................................16
(九) 其它 ......................................................................17
二、异常日志 ........................................................................ 1
(一) 异常处理 .................................................................. 17
(二) 日志规约 .................................................................. 19
三、单元测试 ........................................................................ 22
四、安全规约 ........................................................................ 24
五、MySQL 数据库 .................................................................... 25
(一) 建表规约 ..................................................................25
(二) 索引规约 ..................................................................26
(三) SQL 语句..................................................................28
(四) ORM 映射..................................................................29
六、工程结构 ........................................................................ 31
(一) 应用分层 ..................................................................31
(二) 二方库依赖 ................................................................32
(三) 服务器 .................................................................... 33
附 1:版本历史 ....................................................................... 35附
2:本手册专有名词 ................................................................. 36
点击下载《阿里巴巴Java开发手册》
相关文章推荐
- 9月18日云栖精选夜读:「阿里巴巴编码规范(Java版)」认证考试出炉!你考过了吗?
- 9月18日云栖精选夜读:「阿里巴巴编码规范(Java版)」认证考试出炉!你考过了吗?
- 阿里巴巴IDEA插件编码规范扫描Alibaba Java Coding Guidelines
- 阿里巴巴Java编码规范,来测测你能得多少分
- 9月18日云栖精选夜读:「阿里巴巴编码规范(Java版)」认证考试出炉!你考过了吗?
- [收藏]Java编码规范
- 阿里巴巴java规范
- Java语言编码规范 - Java语言编码规范(中文版)(http://doc.javanb.com/code-conventions-for-the-java-programming-language-zh/index.html)
- 4000 java开发规范总结_代码编码规范
- Java 语言编码规范
- JAVA程序员不可不注意的编码规范
- Java编码规范 Code Conventions for the Java
- Java编码规范之声明和空白,空格
- java语言编码规范
- Java编码规范(The Elements of Java Style)
- Java语言编码规范(Java Code Conventions)
- Java编码规范,让你的代码赏心悦目--错误处理
- 标准的Java编码规范手册
- Java 编码规范
- Java编码规范,让你的代码赏心悦目--有意义的命名