《阿里巴巴Java开发手册(终极版)》1-3之格式规约

编程规约 - 代码格式

修改项:第 2 项、第 4 项

新增项:第 6 项

  1. 【强制】大括号的使用约定。如果是大括号内为空,则简洁地写成{}即可,不需要换行 ; 如果
    是非空代码块则:
    1 ) 左大括号前不换行。
    2 ) 左大括号后换行。
    3 ) 右大括号前换行。
    4 ) 右大括号后还有 else 等代码则不换行 ; 表示终止右大括号后必须换行。
  2. 【强制】 左小括号和字符之间不出现空格 ; 同样,右小括号和字符之间也不出现空格。详见
    第 5 条下方正例提示。
    反例: if (空格 a == b 空格)
  3. 【强制】 if / for / while / switch / do 等保留字与左右括号之间都必须加空格。

《阿里巴巴Java开发手册(终极版)》1-2之常量定义

编程规约 - 常量定义

修改:第 3 项、第 5 项

  1. 【强制】不允许出现任何魔法值 ( 即未经定义的常量 ) 直接出现在代码中。
    反例:

    String key =" Id # taobao _"+ tradeId;
    cache . put(key ,  value);
    
  2. 【强制】 long 或者 Long 初始赋值时,必须使用大写的 L ,不能是小写的 l ,小写容易跟数字
    1 混淆,造成误解。
    说明:

    Long a = 2 l;
    

    写的是数字的 21,还是 Long 型的 2?

已经同步最终版

序言

首先,这肯定是一个非常重大的消息。绝对是Java程序员的福利啊,终于结束了一个公司一套规范的编程生涯。这对业界规范来说也起到了很好的推动作用。俗话说:无规矩不方圆,生活中各种法律道德的约束,出门还有交规的限制。相信小伙伴们一定经历过 坑,有了这本规范手册,你是不是该好好学习一下呢?

目录章节

内容分五大类,总共19章节:

索引 一级目录 二级目录
编程规约 命名规约、常量定义、代码格式、OOP规约、集合处理、并发处理、控制语句、注释规约、其它
异常日志 异常处理、日志规约
单元测试
安全规约
MySQL数据库 建表规约、索引规约、SQL语句、ORM映射
工程结构 应用分层、二方库依赖、服务器
| | 总字数统计:89.5k