
Java 语言有一套完善的命名约定,有助于维护代码的可读性和组织性。这些约定在 Java 语言规范 (JLS) 中有详细记录,可以分为排版约定和语法约定。
排版约定
排版命名约定涵盖包、类、接口、方法、字段和类型变量。遵循它们有助于保持代码的一致性并避免混淆,从而使其更易于使用和维护。最佳实践包括:
包和模块:它们必须是分层的,用句点分隔并由小写字母组成。在组织外部使用的包必须以域名向后开头,例如 com.google 或 org.apache。
类和接口:它们必须具有 PascalCase 名称,例如 ArrayList 或 FutureTask,首选全名并避免缩写,除非被广泛接受(HttpUrl 而不是 HTTPURL)。
方法和字段:以驼峰命名法命名,首字母小写,例如remove或getCapacity。常量字段(最终静态)必须用大写字母书写,单词之间用下划线分隔,例如 MAX_VALUE。
局部变量:可以使用缩写和单个字符,例如 i、sum 或索引,特别是对于循环和临时变量。
类型参数:通常是单个字母,例如 T 表示泛型类型,E 表示集合的元素类型,K 和 V 表示映射的键和值。
Waymark
Waymark是一个视频制作工具,帮助企业快速轻松地制作高影响力的广告。
79 查看详情
语法约定
语法约定根据标识符的类型而有所不同,重点是提供元素功能的清晰度:
类:使用名词或名词短语(Thread、ArrayList),而实用程序类通常采用复数形式(Collections、Collectors)。
接口:接口名称可以使用以“able”或“ible”结尾的名词或形容词,例如 Runnable 或 Comparable。
方法:动作函数的名称是动词(append、drawImage)。布尔方法通常以 is 或 has (isEnabled, hasNext) 开头。
getter 和 setter:返回值的方法的名称带有名词或以 get 开头,而修改值的方法以 set 开头。示例:getAge 和 setAge。
转换方法:对于类型转换,使用 toString 和 asList 等约定。静态工厂通常命名为 from、of 或 getInstance。
约定的重要性
遵守这些约定可以提高代码的可读性和一致性,使团队合作和维护变得更加容易。虽然排版约定更加严格,但语法约定具有更大的灵活性,允许程序员适应上下文和常规用法的需要。
以上就是项目 采用普遍接受的命名约定的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1004625.html
微信扫一扫
支付宝扫一扫