上一节课我们学习了桥接模式,桥接模式有两种理解方式。

  • 第一种理解方式是“将抽象和实现解耦,让它们能独立开发”。这种理解方式比较特别,应用场景也不多。
  • 另一种理解方式更加简单,类似“组合优于继承”设计原则,这种理解方式更加通用,应用场景比较多。不管是哪种理解方式,它们的代码结构都是相同的,都是一种类之间的组合关系。

今天,我们通过剖析 Java IO 类的设计思想,再学习一种新的结构型模式,装饰器模式。
装饰器模式的代码结构跟桥接模式非常相似,不过,要解决的问题却大不相同。
话不多说,让我们正式开始今天的学习吧!

Java IO 类的“奇怪”用法

Java IO 类库非常庞大和复杂,有几十个类,负责 IO 数据的读取和写入。
如果对 Java IO 类做一下分类,我们可以从下面两个维度将它划分为四类。
具体如下所示:
image.png

针对不同的读取和写入场景,Java IO 又在这四个父类基础之上,扩展出了很多子类。
具体如下所示:
image.png
在我初学 Java 的时候,曾经对 Java IO 的一些用法产生过很大疑惑,比如下面这样一段代码。
我们打开文件 test.txt,从中读取数据。其中:

  • InputStream 是一个抽象类;
  • FileInputStream 是专门用来读取文件流的子类;
  • BufferedInputStream 是一个支持带缓存功能的数据读取类,可以提高数据读取的效率。
    1. InputStream in = new FileInputStream("/user/wangzheng/test.txt");
    2. InputStream bin = new BufferedInputStream(in);
    3. byte[] data = new byte[128];
    4. while (bin.read(data) != -1) {
    5. //...
    6. }

初看上面的代码,我们会觉得 Java IO 的用法比较麻烦,需要先创建一个 FileInputStream 对象,然后再传递给 BufferedInputStream 对象来使用。
我在想,Java IO 为什么不设计一个继承 FileInputStream 并且支持缓存的 BufferedFileInputStream 类呢?这样我们就可以像下面的代码中这样,直接创建一个 BufferedFileInputStream 类对象,打开文件读取数据,用起来岂不是更加简单?

  1. InputStream bin = new BufferedFileInputStream("/user/wangzheng/test.txt");
  2. byte[] data = new byte[128];
  3. while (bin.read(data) != -1) {
  4. //...
  5. }

基于继承的设计方案

如果 InputStream 只有一个子类 FileInputStream 的话,那我们在 FileInputStream 基础之上,再设计一个孙子类 BufferedFileInputStream,也算是可以接受的,毕竟继承结构还算简单。
但实际上,继承 InputStream 的子类有很多。我们需要给每一个 InputStream 的子类,再继续派生支持缓存读取的子类。
除了支持缓存读取之外,如果我们还需要对功能进行其他方面的增强,比如下面的 DataInputStream 类,支持按照基本数据类型(int、boolean、long 等)来读取数据。

  1. FileInputStream in = new FileInputStream("/user/wangzheng/test.txt");
  2. DataInputStream din = new DataInputStream(in);
  3. int data = din.readInt();

在这种情况下,如果我们继续按照继承的方式来实现的话,就需要再继续派生出 DataFileInputStream、DataPipedInputStream 等类。如果我们还需要既支持缓存、又支持按照基本类型读取数据的类,那就要再继续派生出 BufferedDataFileInputStream、BufferedDataPipedInputStream 等 n 多类。


这还只是附加了两个增强功能,如果我们需要附加更多的增强功能,那就会导致组合爆炸,类继承结构变得无比复杂,代码既不好扩展,也不好维护。
这也是我们在第 10 节中讲的不推荐使用继承的原因。

基于装饰器模式的设计方案

