Java javax.imageio.stream 类 FileImageOutputStream（JDK5）

所有类

javax.imageio.stream
类 FileImageOutputStream

java.lang.Object
  javax.imageio.stream.ImageInputStreamImpl
      javax.imageio.stream.ImageOutputStreamImpl
          javax.imageio.stream.FileImageOutputStream

所有已实现的接口：

DataInput, DataOutput, ImageInputStream, ImageOutputStream

public class FileImageOutputStream
   
   
   
   
   
extends ImageOutputStreamImpl
   
   
   
   
   

将输出直接写入 File 或 RandomAccessFile 的 ImageOutputStream 的实现。

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)

构造一个向给定 FileImageOutputStream 进行写入的 RandomAccessFile。

参数：

raf - 要写入到的 RandomAccessFile。

抛出：

IllegalArgumentException - 如果 raf 为 null。

read

public int read()
         throws IOException

从接口 ImageInputStream 复制的描述

从流中读取单个字节，并以整数（0 到 255 之间）形式返回该字节。如果到达流末尾，则返回 -1。

在进行读取前，将流中的位偏移量重置为零。

指定者：

接口 ImageInputStream 中的 read

指定者：

类 ImageInputStreamImpl 中的 read

返回：

流中的 int 形式的字节值；或者 -1，指示 EOF（文件结束标记）。

抛出：

IOException - 如果发生 I/O 错误。

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException

从类 ImageInputStreamImpl 复制的描述

从流中读取至多 len 个字节，并将其存储到 b 中（从 off 索引处开始）。如果由于到达流末尾而没有读取任何字节，则返回 -1。

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

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

指定者：

接口 ImageInputStream 中的 read

指定者：

类 ImageInputStreamImpl 中的 read

参数：

b - 用来接收写入的字节数组。

off - b 中要写入的起始位置。

len - 要读取的最大字节数。

返回：

实际读取的字节数；或者 -1，指示 EOF。

抛出：

IOException - 如果发生 I/O 错误。

write

public void write(int b)
           throws IOException

从接口 DataOutput 复制的描述

将参数 b 的八个低位写入输出流。忽略 b 的 24 个高位。

指定者：

接口 DataOutput 中的 write

指定者：

接口 ImageOutputStream 中的 write

指定者：

类 ImageOutputStreamImpl 中的 write

参数：

b - 要写入的字节。

抛出：

IOException - 如果发生 I/O 错误。

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

从接口 DataOutput 复制的描述

将数组 b 中的 len 个字节按顺序写入输出流。如果 b 为 null，则抛出 NullPointerException。如果 off 为负，或 len 为负，抑或 off+len 大于数组 b 的长度，则抛出 IndexOutOfBoundsException。如果 len 为零，则不写入字节。否则，首先写入字节 b[off]，然后写入字节 b[off+1]，依此类推；最后一个写入字节是 b[off+len-1]。

指定者：

接口 DataOutput 中的 write

指定者：

接口 ImageOutputStream 中的 write

指定者：

类 ImageOutputStreamImpl 中的 write

参数：

b - 数据。

off - 数据中的起始偏移量。

len - 要写入的字节数。

抛出：

IOException - 如果发生 I/O 错误。

length

public long length()

从类 ImageInputStreamImpl 复制的描述

返回 -1L，指示流的长度未知。子类必须重写此方法来提供实际的长度信息。

指定者：

接口 ImageInputStream 中的 length

覆盖：

类 ImageInputStreamImpl 中的 length

返回：

指示不知道长度的 -1L。

seek

public void seek(long pos)
          throws IOException

设置当前流位置并将位偏移量重置为 0。查找文件末尾的后面是合法的；仅当在该处执行读取时才抛出 EOFException。在执行写入前，文件长度不会增加。

指定者：

接口 ImageInputStream 中的 seek

覆盖：

类 ImageInputStreamImpl 中的 seek

参数：

pos - 一个 long，它包含所需文件的指针位置。

抛出：

IndexOutOfBoundsException - 如果 pos 小于刷新缓存的位置。

IOException - 如果发生任何其他 I/O 错误。