"Java代码规范:命名、格式、注释、方法设计、类设计严格规约"
61 浏览量
更新于2024-04-02
收藏 53KB DOCX 举报
在Java代码规范编码规约中,首先要求严禁在代码中的命名使用拼音缩写,例如将"保单"缩写为"BaoDan"或将"获取保单信息"缩写为"getBaoDanInfo"。此外,禁止使用非标准的英文缩写,如将"AbstractClass"缩写为"AbsClass"或将"condition"缩写为"condi"。
在格式规范方面,规定要使用统一的代码格式模板,可以通过IDE自动进行格式化,以确保代码的整体风格一致。
在注释规范中,基本的注释要求是准确地反映设计思想和代码逻辑,尤其是需要描述清楚公共方法或抽象类的方法的输入、输出、错误处理和返回码,以及可能抛出的异常。注释还应该能够描述业务的具体含义,使读者能够快速理解代码背后的信息。
在方法设计中,建议限制方法长度不要超过100行,因为当方法长度超过8000个字节码时,将不会被JIT编译成二进制码,影响性能。
在类设计中,推荐将类成员和方法的可见性尽可能最小化,严控访问范围,以避免过于宽泛的访问范围导致模块解耦困难。应该仔细思考如果是一个private的方法,可以随意删除,但如果是一个public的service方法或成员变量,删除会带来什么后果。例外情况是为了单元测试可能需要扩大访问范围,但在这种情况下需要加上JavaDoc说明。
另外,在命名规范中,还要求包名全部小写,点分隔符之间尽量只有一个英语单词,即使有多个英语单词也不使用下划线或大小写分隔。方法名、参数、成员名和局部变量都要使用驼峰形式,类名和接口名使用UpperCamelCase风格,遵循驼峰形式,但DTO/VO等可例外。常量命名要全大写,单词间用下划线隔开,务求语义表达完整清楚,不要嫌名字长。
综上所述,遵守Java代码规范编码规约可以提高代码的可读性、可维护性和可扩展性,使团队成员之间的协作更加高效,也有助于减少代码bug和提升代码质量。因此,开发人员应该在日常的编码工作中严格遵守这些规范,为项目的顺利实施和成功上线提供坚实的基础。
2009-12-02 上传
2018-05-18 上传
2018-11-02 上传
2017-11-23 上传
2022-08-08 上传
点击了解资源详情
huver2007
- 粉丝: 369
- 资源: 36
最新资源
- JHU荣誉单变量微积分课程教案介绍
- Naruto爱好者必备CLI测试应用
- Android应用显示Ignaz-Taschner-Gymnasium取消课程概览
- ASP学生信息档案管理系统毕业设计及完整源码
- Java商城源码解析:酒店管理系统快速开发指南
- 构建可解析文本框:.NET 3.5中实现文本解析与验证
- Java语言打造任天堂红白机模拟器—nes4j解析
- 基于Hadoop和Hive的网络流量分析工具介绍
- Unity实现帝国象棋:从游戏到复刻
- WordPress文档嵌入插件:无需浏览器插件即可上传和显示文档
- Android开源项目精选:优秀项目篇
- 黑色设计商务酷站模板 - 网站构建新选择
- Rollup插件去除JS文件横幅:横扫许可证头
- AngularDart中Hammock服务的使用与REST API集成
- 开源AVR编程器:高效、低成本的微控制器编程解决方案
- Anya Keller 图片组合的开发部署记录