Java javax.imageio.stream 类 MemoryCacheImageOutputStream（JDK5）

所有类

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

从接口 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。

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()