OpenJDK 源码阅读之 Java 字节流输入类的实现

Java 的输入输出老是给人一种很混乱的感受，要想把这个问题搞清楚，必须对各类与输入输出相关的类之间的关系有所了解。只有你了解了他们之间的关系，知道设计这个类的目的是什么，才能更从容的使用他们。

咱们先对 Java I/O 的整体结构进行一个总结，再经过分析源代码，给出把每一个类的关键功能是如何实现的。

Java I/O 的主要结构

Java 的输入输出，主要分为如下几个部分：

• 字节流
• 字符流
• 新 I/O

每一个部分，都包含了输入和输出两部分。

实现概要

这里只给出每一个类的实现概要，具体每一个类的实现分析，能够参见个人 GitHub-SourceLearning-OpenJDK 页面。根据导航中的连接，进入 java.io ，便可看到对每一个类的分析。

字节流输入

图1 Java 字节输入类

• InputStream

InputStream 是全部字节输入类的基类，它有一个未实现的 read 方法，子类须要实现这个 read 方法， 它和数据的来源相关。它的各类不一样子类，或者是添加了功能，或者指明了不一样的数据来源。

public abstract int read() throws IOException;

• ByteArrayInputStream

ByteArrayInputStream 有一个内部 buffer ， 包含从流中读取的字节，还有一个内部 counter， 跟踪下一个要读入的字节。

protected byte buf[];
protected int pos;

这个类在初始化时，须要指定一个 byte[]，做为数据的来源，它的 read，就读入这个 byte[] 中所包含的数据。

public ByteArrayInputStream(byte buf[]) {
    this.buf = buf;
    this.pos = 0;
    this.count = buf.length;
}
public synchronized int read() {
    return (pos < count) ? (buf[pos++] & 0xff) : -1;
}

• FileInputStream

FileInputStream 的数据来源是文件，即从文件中读取字节。初始化时，须要指定一个文件：

public FileInputStream(File file) 
throws FileNotFoundException {
    String name = (file != null ? file.getPath() : null);
    SecurityManager security = System.getSecurityManager();
    if (security != null) {
        security.checkRead(name);
    }
    if (name == null) {
        throw new NullPointerException();
    }
    fd = new FileDescriptor();
    fd.incrementAndGetUseCount();
    open(name);
}

之后读取的数据，都来自于这个文件。这里的 read 方法是一个 native 方法，它的实现与操做系统相关。

public native int read() throws IOException;

• FilterInputStream

FilterInputStream将其它输入流做为数据来源，其子类能够在它的基础上，对数据流添加新的功能。咱们常常看到流之间的嵌套，以添加新的功能。就是在这个类的基础上实现的。因此，它的初始化中，会指定一个字节输入流：

    protected volatile InputStream in;
    protected FilterInputStream(InputStream in) {
        this.in = in;
    }

读取操做，就依靠这个流实现：

public int read() throws IOException {
    return in.read();
}

• BufferedInputStream

BufferedInputStream 是 FilterInputStream 的子类，因此，须要给它提供一个底层的流，用于读取，而它自己，则为此底层流增长功能，即缓冲功能。以减小读取操做的开销，提高效率。

protected volatile byte buf[];

内部缓冲区由一个 volatile byte 数组实现，大多线程环境下，一个线程向 volatile 数据类型中写入的数据，会当即被其它线程看到。

read 操做会先看一下缓冲区里的数据是否已经所有被读取了，若是是，就调用底层流，填充缓冲区，再从缓冲区中按要求读取指定的字节。

public synchronized int read() throws IOException {
    if (pos >= count) {
        fill();
        if (pos >= count)
            return -1;
    }
    return getBufIfOpen()[pos++] & 0xff;
}
private byte[] getBufIfOpen() throws IOException {
    byte[] buffer = buf;
    if (buffer == null)
        throw new IOException("Stream closed");
    return buffer;
}

• DataInputStream

DataInputStream 也是 FilterInputStream 的子类，它提供的功能是：能够从底层的流中读取基本数据类型，例如 int, char等等。DataInputStream 是非线程安全的， 你必须本身保证处理线程安全相关的细节。

例如，readBoolean 会读入一个字节，而后根据是否为0,返回 true/false。

