阿里巴巴代码规范(一)

一.编程规约

 1.命名风格‘

  1.代码中的命名不能以下划线或美元符号开始 也不能以下划线或者美元符号结束;

  2.代码中的命名不能是拼音或者英文混合,尽量不要使用纯拼音

  3.类名驼峰原则 UserManagerServiceImpl (第一个word首字母大写)

  4.方法驼峰原则 addUserInfo(第一个word首字母小写)

  5.常量名全部大写 单词之间用_隔开

  6.抽象类 使用 Abstract 和 Base 开头  异常类使用Exception结尾 测试类以测试的类的名字为开头 以Test为结尾

  7.数组定义 String[] args 

  8.POJO类 及普通的Java beans 中的布尔型常量 定义的时候 命名不要以is开头 例如isSure等

  9.包名统一使用 小写 点分隔符之间有且仅有一个自然语义的英语单词 ,包名统一使用单数形式 但如果类名中存在复数含义 类名可以使用复数形式

  10.杜绝 完全不规范的缩写 例如 Contribution  缩写成Cont

  11.为了保证代码良好的可阅性 尽可能使用完整的单词来表达其意

  12.如果模块 接口 类 中使用了设计模式 应该在命名中体现设计模式 提高可阅性

  13.接口类的方法和属性 不要添加任何 修饰符号 (public也不要加)保持代码的简洁性 加上有效的java doc 注释 ,尽量不要在接口中定义变量  如果必须 则一定是与接口方法有关  且一定跟整个应用有关

  14.接口和实现类

    1.强制 对于Service 和 Dao类 基于SOA(面向服务架构)的理念  暴露出来的一定是接口 内部的实现类 用Impl的后缀 与接口区别

    2.如果是形容能力的接口名称 取对应的形容词做接口名(通常是able形式) 如AbstractTranslator实现 TransLatable

  15.枚举类名建议加上 Enum后缀  枚举成员名称 需要全大写 单词间用下划线 隔开

  16.Service/Dao层方法命名公约

    A. Service/Dao层

      1.获取单个对象用 get做前缀

      2.获取多个对象用list做前缀

      3.获取统计值用count做前缀

      4.插入的方法用save/insert做前缀

      5.删除的方法用remove/delete做前缀

      6.修改的方法用update做前缀

    B.领域模型命名规约

      1.数据对象: xxxDO xxx一般为数据表名

      2.数据传输对象:  xxxDTO xxx为业务相关领域的名称

      3.展示对象:xxxVO xxx一般为网页名称

      4.POJO是DO/DTO/BO/VO的统称 禁止命名为 xxxPOJO 

  

 

  

 

posted @ 2019-09-25 17:16  橘柑之味  阅读(2149)  评论(0编辑  收藏  举报