阿里巴巴Java开发手册:命名与编程规约详解
需积分: 10 132 浏览量
更新于2024-07-20
收藏 962KB PDF 举报
"《阿里巴巴Java开发手册(正式版)》提供了详细的Java编程规约、异常日志规约、MySQL规约、工程规约以及安全规约,旨在提高代码质量和团队协作效率。"
在Java编程规约中,命名规约是非常重要的部分:
1. 命名不应以下划线或美元符号开头或结尾,例如:`_name`、`__name`、`$Object`、`name_/name$/Object$`都是不合规的。
2. 禁止使用拼音和英文混合命名,也不允许直接使用中文。正确的英文拼写和语法有助于理解和减少歧义。比如:`DaZhePromotion`、`getPingfenByName`、`某变量`是不被推荐的,而像`alibaba`、`taobao`这样的国际通用名称是可以接受的。
3. 类名通常遵循UpperCamelCase风格,但DO/BO/DTO/VO等特殊类型的类可以例外,如:`MarcoPolo`、`UserDO`、`XmlService`。同时,避免使用反例中的`macroPolo`、`UserDo`等。
4. 方法名、参数名、成员变量和局部变量都应使用lowerCamelCase风格,例如:`localValue`、`getHttpMessage`、`inputUserId`。
5. 常量命名应全部大写,各单词之间用下划线分隔,确保名称具有明确的语义,如:`MAX_STOCK`。
异常日志规约涵盖了异常处理和日志规约,确保程序异常能够准确记录,方便后续排查问题。异常处理中可能包括何时抛出异常、如何捕获异常以及如何编写有意义的异常信息。日志规约则指导开发者如何合理地记录日志,包括日志级别、日志内容的详细程度和日志切割等。
MySQL规约主要涉及数据库设计,如建表规约、索引规约、SQL规约和ORM规约。建表时需考虑表结构设计的合理性,索引的创建要考虑查询性能,SQL编写应避免全表扫描,ORM规约则指导如何高效地使用对象关系映射。
工程规约包括应用分层、二方库规约和服务器规约。应用分层通常分为表现层、业务层、数据访问层等,以保持代码结构清晰。二方库规约涉及第三方库的引入和管理,确保库的版本兼容性和稳定性。服务器规约则关注服务器配置、部署等方面,以优化系统性能和可靠性。
最后的安全规约,主要关注代码安全问题,防止注入攻击、XSS攻击等,同时强调密码加密、敏感信息保护等实践。
《阿里巴巴Java开发手册》是一份全面的Java开发指导文档,对于提升代码质量、团队协作效率和项目安全性有着重要的作用。
2020-11-02 上传
150 浏览量
点击了解资源详情
点击了解资源详情
2023-05-23 上传
点击了解资源详情
点击了解资源详情
点击了解资源详情
张果
- 粉丝: 600
- 资源: 429
最新资源
- mattgirdler.github.io
- cloudinary_public:Dart包装器,可将媒体文件上传到cloudinary
- ulabel:基于浏览器的图像批注工具
- lickwolf.github.io
- .NET在线二手交易系统的ASP毕业设计(源代码+论文).zip
- mern-react:使用Javascript创建Staycation前端(ReactJS)
- Accuinsight-1.0.24-py2.py3-none-any.whl.zip
- js-algorithms:各种算法的 JavaScript 实现
- WebCursos
- workers-forms
- ajalabs_placeholder:AJAlabs.com当前的占位符网站
- 基于web的实验室管理系统毕业设计(自动排课功能的实现).zip
- fbfgbfqq
- 博客
- Qt6可进行录像录音代码特性
- voxel_survival