Appendix-IO-Streams.md

[TOC]

附录:流式IO

Java 7 引入了一种简单明了的方式来读写文件和操作目录。大多情况下，文件这一章所介绍的那些库和技术就足够你用了。但是，如果你必须面对一些特殊的需求和比较底层的操作，或者处理一些老版本的代码，那么你就必须了解本附录中的内容。

对于编程语言的设计者来说，实现良好的输入/输出（I/O）系统是一项比较艰难的任务，不同实现方案的数量就可以证明这点。其中的挑战似乎在于要涵盖所有的可能性，你不仅要覆盖到不同的 I/O 源和 I/O 接收器（如文件、控制台、网络连接等），还要实现多种与它们进行通信的方式（如顺序、随机访问、缓冲、二进制、字符、按行和按字等）。

Java 类库的设计者通过创建大量的类来解决这一难题。一开始，你可能会对 Java I/O 系统提供了如此多的类而感到不知所措。Java 1.0 之后，Java 的 I/O 类库发生了明显的改变，在原来面向字节的类中添加了面向字符和基于 Unicode 的类。在 Java 1.4 中，为了改进性能和功能，又添加了 nio 类（全称是 “new I/O”，Java 1.4 引入，到现在已经很多年了）。这部分在附录：新 I/O 中介绍。

因此，要想充分理解 Java I/O 系统以便正确运用它，我们需要学习一定数量的类。另外，理解 I/O 类库的演化过程也很有必要，因为如果缺乏历史的眼光，很快我们就会对什么时候该使用哪些类，以及什么时候不该使用它们而感到困惑。

编程语言的 I/O 类库经常使用流这个抽象概念，它将所有数据源或者数据接收器表示为能够产生或者接收数据片的对象。

注意：Java 8 函数式编程中的 Stream 类和这里的 I/O stream 没有任何关系。这又是另一个例子，如果再给设计者一次重来的机会，他们将使用不同的术语。

I/O 流屏蔽了实际的 I/O 设备中处理数据的细节：

1. 字节流对应原生的二进制数据；
2. 字符流对应字符数据，它会自动处理与本地字符集之间的转换；
3. 缓冲流可以提高性能，通过减少底层 API 的调用次数来优化 I/O。

从 JDK 文档的类层次结构中可以看到，Java 类库中的 I/O 类分成了输入和输出两部分。在设计 Java 1.0 时，类库的设计者们就决定让所有与输入有关系的类都继承自 InputStream，所有与输出有关系的类都继承自 OutputStream。所有从 InputStream 或 Reader 派生而来的类都含有名为 read() 的基本方法，用于读取单个字节或者字节数组。同样，所有从 OutputStream 或 Writer 派生而来的类都含有名为 write() 的基本方法，用于写单个字节或者字节数组。但是，我们通常不会用到这些方法，它们之所以存在是因为别的类可以使用它们，以便提供更有用的接口。

我们很少使用单一的类来创建流对象，而是通过叠合多个对象来提供所期望的功能（这是装饰器设计模式）。为了创建一个流，你却要创建多个对象，这也是 Java I/O 类库让人困惑的主要原因。

这里我只会提供这些类的概述，并假定你会使用 JDK 文档来获取它们的详细信息（比如某个类的所以方法的详细列表）。

输入流类型

InputStream 表示那些从不同数据源产生输入的类，如表 I/O-1 所示，这些数据源包括：

1. 字节数组；
2. String 对象；
3. 文件；
4. “管道”，工作方式与实际生活中的管道类似：从一端输入，从另一端输出；
5. 一个由其它种类的流组成的序列，然后我们可以把它们汇聚成一个流；
6. 其它数据源，如 Internet 连接。

每种数据源都有相应的 InputStream 子类。另外，FilterInputStream 也属于一种 InputStream，它的作用是为“装饰器”类提供基类。其中，“装饰器”类可以把属性或有用的接口与输入流连接在一起，这个我们稍后再讨论。

表 I/O-1 InputStream 类型

