阿里Java开发手册1.0.0版:编程规约详解
需积分: 9 10 浏览量
更新于2024-07-19
收藏 1.45MB PDF 举报
阿里Java开发手册正式版PDF是一份由阿里巴巴集团技术部于2016年12月7日发布的官方文档,旨在提供给Java开发者一套详细的编码规范和最佳实践。该手册涵盖了编程规约的重要部分,以确保代码的清晰、一致性与可维护性。
1. 命名规约:
- 强制性规定指出,编程相关的命名应遵循严格的规则,如不允许以下划线或美元符号起始或结束,避免拼音与英文混用以及中文命名。例如,正确的命名应该像"ali Alibaba Taobao Cainiao Aliyun Youku Hangzhou"这样的国际化风格,而非"DaZhePromotion"或"getPingfenByName"。
- 类名采用UpperCamelCase(驼峰命名法),如"MarcoPolo/UserDO",但对特定领域模型如DO/DTO/VO/DAO,允许保留原样,如"UserDO"。
- 方法名、参数名、成员变量和局部变量采用lowerCamelCase,如"localValue/getHttpMessage/inputUserId"。
- 常量命名全大写,用下划线分隔,如"MAX_STOCK_COUNT",避免简写如"MAX_COUNT"。
- 抽象类以"Abstract"或"Base"开头,异常类以"Exception"结尾,测试类的命名遵循被测试类的名称加上"Test"后缀。
2. 具体示例:
- 数组定义时强调使用中括号,如"String[] args",而不是"String args[]",这有助于消除误解和避免潜在错误。
- POJO类中,布尔类型的变量不应添加"is"前缀,以免在某些框架的序列化过程中出现问题。
这份开发手册的重要性在于,它为阿里巴巴内部及外部Java开发者提供了一套标准化的编码指南,帮助提升代码质量,增强团队协作效率,并且减少由于命名不一致带来的沟通成本。遵循这些规则,能够确保代码的可读性和可维护性,对于构建高质量的软件系统至关重要。无论是新入职的开发者还是经验丰富的程序员,都需要理解和遵守这些规范,以保持代码的一致性和项目的一致性。
1292 浏览量
1031 浏览量
638 浏览量
Mr_YDK
- 粉丝: 105
- 资源: 92
最新资源
- java成神之路思维导图——Hollis.zip
- 三张高清蓝色点线电子线路背景图片PPT模板
- Fix_My_Code_Challenge
- 《如何成为优秀的产品经理》ppt读书笔记.rar
- 两张水彩花卉背景图片PPT模板
- 灰蓝网路商务公司网页模板
- 曼哈顿
- Fish-shader:在Godot引擎中为没有电枢或混合形状的鱼设置着色器动画-Gitlab上的主要仓库
- Test11.rar
- emojis:Unicode表情符号作为UTS#51规范
- 简化SQL-CSV导入/导出功能
- fun_stuff:有趣的额外东西
- 饿了么sign加密,js源码转python
- 富迪公司员工激励研究(论文+文献翻译)-论文.zip
- 《培训与开发》人力资源管理培训ppt模板.rar
- isolog:将节点控制台消息发送到客户端