模块 java.desktop
包 javax.imageio.stream

类 FileImageOutputStream

java.lang.Object
javax.imageio.stream.ImageInputStreamImpl
javax.imageio.stream.ImageOutputStreamImpl
javax.imageio.stream.FileImageOutputStream
所有已实现的接口：
Closeable , DataInput , DataOutput , AutoCloseable , ImageInputStream , ImageOutputStream
public class FileImageOutputStream extends ImageOutputStreamImpl
ImageOutputStream 的实现，将其输出直接写入 File 或 RandomAccessFile。

  • 构造方法详细信息

    • FileImageOutputStream

      public FileImageOutputStream(File  f) throws FileNotFoundException , IOException
      构造一个将写入给定 File 的 FileImageOutputStream。
      参数：
      f - 要写入的 File。
      抛出：
      IllegalArgumentException - 如果 f 是 null。
      SecurityException - 如果安全管理器存在并且不允许对该文件进行写访问。
      FileNotFoundException - 如果 f 不表示常规文件或由于任何其他原因无法打开以进行读写。
      IOException - 如果发生 I/O 错误。

    • FileImageOutputStream

      public FileImageOutputStream(RandomAccessFile  raf)
      构造一个将写入给定 RandomAccessFile 的 FileImageOutputStream。
      参数：
      raf - 要写入的 RandomAccessFile。
      抛出：
      IllegalArgumentException - 如果 raf 是 null。

  • 方法详情

    • read

      public int read() throws IOException
      从类复制的描述：ImageInputStreamImpl
      从流中读取单个字节并将其作为 0 到 255 之间的 int 返回。如果达到 EOF，则返回 -1。

      子类必须为此方法提供实现。子类实现应该在退出前更新流位置。

      在读取发生之前，流中的位偏移必须重置为零。

      指定者：
      read 在接口 ImageInputStream 中
      指定者：
      read 在类 ImageInputStreamImpl 中
      返回：
      流中下一个字节的值，如果达到 EOF，则为 -1。
      抛出：
      IOException - 如果流已关闭。

    • read

      public int read(byte[] b, int off, int len) throws IOException
      从类复制的描述：ImageInputStreamImpl
      从流中读取最多 len 个字节，并将它们存储到从索引 off 开始的 b 中。如果因为已到达流的末尾而无法读取任何字节，则返回 -1。

      在读取发生之前，流中的位偏移必须重置为零。

      子类必须为此方法提供实现。子类实现应该在退出前更新流位置。

      指定者：
      read 在接口 ImageInputStream 中
      指定者：
      read 在类 ImageInputStreamImpl 中
      参数：
      b - 要写入的字节数组。
      off - b 中要写入的起始位置。
      len - 要读取的最大字节数。
      返回：
      实际读取的字节数，或 -1 表示 EOF。
      抛出：
      IOException - 如果发生 I/O 错误。

    • write

      public void write(int b) throws IOException
      从接口 ImageOutputStream 复制的描述
      在当前位置将单个字节写入流。 b 的 24 位高位被忽略。

      如果流中的位偏移量不为零，则当前字节的剩余部分用 0 填充并首先写出。写入后位偏移将为 0。实现者可以使用ImageOutputStreamImpl 的flushBits 方法来保证这一点。

      参数：
      b - 一个 int，其低 8 位将被写入。
      抛出：
      IOException - 如果发生 I/O 错误。

    • write

      public void write(byte[] b, int off, int len) throws IOException
      从接口 ImageOutputStream 复制的描述
      在当前位置将字节序列写入流。如果len 为 0，则不写入任何内容。首先写入字节 b[off]，然后写入字节 b[off + 1]，依此类推。

      如果流中的位偏移量不为零，则当前字节的剩余部分用 0 填充并首先写出。写入后位偏移将为 0。实现者可以使用ImageOutputStreamImpl 的flushBits 方法来保证这一点。

      参数：
      b - 要写入的 byte 数组。
      off - 数据中的起始偏移量。
      len - 要写入的 byte 的数量。
      抛出：
      IOException - 如果发生 I/O 错误。

    • length

      public long length()
      从类复制的描述：ImageInputStreamImpl
      返回 -1L 以指示流的长度未知。子类必须覆盖此方法以提供实际长度信息。
      指定者：
      length 在接口 ImageInputStream 中
      重写：
      length 在类 ImageInputStreamImpl 中
      返回：
      -1L 表示未知长度。

    • seek

      public void seek(long pos) throws IOException
      设置当前流位置并将位偏移重置为 0。查找文件末尾是合法的；仅当执行读取时才会抛出 EOFException。在执行写入之前，文件长度不会增加。
      参数：
      pos - 包含所需文件指针位置的 long。
      抛出：
      IndexOutOfBoundsException - 如果 pos 小于冲洗位置。
      IOException - 如果发生任何其他 I/O 错误。

    • close

      public void close() throws IOException
      从接口 ImageInputStream 复制的描述
      关闭流。尝试访问已关闭的流可能会导致 IOException 或不正确的行为。调用此方法可能允许实现此接口的类释放与流关联的资源，例如内存、磁盘空间或文件描述符。
      抛出：
      IOException - 如果发生 I/O 错误。

    • finalize

      @Deprecated (since ="9", forRemoval =true) protected void finalize() throws Throwable
      已弃用，将被删除：此 API 元素可能会在未来版本中删除。
      Finalization 已被弃用以移除。有关迁移选项的背景信息和详细信息，请参阅 Object.finalize() 。
      在垃圾收集之前完成此对象。 close 方法被调用以关闭任何打开的输入源。不应从应用程序代码中调用此方法。
      重写：
      finalize 在类 ImageInputStreamImpl 中
      抛出：
      Throwable - 如果在超类完成期间发生错误。
      参见：