java IO笔记（FileterInputStream/FilterOutputStream）

本篇讲述的是java io包中的FilterInputStream和FilterOutputStreaem，老规矩，先附上两个类的源码。

FilterInputStream：

package java.io;

public class FilterInputStream extends InputStream {
    /**
     * 内部声明了一个InputStream对象的句柄，用于接收传入的InputStream对象。同时用volatile关键字修饰，确保了数据改变时的可见性。
     */
    protected volatile InputStream in;

    /**
     * 一个被protected关键字修饰的构造汉方，含义一个参数，参数类型为InputStream类型，将传入的InputStream对象赋值给声明的句柄in。
     */
    protected FilterInputStream(InputStream in) {
        this.in = in;
    }

    /**
     * 定义了一个不带参的read方法，只是简单的调用了InputStream的read方法，每次读取一个字节的数据，用于读取流中数据。
     */
    public int read() throws IOException {
        return in.read();
    }

    /**
     * 定义了一个带一个参数的read方法，内部实际上是调用了InputStream对应的read方法，每次可以通过传入的字节数组作为缓存区读取一片数据。
     */
    public int read(byte b[]) throws IOException {
        return read(b, 0, b.length);
    }

    /**
     * 定义了一个带三个参数的read方法，内部实际上是调用了InputStream对应的read方法。可以通过传入的数组作为缓存，另外两个参数控制的是从缓存中读取的位置以
     * 及长度，每次可以读取一片数据。
     */
    public int read(byte b[], int off, int len) throws IOException {
        return in.read(b, off, len);
    }

    /**
     * 定义了一个带一个参数的skip方法，内部实质是调用InputStream中的skip方法。用于跳过指定长度的数据，进行数据读取。
     */
    public long skip(long n) throws IOException {
        return in.skip(n);
    }

    /**
     * 定义了一个available方法，内部实质是调用了InputStream的available方法，用于获取流中仍可以读取字节数。
     */
    public int available() throws IOException {
        return in.available();
    }

    /**
     * 定义了一个close方法，内部实质是调用了InputStream的close方法，用于关闭流。
     */
    public void close() throws IOException {
        in.close();
    }

    /**
     * 定义了一个mark方法，内部实质是调用了InputStream的mark方法，用于在流中留下标记，与reset方法联合使用，可以回到标记处继续读取数据。
     */
    public synchronized void mark(int readlimit) {
        in.mark(readlimit);
    }

    /**
     * 定义了一个reset方法，内部实质是调用了InputStream的reset方法，与mark方法联合使用，可以回到标记的地方继续读取数据。
     */
    public synchronized void reset() throws IOException {
        in.reset();
    }

    /**
     * 定义了一个markSupported方法，内部实质是调用了InputStream的markSupported方法，返回的boolean值表示当前流是否支持标记功能。
     */
    public boolean markSupported() {
        return in.markSupported();
    }
}

FilterOutputStream：

package java.io;

public class FilterOutputStream extends OutputStream {
    /**
     * 内部声明了一个OutputStream对象的句柄，用于接收传入的OutputStream对象。
     */
    protected OutputStream out;

    /**
     * 一个带一个参数的构造函数，参数为一个OutputStream对象，将传入的OutputStream对象赋值给声明的句柄out。
     */
    public FilterOutputStream(OutputStream out) {
        this.out = out;
    }

    /**
     * 定义了一个write方法，内部实质调用的是OutputStream对象的write方法，每次写人一个字节。
     */
    public void write(int b) throws IOException {
        out.write(b);
    }

    /**
     * 定义了一个带一个参数的write方法，参数类型为一个byte类型数组，内部实质上调用了OutputStream对象的write方法。
     */
    public void write(byte b[]) throws IOException {
        write(b, 0, b.length);
    }

    /**
     * 内部实质上调用的OutputStream的write方法，一次可以写入一段数据。
     */
    public void write(byte b[], int off, int len) throws IOException {
        if ((off | len | (b.length - (len + off)) | (off + len)) < 0)
            throw new IndexOutOfBoundsException();

        for (int i = 0 ; i < len ; i++) {
            write(b[off + i]);
        }
    }

    /**
     * 定义了一个flush方法，内部实质上是调用了OutputStream对象的flush方法，保证数据已从缓存写入到目的地。
     */
    public void flush() throws IOException {
        out.flush();
    }

    /**
     * 使用了try-resource的方式关闭流，同时调用flush方法，确保数据已经写出。
     */
    @SuppressWarnings("try")
    public void close() throws IOException {
        try (OutputStream ostream = out) {
            flush();
        }
    }
}

从上面的源码中可以看出，两个类中很多的方法其实仅仅只是直接调用了OutputStream的对应方法。那么它们的意义何在呢，其实这里面牵扯到了一种设计模式，就是装饰者模式（设计模式会在后面的篇幅中详细描述，这里就不细说了）。

这两个类本身的意义并不在与实现了什么而是定义了一个标准，具体的实现都是由它们的子类去实现的，如BufferedInputStream / BufferedOutputStram，DataInputStream / DataOutputStream，PrintStream等。它们都为InputStream / OutputStream添加了一些新的功能。

因为这两个类只是相当于定义了一个标准，但从功能上看与InputStream和OutputStream类似，所以就不再举例说明了。
以上为本篇内容。

 

转载于:https://www.cnblogs.com/moonfish1994/p/10222412.html