阿里巴巴Java开发编码规范——控制语句

目录

强制

推荐

参考

---

强制

1.在一个switch块内，每个case要么通过continue/break/return等来终止，要么注释说明程序将继续执行到哪一个case为止；在每一个switch块内，都必须包含一个default语句并且放到最后，即使它什么代码也没有。其中break是退出switch语句块，而return是退出方法体。

2.当switch括号内的变量类型为String并且此变量为外部参数时，必须先进行null判断。不过好像在jdk1.8以上的环境上不让switch括号内的变量类型为String，也可能是其他的原因。

3.在if/else/for/while/do语句中必须使用大括号。即使只有一行代码，也避免采用单行的编码方式。

4.在高并发场景中，避免使用“等于”判断来作为中断或者退出的条件。因为如果并发控制没有处理好，容易产生等值判断被“击穿”的情况，应该使用大于或者小于的区间判断条件来代替。

推荐

1.表达异常的分支时，少用if-else方式，if-else表达逻辑太多会使后续代码维护困难，不要超过三层。超过三层的if-else逻辑判断代码可以使用卫语句、策略模式、状态模式等来实现，其中卫语句即代码逻辑先考虑失败、异常、中断、退出等直接返回的情况，以方法多个出口的方式，解决代码中判断分支嵌套的问题。

2.除常用方法(如getXxx/isXxx)等外，不要在条件判断中执行其他复杂的语句，将复杂逻辑判断的结果赋值给一个有意义的布尔变量名，可以提高可读性。

3.不要在其他表达式（尤其是条件表达式）中插入赋值语句。

4.循环体中的语句要考虑性能，以下操作尽量移至循环体外处理，如定义对象、变量、获取数据库连接，进行不必要的try-catch操作等。

5.避免采用取反逻辑运算符。

6.接口入参保护，这种场景常见的是用作批量操作的接口。

参考

1.下列情形需要进行参数校验：

•     调用频次低的方法
•     执行时间开销很大的方法。
•     需要极高稳定性和可用性的方法
•     对外提供的开放接口，不管是RPC/API/HTTP接口
•     敏感权限入口

2.下列情形不需要进行参数校验：

•     极有可能被循环调用的方法。但在方法说明里必须注明外部参数检查要求
•     底层调用频度比较高的方法
•     被声明成private只会被自己代码所调用的方法。