javax.imageio.stream

Class FileImageInputStream

java.lang.Object

javax.imageio.stream.ImageInputStreamImpl

javax.imageio.stream.FileImageInputStream

All Implemented Interfaces:

Closeable ， DataInput ， AutoCloseable ， ImageInputStream

public class FileImageInputStream
extends ImageInputStreamImpl

一个ImageInputStream的ImageInputStream ，从File或RandomAccessFile获取它的输入。 假设文件内容在对象的生存期内是稳定的。

Field Summary

Fields inherited from class javax.imageio.stream.ImageInputStreamImpl

bitOffset, byteOrder, flushedPos, streamPos

构造方法摘要

构造方法

Constructor and Description
FileImageInputStream(File f) 构造一个 FileImageInputStream ，它将从给定的 File读取。
FileImageInputStream(RandomAccessFile raf) 构造一个 FileImageInputStream ，它将从给定的 RandomAccessFile读取。

方法摘要

Modifier and Type	Method and Description
void	close() 关闭流。
protected void	finalize() 在垃圾收集之前完成此对象。
long	length() 返回底层文件的长度，如果未知，则返回 -1 。
int	read() 从流中读取一个字节，并将其作为0和255之间的 int返回。
int	read(byte[] b, int off, int len) 从流中读取最多 len个字节，并将其存储在 b从索引 off开始。
void	seek(long pos) 将当前流位置设置为所需位置。

Methods inherited from class javax.imageio.stream.ImageInputStreamImpl

checkClosed, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, setBitOffset, setByteOrder, skipBytes, skipBytes

Methods inherited from class java.lang.Object

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

构造方法详细信息

FileImageInputStream

public FileImageInputStream(File f)
                     throws FileNotFoundException,
                            IOException

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

文件内容不得在此对象构建时间与上一次调用read方法的时间之间发生变化。

参数

f - a File读取。

异常

IllegalArgumentException - 如果 f是 null 。

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

FileNotFoundException - 如果 f是一个目录，或由于任何其他原因无法打开阅读。

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

FileImageInputStream

public FileImageInputStream(RandomAccessFile raf)

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

文件内容不得在此对象构建时间与上一次调用read方法的时间之间发生变化。

参数

raf - a RandomAccessFile要阅读。

异常

IllegalArgumentException - 如果 raf是 null 。

方法详细信息

read

public int read()
         throws IOException

描述从类别复制： ImageInputStreamImpl

从该流读取单个字节，并返回它作为一个int 255之间0和如果达到EOF， -1被返回。

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

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

Specified by:

read在接口 ImageInputStream

Specified by:

read在 ImageInputStreamImpl

结果

流中下一个字节的值，如果达到EOF， -1 。

异常

IOException - 如果流已关闭。

read

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

描述从类别复制： ImageInputStreamImpl

读取到len从流字节，并将其存储到b开始于索引off 。 如果没有读取字节，因为已经到达流的末尾，则返回-1 。

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

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

Specified by:

read在接口 ImageInputStream

Specified by:

read在 ImageInputStreamImpl

参数

b - 要写入的字节数组。

off -内的起始位置 b写。

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

结果

实际读取的字节数，或 -1表示EOF。

异常

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

length

public long length()

返回底层文件的长度，如果未知，则返回 -1 。

Specified by:

length中的 ImageInputStream

重写：

length在 ImageInputStreamImpl

结果

文件长度为 long ，或 -1 。

seek

public void seek(long pos)
          throws IOException

从接口复制： ImageInputStream

将当前流位置设置为所需位置。 下一次读取将发生在此位置。 位偏移设置为0。

一个IndexOutOfBoundsException如果将被抛出pos比冲洗位置（如通过返回较小getflushedPosition ）。

寻求文件结尾是合法的; 一个java.io.EOFException会，如果执行读取只抛出。

Specified by:

seek中的 ImageInputStream

重写：

seek在 ImageInputStreamImpl

参数

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

异常

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

close

public void close()
           throws IOException

说明从界面： ImageInputStream复制

关闭流。 尝试访问已关闭的流可能会导致IOException或错误的行为。 调用此方法可能允许实现此接口的类释放与流相关的资源，如内存，磁盘空间或文件描述符。

Specified by:

close在接口 Closeable

Specified by:

close在接口 AutoCloseable

Specified by:

close在接口 ImageInputStream

重写：

close在 ImageInputStreamImpl

异常

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

finalize

protected void finalize()
                 throws Throwable

在垃圾收集之前完成此对象。 调用close方法来关闭任何打开的输入源。 不应该从应用程序代码调用此方法。

重写：

finalize在 ImageInputStreamImpl

异常

Throwable - 如果在超类最终化期间发生错误。

另请参见：

WeakReference, PhantomReference