2015070402 - EffactiveJava笔记 - 第56条 遵守普遍命名规范(1)

   20150704 星期六 北京

   Java建立一套完整的命名规范,字面的和语法的规范.

   包的命名应该是层次的,使用句号”.”分隔每个部分.任何将你组织之外的使用的包,命名规范是你组织的internet域名开头,并且顶级域名放在前面.例如edu.cmu,com.sun等.标准类库和可选包以java或者javax开头,这属于规则的例外.

   但是用户创建的包决不能以java或者javax开头.

 

   类,接口,枚举,注解的名称,应该使用驼峰命名法.都应该包含一个或者多个单词,每个字母首字母大写.例如Timer,TimerTask,应该尽可能避免缩写,除非首字母缩写或者通用缩写,比如Cs,min等.

   对于首字母缩写,应该全部大写还是只有首字母大写呢,建议采用仅有首字母大写的形式.即使连续出现多个首字母缩写的形式,你依然可以区分出单词的起始和结束.比如HTTPURL,还是HttpUrl,你喜欢哪一个呢?

   方法和属性的名称,和类,接口命名都遵循相同的规范,只是方法和属性首字母应该小写而已.例如remove,ensureCapacity.如果首字母组成的单词是方法或者属性的第一个单词,它就应该是小写的.

   (以上复习内容,都知道,快速复习一番.)

   常量的命名,它的名称应该包含一个或者多个大写单词,中间使用下划线分开.例如MAX_VALUE等.

   注意:常量是唯一推荐使用下滑线的情景.

   局部变量命名规范和属性名称类似,允许使用缩写,单个字母,和段字符序列的意义取决于局部变量所在的上下文环境.比如i,xref,houseNumber.

   参数类型名称通常由单个字母组成,T表示任意的类,E表示集合的元素类型,K和V表示映射的键和值,X表示的是异常.

 

    标示符类型       案例

    包               com.google.inject

    类或者接口       Timer,TimerTask

    方法或属性       remove,getCru

    常量             MIN_VALUE

    局部变量         i,xref

    类型参数         T,E,K,V,X