javax.imageio.stream
类 MemoryCacheImageOutputStream

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

所有已实现的接口：

DataInput, DataOutput, ImageInputStream, ImageOutputStream

public class MemoryCacheImageOutputStream
extends ImageOutputStreamImpl

将输出写入常规 OutputStream 中的 ImageOutputStream 的实现。内存缓冲区用于缓存（至少）丢弃位置和当前写入位置之间的数据。唯一的构造方法带有一个 OutputStream，因此此类不能用于读取/修改/写入操作。读取操作只能发生在那些已经被写入到缓存且尚未被刷新的流部分。

MemoryCacheImageOutputStream

public MemoryCacheImageOutputStream(OutputStream stream)

构造将向给定 OutputStream 进行写入的 MemoryCacheImageOutputStream。

参数：

stream - 将写入到的 OutputStream。

抛出：

IllegalArgumentException - 如果 stream 为 null。

read

public int read()
         throws IOException

从类 ImageInputStreamImpl 复制的描述

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

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

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

指定者：

接口 ImageInputStream 中的 read

指定者：

类 ImageInputStreamImpl 中的 read

返回：

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

抛出：

IOException - 如果流已经被关闭。

read

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

从类 ImageInputStreamImpl 复制的描述

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

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

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

指定者：

接口 ImageInputStream 中的 read

指定者：

类 ImageInputStreamImpl 中的 read

参数：

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

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

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

返回：

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

抛出：

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

write

public void write(int b)
           throws IOException

从接口 ImageOutputStream 复制的描述

将单个字节写入到流中的当前位置。b 的 24 个高位将被忽略。

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

指定者：

接口 DataOutput 中的 write

指定者：

接口 ImageOutputStream 中的 write

指定者：

类 ImageOutputStreamImpl 中的 write

参数：

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 方法来保证这一点。

指定者：

接口 DataOutput 中的 write

指定者：

接口 ImageOutputStream 中的 write

指定者：

类 ImageOutputStreamImpl 中的 write

参数：

b - 要写入的 byte 数组。

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

len - 要写入的 byte 数。

抛出：

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

length

public long length()

从类 ImageInputStreamImpl 复制的描述

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

指定者：

接口 ImageInputStream 中的 length

覆盖：

类 ImageInputStreamImpl 中的 length

返回：

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

isCached

public boolean isCached()

返回 true，因为此 ImageOutputStream为了允许逆向查找而缓存了数据。

指定者：

接口 ImageInputStream 中的 isCached

覆盖：

类 ImageInputStreamImpl 中的 isCached

返回：

true。

另请参见：

isCachedMemory(), isCachedFile()

isCachedFile

public boolean isCachedFile()

返回 false，因为此 ImageOutputStream 不维护文件缓存。

指定者：

接口 ImageInputStream 中的 isCachedFile

覆盖：

类 ImageInputStreamImpl 中的 isCachedFile

返回：

false。

另请参见：

isCached(), isCachedMemory()

isCachedMemory

public boolean isCachedMemory()

返回 true，因为此 ImageOutputStream 维护主存缓存。

指定者：

接口 ImageInputStream 中的 isCachedMemory

覆盖：

类 ImageInputStreamImpl 中的 isCachedMemory

返回：

true。

另请参见：

isCached(), isCachedFile()

close

public void close()
           throws IOException

关闭此 MemoryCacheImageOutputStream。所有的挂起数据都将被刷新到输出，释放该缓存。但不关闭目标 OutputStream。

指定者：

接口 ImageInputStream 中的 close

覆盖：

类 ImageInputStreamImpl 中的 close

抛出：

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

flushBefore

public void flushBefore(long pos)
                 throws IOException

从接口 ImageInputStream 复制的描述

丢弃所指示位置之前的流初始部分。试图查找流的刷新部分中的偏移量将导致抛出 IndexOutOfBoundsException。

调用 flushBefore 可允许实现此接口的类释放存储流中的数据所使用的资源，如内存和磁盘空间。

指定者：

接口 ImageInputStream 中的 flushBefore

指定者：

接口 ImageOutputStream 中的 flushBefore

覆盖：

类 ImageInputStreamImpl 中的 flushBefore

参数：

pos - 一个 long，它包含要刷新的流前缀的长度。

抛出：

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

版权所有 2008 Sun Microsystems, Inc. 保留所有权利。请遵守GNU General Public License, version 2 only。