类	功能	构造器参数	如何使用
ByteArrayInputStream	允许将内存的缓冲区当做 InputStream 使用	缓冲区，字节将从中取出	作为一种数据源：将其与 FilterInputStream 对象相连以提供有用接口
StringBufferInputStream	将 String 转换成 InputStream	字符串。底层实现实际使用 StringBuffer	作为一种数据源：将其与 FilterInputStream 对象相连以提供有用接口
FileInputStream	用于从文件中读取信息	字符串，表示文件名、文件或 FileDescriptor 对象	作为一种数据源：将其与 FilterInputStream 对象相连以提供有用接口
PipedInputStream	产生用于写入相关 PipedOutputStream 的数据。实现“管道化”概念	PipedOutputSteam	作为多线程中的数据源：将其与 FilterInputStream 对象相连以提供有用接口
SequenceInputStream	将两个或多个 InputStream 对象转换成一个 InputStream	两个 InputStream 对象或一个容纳 InputStream 对象的容器 Enumeration	作为一种数据源：将其与 FilterInputStream 对象相连以提供有用接口
FilterInputStream	抽象类，作为“装饰器”的接口。其中，“装饰器”为其它的 InputStream 类提供有用的功能。见表 I/O-3	见表 I/O-3	见表 I/O-3

输出流类型

如表 I/O-2 所示，该类别的类决定了输出所要去往的目标：字节数组（但不是 String，当然，你也可以用字节数组自己创建）、文件或管道。

另外，FilterOutputStream 为“装饰器”类提供了一个基类，“装饰器”类把属性或者有用的接口与输出流连接了起来，这些稍后会讨论。

表 I/O-2：OutputStream 类型

类	功能	构造器参数	如何使用
ByteArrayOutputStream	在内存中创建缓冲区。所有送往“流”的数据都要放置在此缓冲区	缓冲区初始大小（可选）	用于指定数据的目的地：将其与 FilterOutputStream 对象相连以提供有用接口
FileOutputStream	用于将信息写入文件	字符串，表示文件名、文件或 FileDescriptor 对象	用于指定数据的目的地：将其与 FilterOutputStream 对象相连以提供有用接口
PipedOutputStream	任何写入其中的信息都会自动作为相关 PipedInputStream 的输出。实现“管道化”概念	PipedInputStream	指定用于多线程的数据的目的地：将其与 FilterOutputStream 对象相连以提供有用接口
FilterOutputStream	抽象类，作为“装饰器”的接口。其中，“装饰器”为其它 OutputStream 提供有用功能。见表 I/O-4	见表 I/O-4	见表 I/O-4

添加属性和有用的接口

装饰器在泛型这一章引入。Java I/O 类库需要多种不同功能的组合，这正是使用装饰器模式的原因所在¹。而之所以存在 filter（过滤器）类，是因为让抽象类 filter 作为所有装饰器类的基类。装饰器必须具有和它所装饰对象相同的接口，但它也可以扩展接口，不过这种情况只发生在个别 filter 类中。

但是，装饰器模式也有一个缺点：在编写程序的时候，它给我们带来了相当多的灵活性（因为我们可以很容易地对属性进行混搭），但它同时也增加了代码的复杂性。Java I/O 类库操作不便的原因在于：我们必须创建许多类（“核心” I/O 类型加上所有的装饰器）才能得到我们所希望的单个 I/O 对象。

FilterInputStream 和 FilterOutputStream 是用来提供装饰器类接口以控制特定输入流 InputStream 和 输出流 OutputStream 的两个类，但它们的名字并不是很直观。FilterInputStream 和 FilterOutputStream 分别从 I/O 类库中的基类 InputStream 和 OutputStream 派生而来，这两个类是创建装饰器的必要条件（这样它们才能为所有被装饰的对象提供统一接口）。

通过 FilterInputStream 从 InputStream 读取

FilterInputStream 类能够完成两件截然不同的事情。其中，DataInputStream 允许我们读取不同的基本数据类型和 String 类型的对象（所有方法都以 “read” 开头，例如 readByte()、readFloat()等等）。搭配其对应的 DataOutputStream，我们就可以通过数据“流”将基本数据类型的数据从一个地方迁移到另一个地方。具体是那些“地方”是由表 I/O-1 中的那些类决定的。

