《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元素编写文档注释

上一篇:CQI修正


下一篇:A - Period(kmp的next数组的应用)