Java javax.imageio.stream 类 FileImageInputStream（JDK5）

所有类

javax.imageio.stream
类 FileImageInputStream

java.lang.Object
  javax.imageio.stream.ImageInputStreamImpl
      javax.imageio.stream.FileImageInputStream

所有已实现的接口：

DataInput, ImageInputStream

public class FileImageInputStream
   
   
   
   
   
extends ImageInputStreamImpl
   
   
   
   
   

从 File 或 RandomAccessFile 中获取输入的 ImageInputStream 的实现。假定文件内容在对象的生存期内是稳定的。

FileImageInputStream

public FileImageInputStream(File f)
                     throws FileNotFoundException,
                            IOException

构造一个将从给定 File 进行读取的 FileImageInputStream。

在构造此对象和最后一次调用 read 方法之间的时间内，一定不能更改文件内容。

参数：

f - 要从其进行读取的 File。

抛出：

IllegalArgumentException - 如果 f 为 null。

SecurityException - 如果存在安全管理器，且不允许对文件进行读取访问。

FileNotFoundException - 如果 f 是目录，或者由于任何其他原因不能打开以进行读取。

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

FileImageInputStream

public FileImageInputStream(RandomAccessFile raf)

构造一个将从给定 RandomAccessFile 进行读取的 FileImageInputStream。

在构造此对象和最后一次调用 read 方法之间的时间内，一定不能更改文件内容。

参数：

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 错误。

length

public long length()

返回基础文件的长度，如果其为未知，则返回 -1。

指定者：

接口 ImageInputStream 中的 length

覆盖：

类 ImageInputStreamImpl 中的 length

返回：

以 long 形式返回文件的长度，或者返回 -1。

seek

public void seek(long pos)
          throws IOException

从接口 ImageInputStream 复制的描述

将当前流位置设置为所需的位置。下一次读取将在此位置上进行。位偏移量被设置为 0。

如果 pos 小于刷新缓冲的位置（由 getflushedPosition 返回），将抛出 IndexOutOfBoundsException。

查找文件末尾之后是合法的，只有在该处执行读取时才抛出 EOFException。

指定者：

接口 ImageInputStream 中的 seek

覆盖：

类 ImageInputStreamImpl 中的 seek

参数：

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

抛出：

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

close

public void close()
           throws IOException

从接口 ImageInputStream 复制的描述

关闭流。试图访问已经关闭的流将导致 IOException 或错误行为。调用此方法可允许实现此接口的类释放与流关联的资源（如内存、磁盘空间或文件描述符）。

指定者：

接口 ImageInputStream 中的 close

覆盖：

类 ImageInputStreamImpl 中的 close

抛出：

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