模块 java.base
包 java.io

类 FilterOutputStream

java.lang.Object
java.io.OutputStream
java.io.FilterOutputStream
所有已实现的接口：
Closeable , Flushable , AutoCloseable
已知子类：
BufferedOutputStream , CheckedOutputStream , CipherOutputStream , DataOutputStream , DeflaterOutputStream , DigestOutputStream , InflaterOutputStream , PrintStream
public class FilterOutputStream extends OutputStream
此类是过滤输出流的所有类的超类。这些流位于已经存在的输出流之上（潜在的输出流），它用作其基本的数据接收器，但可能会在此过程中转换数据或提供其他功能。

类 FilterOutputStream 本身简单地覆盖了 OutputStream 的所有方法，其版本将所有请求传递到底层输出流。 FilterOutputStream 的子类可能会进一步重写其中一些方法，并提供额外的方法和字段。

自从：
1.0

  • 字段摘要

    字段
    修饰符和类型
    Field
    描述
    protected OutputStream
    out
    要过滤的基础输出流。

  • 构造方法总结

    构造方法
    构造方法
    描述
    FilterOutputStream(OutputStream out)
    创建一个建立在指定的底层输出流之上的输出流过滤器。

  • 方法总结

    修饰符和类型
    方法
    描述
    void
    close()
    关闭此输出流并释放与该流关联的所有系统资源。
    void
    flush()
    刷新此输出流并强制将任何缓冲的输出字节写出到流中。
    void
    write(byte[] b)
    将 b.length 字节写入此输出流。
    void
    write(byte[] b, int off, int len)
    从偏移量 off 开始的指定 byte 数组中将 len 字节写入此输出流。
    void
    write(int b)
    将指定的 byte 写入此输出流。

    在类 java.io.OutputStream 中声明的方法

    nullOutputStream

    在类 java.lang.Object 中声明的方法

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • 字段详细信息

    • out

      protected OutputStream  out
      要过滤的基础输出流。

  • 构造方法详细信息

    • FilterOutputStream

      public FilterOutputStream(OutputStream  out)
      创建一个建立在指定的底层输出流之上的输出流过滤器。
      参数：
      out - 分配给字段 this.out 供以后使用的基础输出流，或者 null 如果要在没有基础流的情况下创建此实例。

  • 方法详情

    • write

      public void write(int b) throws IOException
      将指定的 byte 写入此输出流。

      FilterOutputStream的write方法调用其底层输出流的write方法，即执行out.write(b)。

      实现 OutputStream 的抽象 write 方法。

      指定者：
      write 在类 OutputStream 中
      参数：
      b - byte。
      抛出：
      IOException - 如果发生 I/O 错误。

    • write

      public void write(byte[] b) throws IOException
      将 b.length 字节写入此输出流。
      重写：
      write 在类 OutputStream 中
      实现要求：
      FilterOutputStream 的 write 方法使用参数 b、0 和 b.length 调用其具有三个参数的 write 方法。
      实现注意事项：
      请注意，此方法确实 not 使用单个参数 b 调用其基础输出流的单参数 write 方法。
      参数：
      b - 要写入的数据。
      抛出：
      IOException - 如果发生 I/O 错误。
      参见：

    • write

      public void write(byte[] b, int off, int len) throws IOException
      从偏移量 off 开始的指定 byte 数组中将 len 字节写入此输出流。
      重写：
      write 在类 OutputStream 中
      实现要求：
      FilterOutputStream的write方法在每个byte上调用一个参数的write方法输出。
      实现注意事项：
      请注意，此方法不会使用相同的参数调用其基础输出流的 write 方法。 FilterOutputStream 的子类应该提供此方法的更有效实现。
      参数：
      b - 数据。
      off - 数据中的起始偏移量。
      len - 要写入的字节数。
      抛出：
      IOException - 如果发生 I/O 错误。
      IndexOutOfBoundsException - 如果 off 为负，len 为负，或者 len 大于 b.length - off
      参见：

    • flush

      public void flush() throws IOException
      刷新此输出流并强制将任何缓冲的输出字节写出到流中。
      指定者：
      flush 在接口 Flushable 中
      重写：
      flush 在类 OutputStream 中
      实现要求：
      FilterOutputStream 的 flush 方法调用其底层输出流的 flush 方法。
      抛出：
      IOException - 如果发生 I/O 错误。
      参见：

    • close

      public void close() throws IOException
      关闭此输出流并释放与该流关联的所有系统资源。
      指定者：
      close 在接口 AutoCloseable 中
      指定者：
      close 在接口 Closeable 中
      重写：
      close 在类 OutputStream 中
      实现要求：
      当尚未关闭时， FilterOutputStream 的 close 方法调用其 flush 方法，然后调用其底层输出流的 close 方法。
      抛出：
      IOException - 如果发生 I/O 错误。
      参见：