public final boolean readBoolean() throws IOException {
    int ch = in.read();
    if (ch < 0)
        throw new EOFException();
    return (ch != 0);
}

readShort 会读入两个字节，而后拼接成一个 short 类型的数据。

public final short readShort() throws IOException {
    int ch1 = in.read();
    int ch2 = in.read();
    if ((ch1 | ch2) < 0)
        throw new EOFException();
    return (short)((ch1 << 8) + (ch2 << 0));
}

int 和 long 依此类推，分别读入4个字节，8个字节，而后进行拼接。

可是，浮点数就不能经过简单的拼接来解决了，而要读入足够的字节数，而后再按照 IEEE 754 的标准进行解释：

public final float readFloat() throws IOException {
    return Float.intBitsToFloat(readInt());
}

• PushbackInputstream

PushbackInputstream 类也是FilterInputStream的子类，它提供的功能是，能够将已经读入的字节，再放回输入流中，下次读取时，能够读取到这个放回的字节。这在某些情境下是很是有用的。它的实现，就是依靠相似缓冲区的原理。被放回的字节，其实是放在缓冲区里，读取时，先查看缓冲区里有没有字节，若是有就从这里读取，若是没有，就从底层流里读取。

缓冲区是一个字节数组：

protected byte[] buf;

读取时，优先从这里读取，读不到，再从底层流读取。

public int read() throws IOException {
    ensureOpen();
    if (pos < buf.length) {
        return buf[pos++] & 0xff;
    }
    return super.read();
}

• PipedInputStream

PipedInputStream 与 PipedOutputStream 配合使用，它们经过 connect 函数相关联。

public void connect(PipedOutputStream src) throws IOException {
    src.connect(this);
}

它们共用一个缓冲区，一个从中读取，一个从中写入。

PipedInputStream内部有一个缓冲区，

protected byte buffer[];

读取时，就从这里读：

public synchronized int read()  throws IOException {
    if (!connected) {
        throw new IOException("Pipe not connected");
    } else if (closedByReader) {
        throw new IOException("Pipe closed");
    } else if (writeSide != null && !writeSide.isAlive()
               && !closedByWriter && (in < 0)) {
        throw new IOException("Write end dead");
    }

    readSide = Thread.currentThread();
    int trials = 2;
    while (in < 0) {
        if (closedByWriter) {
            /* closed by writer, return EOF */
            return -1;
        }
        if ((writeSide != null) && (!writeSide.isAlive()) && (--trials < 0)) {
            throw new IOException("Pipe broken");
        }
        /* might be a writer waiting */
        notifyAll();
        try {
            wait(1000);
        } catch (InterruptedException ex) {
            throw new java.io.InterruptedIOException();
        }
    }
    int ret = buffer[out++] & 0xFF;
    if (out >= buffer.length) {
        out = 0;
    }
    if (in == out) {
        /* now empty */
        in = -1;
    }

    return ret;
}

过程比咱们想的要复杂，由于这涉及两个线程，须要相互配合，因此，须要检查不少东西，才能最终从缓冲区中读到数据。

PipedOutputStream 类写入时，会调用 PipedInputStream 的receive功能，把数据写入 PipedInputStream 的缓冲区。

咱们看一下 PipedOutputStream.write 函数：

public void write(int b)  throws IOException {
    if (sink == null) {
        throw new IOException("Pipe not connected");
    }
    sink.receive(b);
}

能够看出，调用了相关联的管道输入流的 receive 函数。

protected synchronized void receive(int b) throws IOException {
    checkStateForReceive();
    writeSide = Thread.currentThread();
    if (in == out)
        awaitSpace();
    if (in < 0) {
        in = 0;
        out = 0;
    }
    buffer[in++] = (byte)(b & 0xFF);
    if (in >= buffer.length) {
        in = 0;
    }
}

receive 的主要功能，就是把写入的数据放入缓冲区内。

注意注意的是，这两个类相互关联的对象，应该属于两个不一样的线程，不然，容易形成死锁。

这个系列的第一部分到此结束，扩展阅读部分的文章很是好，推荐阅读。

扩展阅读

• 深刻分析 Java I/O 的工做机制

• Java IO流学习总结