遵守普遍接受的命名惯例(56)

java 平台建立了一整套很好的命名惯例

  • 大致分为字面的、语法的两种

字面的惯例比较少:涉及包、类、接口、域、方法、类型变量等,尽量不要违反这些惯例

  • api 违反了这些惯例,使用起来很困难
  • 实现类违反了,很难以维护

一旦违反,会给其他程序员带来很大的困扰

包:

  • 包的名称是层次状的 com.em.tool.ds.controller
    • 均小写、以组织开头
    • java、javax 属于例外(自己绝不要以这俩开头)
  • 包的组成部分简短处理,比如使用util 而不是utility
  • java 没有提供包层次的支持,但是有些包还是包含丰富的包层次

类和接口(包括枚举和注解类型):

  • 首字母大写
  • 尽量避免使用缩写
  • 驼峰式命名习惯

方法和域的名称:

  • 参考类和接口
  • 首字母小写

常量域(唯一例外):

  • 一个或多个纯大写字母,带下划线组成
  • 常量域是静态 final 域
  • 枚举类型是常量域
  • 被引用类型不可变,也可以是个常量域
  • 常量域是唯一推荐使用下划线的情形

局部变量(与成员名称类似):

  • 允许缩写、单个字符、短字符都是允许的

类型参数:

  • 单字母组成
  • T 代表任意类型
  • E 代表集合中的元素类型
  • K、V 代表映射的键和值类型
  • T、T1、T2 ...

0a64b0550b554ebba71c5a09b0a2f19c8a0.jpg

语法命名规则比字面量更加灵活,更加争议

  • 包没有语法命名惯例
  • 类和接口使用单词或短语(接口常加 able、ible代表一种能力)
  • 方法:getter、setter、generate、size、toString、newInstance、isTable、hasTable 等等
  • 域名,用名词就好 height、baoyStyle 等等

好的命名习惯,大大增强了程序的可读性,非常值得遵守

转载于:https://my.oschina.net/u/3847203/blog/1944742

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值