其它 FilterInputStream 类则在内部修改 InputStream 的行为方式：是否缓冲，是否保留它所读过的行（允许我们查询行数或设置行数），以及是否允许把单个字符推回输入流等等。最后两个类看起来就像是为了创建编译器提供的（它们被添加进来可能是为了对“用 Java 构建编译器”实现提供支持），因此我们在一般编程中不会用到它们。

在实际应用中，不管连接的是什么 I/O 设备，我们基本上都会对输入进行缓冲。所以当初 I/O 类库如果能默认都让输入进行缓冲，同时将无缓冲输入作为一种特殊情况（或者只是简单地提供一个方法调用），这样会更加合理，而不是像现在这样迫使我们基本上每次都得手动添加缓冲。

表 I/O-3：FilterInputStream 类型

类	功能	构造器参数	如何使用
DataInputStream	与 DataOutputStream 搭配使用，按照移植方式从流读取基本数据类型（int、char、long 等）	InputStream	包含用于读取基本数据类型的全部接口
BufferedInputStream	使用它可以防止每次读取时都得进行实际写操作。代表“使用缓冲区”	InputStream，可以指定缓冲区大小（可选）	本质上不提供接口，只是向进程添加缓冲功能。与接口对象搭配
LineNumberInputStream	跟踪输入流中的行号，可调用 getLineNumber() 和 setLineNumber(int)	InputStream	仅增加了行号，因此可能要与接口对象搭配使用
PushbackInputStream	具有能弹出一个字节的缓冲区，因此可以将读到的最后一个字符回退	InputStream	通常作为编译器的扫描器，我们可能永远也不会用到

通过 FilterOutputStream 向 OutputStream 写入

与 DataInputStream 对应的是 DataOutputStream，它可以将各种基本数据类型和 String 类型的对象格式化输出到“流”中，。这样一来，任何机器上的任何 DataInputStream 都可以读出它们。所有方法都以 “write” 开头，例如 writeByte()、writeFloat() 等等。

PrintStream 最初的目的就是为了以可视化格式打印所有基本数据类型和 String 类型的对象。这和 DataOutputStream 不同，后者的目的是将数据元素置入“流”中，使 DataInputStream 能够可移植地重构它们。

PrintStream 内有两个重要方法：print() 和 println()。它们都被重载了，可以打印各种各种数据类型。print() 和 println() 之间的差异是，后者在操作完毕后会添加一个换行符。

PrintStream 可能会造成一些问题，因为它捕获了所有 IOException（因此，我们必须使用 checkError() 自行测试错误状态，如果出现错误它会返回 true）。另外，PrintStream 没有处理好国际化问题。这些问题都在 PrintWriter 中得到了解决，这在后面会讲到。

BufferedOutputStream 是一个修饰符，表明这个“流”使用了缓冲技术，因此每次向流写入的时候，不是每次都会执行物理写操作。我们在进行输出操作的时候可能会经常用到它。

表 I/O-4：FilterOutputStream 类型

类	功能	构造器参数	如何使用
DataOutputStream	与 DataInputStream 搭配使用，因此可以按照移植方式向流中写入基本数据类型（int、char、long 等）	OutputStream	包含用于写入基本数据类型的全部接口
PrintStream	用于产生格式化输出。其中 DataOutputStream 处理数据的存储，PrintStream 处理显示	OutputStream，可以用 boolean 值指示是否每次换行时清空缓冲区（可选）	应该是对 OutputStream 对象的 final 封装。可能会经常用到它
BufferedOutputStream	使用它以避免每次发送数据时都进行实际的写操作。代表“使用缓冲区”。可以调用 flush() 清空缓冲区	OutputStream，可以指定缓冲区大小（可选）	本质上并不提供接口，只是向进程添加缓冲功能。与接口对象搭配

Reader和Writer

RandomAccessFile类

IO流典型用途

本章小结

Footnotes

1. 很难说这就是一个很好的设计选择，尤其是与其它编程语言中简单的 I/O 类库相比较。但它确实是如此选择的一个正当理由。 ↩