boolean
形参的 public 方法。
如果某个 public 方法(API 的一部分)不是 setter,则向该方法添加 boolean
形参几乎始终是一种不好的做法。
使用此类方法读取代码时,如果不查看源代码或文档,会很难理解 boolean
的含义。
此问题也被称为布尔陷阱。
boolean
形参通常可以替换为 enum
。
示例:
// 警告:在查看对此方法的
// 调用时,很难理解
// 布尔形参的含义
public boolean setPermission(File f,
int access,
boolean enable,
boolean ownerOnly) {
// ...
}
使用仅报告具有多个布尔形参的方法选项可以仅在一个方法包含多个布尔形参时发出警告。