在第 10 节中,我们还讲到“组合优于继承”,可以“使用组合来替代继承”。
针对刚刚的继承结构过于复杂的问题,我们可以通过将继承关系改为组合关系来解决。
下面的代码展示了 Java IO 的这种设计思路。不过,我对代码做了简化,只抽象出了必要的代码结构,如果你感兴趣的话,可以直接去查看 JDK 源码。

  1. public abstract class InputStream {
  2. //...
  3. public int read(byte b[]) throws IOException {
  4. return read(b, 0, b.length);
  5. }
  6. public int read(byte b[], int off, int len) throws IOException {
  7. //...
  8. }
  9. public long skip(long n) throws IOException {
  10. //...
  11. }
  12. public int available() throws IOException {
  13. return 0;
  14. }
  15. public void close() throws IOException {
  16. }
  17. public synchronized void mark(int readlimit) {
  18. }
  19. public synchronized void reset() throws IOException {
  20. throw new IOException("mark/reset not supported");
  21. }
  22. public boolean markSupported() {
  23. return false;
  24. }
  25. }
  26. public class BufferedInputStream extends InputStream {
  27. protected volatile InputStream in;
  28. protected BufferedInputStream(InputStream in) {
  29. this.in = in;
  30. }
  31. //...实现基于缓存的读数据接口...
  32. }
  33. public class DataInputStream extends InputStream {
  34. protected volatile InputStream in;
  35. protected DataInputStream(InputStream in) {
  36. this.in = in;
  37. }
  38. //...实现读取基本类型数据的接口
  39. }

装饰器模式相对于简单的组合关系,有两个特殊的地方

看了上面的代码,你可能会问,那装饰器模式就是简单的“用组合替代继承”吗?当然不是。从 Java IO 的设计来看,装饰器模式相对于简单的组合关系,还有两个比较特殊的地方。

装饰器类和原始类继承同样的父类

第一个比较特殊的地方是:装饰器类和原始类继承同样的父类,这样我们可以对原始类“嵌套”多个装饰器类。
比如,下面这样一段代码,我们对 FileInputStream 嵌套了两个装饰器类:BufferedInputStream 和 DataInputStream,让它既支持缓存读取,又支持按照基本数据类型来读取数据。

  1. InputStream in = new FileInputStream("/user/wangzheng/test.txt");
  2. InputStream bin = new BufferedInputStream(in);
  3. DataInputStream din = new DataInputStream(bin);
  4. int data = din.readInt();

装饰器类是对功能的增强

第二个比较特殊的地方是:装饰器类是对功能的增强,这也是装饰器模式应用场景的一个重要特点。
实际上,符合“组合关系”这种代码结构的设计模式有很多,比如之前讲过的代理模式、桥接模式,还有现在的装饰器模式。尽管它们的代码结构很相似,但是每种设计模式的意图是不同的。就拿比较相似的代理模式和装饰器模式来说吧,代理模式中,代理类附加的是跟原始类无关的功能,而在装饰器模式中,装饰器类附加的是跟原始类相关的增强功能。

  1. // 代理模式的代码结构(下面的接口也可以替换成抽象类)
  2. public interface IA {
  3. void f();
  4. }
  5. public class A impelements IA {
  6. public void f() { //...
  7. }
  8. }
  9. public class AProxy impements IA {
  10. private IA a;
  11. public AProxy(IA a) {
  12. this.a = a;
  13. }
  14. public void f() {
  15. // 新添加的代理逻辑
  16. a.f();
  17. // 新添加的代理逻辑
  18. }
  19. }
  20. // 装饰器模式的代码结构(下面的接口也可以替换成抽象类)
  21. public interface IA {
  22. void f();
  23. }
  24. public class A impelements IA {
  25. public void f() { //...
  26. }
  27. }
  28. public class ADecorator impements IA {
  29. private IA a;
  30. public ADecorator(IA a) {
  31. this.a = a;
  32. }
  33. public void f() {
  34. // 功能增强代码
  35. a.f();
  36. // 功能增强代码
  37. }
  38. }

