首页 > 编程语言 >读书笔记-阿里巴巴Java开发手册-常用的命名风格

读书笔记-阿里巴巴Java开发手册-常用的命名风格

时间:2022-12-14 15:07:47浏览次数:49  
标签:Java 前缀 读书笔记 接口 手册 命名 共享 类名 常量


命名风格

强制类型

  1. 不可以用​​_​​​或者​​$​​开始或者结束
  2. 严禁使用拼音和英文混写
  3. 类名使用UpperCamelCase风格
  4. 方法名,参数名,成员变量,局部变量都统一使用lowerCamelCase风格,遵循驼峰形式
  5. 常量命名全部大写,单词间用下划线隔开
  6. 抽象类命名使用Abstract或Base开头;异常类使用Exception结尾;测试类命名以测试的类名开始,Test结尾
  7. 类型与中括号间无空格相连定义数组
  8. POJO类中布尔类型的变量都不要加is前缀,因为框架解析可能会出现错误
  9. 包名统一使用小写,点分隔符间只有一个单词
  10. 包名使用单数形式
  11. 类名如果有附属含义,类名可用复数形式
  12. 杜绝不规范的缩写
  13. 对于Service和Dao类,基于SOA的理念,暴露出来的服务一定是接口,内部的实现类用Impl后缀与接口区别

推荐类型

  1. 为了代码自解释,自定义编程元素命名尽量使用完整的单词组合来表达意思
  2. 如果模块,接口,类方法使用了设计模式,应尽量命名提现出具体模式
  3. 接口类方法和属性不要加修饰符号 ​​public​​也不要加,并且加上有效的Javadoc注释
  4. 尽量不要在接口里面定义变量,如果一定要定义,必须是与接口方法相关的,并且是整个应用的基础常量
  5. 如果是形容能力的接口名称,取对应的形容词为接口名(通常为-able的形式)

参考类型

  1. 枚举类名建议带上Enum后缀,枚举成员名称需要全大写,单词间用下划线隔开
  2. 各层命名规约:
    1)Service/Dao层
    获取单个对象的方法用​​​get​​​做前缀
    获取多个对象的方法用​​​list​​​做前缀
    获取统计值的方法用​​​count​​​做前缀
    插入的方法用​​​save/insert​​​作为前缀
    删除的方法用​​​remove/delete​​​作为前缀
    修改的方法用​​​updata​​​作为前缀
    2)领域模型不了解。。。

常量定义

强制类型

  1. 不允许任何魔法值(未经预先定义的常量)直接出现在代码中
  2. long和Long初始化赋值时,使用大写的L,不能是小写的l,小写的容易和1混淆

推荐类型

  1. 不要使用一个常量类维护所有的常量,要按常量功能进行归类,分开维护(如:缓存相关的放在CacheConsts中,配置放在ConfigConsts中)
  2. 常量的复用层次5层:跨应用共享常量,应用内共享常量,子工程内共享常量,包内共享常量,类内共享常量
    1)跨应用共享常量,在二方库的constant中
    2)应用内共享常量,在一方库,子模块中constant中
    3)子工程内部共享常量,在当前子工程的constant中
    4)包内共享常量,当前包下单独的constant目录下
    5)类内共享常量,直接在类的内部private static final定义
  3. 如果变量值在一个范围内变化,则用enum类型来定义


标签:Java,前缀,读书笔记,接口,手册,命名,共享,类名,常量
From: https://blog.51cto.com/u_12938555/5936972

相关文章

  • LeetCode-Java-872. Leaf-Similar Trees
    题目Consideralltheleavesofabinarytree.Fromlefttorightorder,thevaluesofthoseleavesformaleafvaluesequence.假装有图Forexample,inthegiven......
  • 剑指Offer-Java-二叉树的镜像
    题目题目描述操作给定的二叉树,将其变换为源二叉树的镜像。输入描述:二叉树的镜像定义:源二叉树8/\610/\/\57911......
  • 16-咸鱼学Java-内部类补充
    上一篇文章,说了实例内部类和静态内部类,这篇文章重点说明,本地内部类和方法内部类本地内部类也叫本地方法内部类,局部内部类。指在一个方法内定义的类,只有在当前方法中才能对局......
  • LeetCode-Java-136. Single Number
    题目Givenanon-emptyarrayofintegers,everyelementappearstwiceexceptforone.Findthatsingleone.Note:Youralgorithmshouldhavealinearruntimecompl......
  • LeetCode-Java-637. Average of Levels in Binary Tree
    题目Givenanon-emptybinarytree,returntheaveragevalueofthenodesoneachlevelintheformofanarray.Example1:Input:3/\920/\15......
  • Java泛型链表实现
    ​​链表简介​​代码实现packagecom.chenxixuexi;/***泛型链表*单链表逆置数据--节点*求单链表倒数第K节点*求两个单链表是否相交相交交点*判断单链表是否有......
  • 15-咸鱼学Java-内部类
    实例内部类实例内部类简而言之就是类里面嵌入着类,就像环套环一样Demo:classOuterClass2//外部类{privateinta=1000;publicOuterClass2(){Sy......
  • LeetCode-Java-559. Maximum Depth of N-ary Tree
    题目Givenan-arytree,finditsmaximumdepth.Themaximumdepthisthenumberofnodesalongthelongestpathfromtherootnodedowntothefarthestleafnode......
  • 14-咸鱼学Java-面向对象基础:类
    类类就相当于自定义类型,有自己的数据域,有自己的方法。属于一种用户自定义类型。类的目的就是模拟现实中存在的物体,如一个Person类,一个人他有自己的名字,年龄,性别等等,他有自己......
  • 17-咸鱼学Java-内部类实际应用-Java链表
    ​​内部类​​,​​未使用内部类的链表​​可以点击名字查看。此篇文章主要介绍运用内部类的Java链表的写法。链表正如其名,就像一个一个珠子被串起来,只有前一个珠子和......