"Java代码规范:命名、格式、注释、方法设计、类设计严格规约"
2 浏览量
更新于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和提升代码质量。因此,开发人员应该在日常的编码工作中严格遵守这些规范,为项目的顺利实施和成功上线提供坚实的基础。
点击了解资源详情
点击了解资源详情
点击了解资源详情
2011-12-25 上传
193 浏览量
2009-12-02 上传
241 浏览量
216 浏览量
793 浏览量
huver2007
- 粉丝: 370
- 资源: 36
最新资源
- SMTPSender(iPhone源代码)
- 类似瀑布流的网格视图效果
- win7 64位安装IE11所需补丁
- WIFIRobots
- 多路DA上位机+单片机源码.zip
- cace:CMS管理员命令执行
- cursoKuberneteswildfly:Curso cursoKubernetes野蝇sobre Cubernetes
- mysql-connector-java-8.0.25.zip
- 建筑节能平台登录网页模板
- 网络游戏-基于移动无线网络、通过远程服务器进行地图解析的方法.zip
- PCBMill:PCBMill FABtotum插件
- 房屋出租管理系统.rar
- Google Chrome:trade_mark:的标签管理器-crx插件
- WindowsFormsApp1.zip
- agora:面向目标的敏捷需求获取
- webtesting-ii-guided:Web测试II模块指导项目