实际上,如果去查看 JDK 的源码,你会发现,BufferedInputStream、DataInputStream 并非继承自 InputStream,而是另外一个叫 FilterInputStream 的类。那这又是出于什么样的设计意图,才引入这样一个类呢?
我们再重新来看一下 BufferedInputStream 类的代码。InputStream 是一个抽象类而非接口,而且它的大部分函数(比如 read()、available())都有默认实现,按理来说,我们只需要在 BufferedInputStream 类中重新实现那些需要增加缓存功能的函数就可以了,其他函数继承 InputStream 的默认实现。但实际上,这样做是行不通的。
对于即便是不需要增加缓存功能的函数来说,BufferedInputStream 还是必须把它重新实现一遍,简单包裹对 InputStream 对象的函数调用。
具体的代码示例如下所示。
如果不重新实现,那 BufferedInputStream 类就无法将最终读取数据的任务,委托给传递进来的 InputStream 对象来完成。

我的理解:因为 InputStream 的部分函数有默认实现,又 BufferedInputStream 继承 InputStream,如果 BufferedInputStream 不重写这部分方法的话,那么调用 BufferedInputStream 的这些方法,将执行的是继承的 InputStream 的默认实现,而不依赖注入的 InputStream 的对应实现。

这一部分稍微有点不好理解,你自己多思考一下。

  1. public class BufferedInputStream extends InputStream {
  2. protected volatile InputStream in;
  3. protected BufferedInputStream(InputStream in) {
  4. this.in = in;
  5. }
  6. // f()函数不需要增强,只是重新调用一下InputStream in对象的f()
  7. public void f() {
  8. in.f();
  9. }
  10. }

实际上,DataInputStream 也存在跟 BufferedInputStream 同样的问题。
为了避免代码重复,Java IO 抽象出了一个装饰器父类 FilterInputStream,代码实现如下所示。
InputStream 的所有的装饰器类(BufferedInputStream、DataInputStream)都继承自这个装饰器父类。这样,装饰器类只需要实现它需要增强的方法就可以了,其他方法继承装饰器父类的默认实现。

  1. public class FilterInputStream extends InputStream {
  2. protected volatile InputStream in;
  3. protected FilterInputStream(InputStream in) {
  4. this.in = in;
  5. }
  6. public int read() throws IOException {
  7. return in.read();
  8. }
  9. public int read(byte b[]) throws IOException {
  10. return read(b, 0, b.length);
  11. }
  12. public int read(byte b[], int off, int len) throws IOException {
  13. return in.read(b, off, len);
  14. }
  15. public long skip(long n) throws IOException {
  16. return in.skip(n);
  17. }
  18. public int available() throws IOException {
  19. return in.available();
  20. }
  21. public void close() throws IOException {
  22. in.close();
  23. }
  24. public synchronized void mark(int readlimit) {
  25. in.mark(readlimit);
  26. }
  27. public synchronized void reset() throws IOException {
  28. in.reset();
  29. }
  30. public boolean markSupported() {
  31. return in.markSupported();
  32. }
  33. }

重点回顾

好了,今天的内容到此就讲完了。我们一块来总结回顾一下,你需要重点掌握的内容。
装饰器模式主要解决继承关系过于复杂的问题,通过组合来替代继承。
它主要的作用是给原始类添加增强功能。这也是判断是否该用装饰器模式的一个重要的依据。
除此之外,装饰器模式还有一个特点,那就是可以对原始类嵌套使用多个装饰器。
为了满足这个应用场景,在设计的时候,装饰器类需要跟原始类继承相同的抽象类或者接口。

课堂讨论

在上节课中,我们讲到,可以通过代理模式给接口添加缓存功能。
在这节课中,我们又通过装饰者模式给 InputStream 添加缓存读取数据功能。
那对于“添加缓存”这个应用场景来说,我们到底是该用代理模式还是装饰器模式呢?你怎么看待这个问题?