《Effective Java 2nd》第7章 方法

目录

第38条 检查参数的有效性

第39条 必要时进行保护性拷贝

第40条 谨慎设计方法签名

第41条 慎用重载

第42条 慎用可变参数

第43条 返回零长度的数组或集合，而不是null

第44条 为所有导出的API元素编写文档注释

关注点：可用性、健壮性、灵活性

第38条 检查参数的有效性

在编写方法或者构造器的时候，应该考虑参数有哪些限制，并显式检查

第39条 必要时进行保护性拷贝

如果类具有从客户端得到或者返回到客户端的可变组件，为了维持不可变性，必要时进行保护性拷贝。

否则，在文档中写明，不可修改此组件。

举例：

public final class Period {
   private final Date start;
   private final Date end;
   public Period(Date start, Date end) {
      if (start.compareTo(end) > 0) {
         throw new IllegalArgumentException(strat + "after" + end);
      }
      this.start = start;
      this.end = end;
   }
   public Date start() {
      return start;
   }
   public Date end() {
      return end;
   }
}

Period表示一段不可变的时间周期。

但是，Period并不是不可变的！！！因为Date是可变的。

Date start = new Date();
Date end = new Date();
Period p = new Period(strat, end);
end.setYear(78);//因为Date是可变的，导致p被修改了

解决方法：

public Period(Date start, Date end) {
      //先进行保护性拷贝，然后再对拷贝后的进行检查
      this.start = new Date(start.getTime()); //使用保护性拷贝
      this.end = new Date(end.getTime()); //使用保护性拷贝
      if (this.start.compareTo(this.end) > 0) {
         throw new IllegalArgumentException(strat + "after" + end);
      }
   }

Period仍旧是可以被改变的。

Date start = new Date();
Date end = new Date();
Period p = new Period(strat, end);
p.end().setYear(78);//因为Date是可变的，导致p被修改了

解决方法：

   public Date start() {
      return new Date(start.getTime());
   }
   public Date end() {
      return new Date(end.getTime());
   }

第40条 谨慎设计方法签名

1.避免过长的参数列表。4个参数，或者更少。

不要定义相同类型的长参数序列，容易不小心弄错了参数顺序。

如何缩短过长参数列表？

1）拆分成多个方法

2）创建辅助类，保存参数的分组。

3）采用Builder模式。在方法带有多个参数，且有些是可选参数的时候，这个方法尤其有用！

2.对于参数类型，优先使用接口而不是类。

3.对于boolean类型，优先使用两个元素的枚举类型

第41条 慎用重载

为何慎用重载？

因为在特殊情形(类型转换、自动装箱拆箱等)下，很难确定到底哪个重载方法会被调用。

建议

1) 对于多个有相同参数数目的方法来说，应尽量避免重载。

2）要避免这种情况：同一组参数只需经过类型转换就能传递给不同的重载方法。

举例：m(List<?> s)，m(Set<?> s)，m(Collection<?> s)。

第42条 慎用可变参数

在重视性能情况下，使用可变参数要小心。可变参数的每次调用都会导致一次数组分配和初始化。

如何改进？当确定95%的调用有3个或更少的参数时，定义5个重载方法。

m()

m(int a)

m(int a, int b)

m(int a, int b, int c)

m(int a, int b, int c, int ....rest)

第43条 返回零长度的数组或集合，而不是null

对于返回类型为数组或集合的方法返回一个零长度的数组或者集合，而不是返回null。

第44条 为所有导出的API元素编写文档注释