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，因此此类不能用于读取/修改/写入操作。读取操作只能发生在那些已经被写入到缓存且尚未被刷新的流部分。

字段摘要

从类 javax.imageio.stream.ImageInputStreamImpl 继承的字段

bitOffset, byteOrder, flushedPos, streamPos

构造方法摘要

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

方法摘要

void	close() 关闭此 MemoryCacheImageOutputStream。
void	flushBefore(long pos) 丢弃所指示位置之前的流初始部分。
boolean	isCached() 返回 true，因为此 ImageOutputStream为了允许逆向查找而缓存了数据。
boolean	isCachedFile() 返回 false，因为此 ImageOutputStream 不维护文件缓存。
boolean	isCachedMemory() 返回 true，因为此 ImageOutputStream 维护主存缓存。
long	length() 返回 -1L，指示流的长度未知。
int	read() 从流中读取单个字节，并以 int（0 到 255 之间）形式返回该字节。
int	read(byte[] b, int off, int len) 从流中读取至多 len 个字节，并将其存储到 b 中（从 off 索引处开始）。
void	write(byte[] b, int off, int len) 将字节序列写入到流中的当前位置。
void	write(int b) 将单个字节写入到流中的当前位置。

从类 javax.imageio.stream.ImageOutputStreamImpl 继承的方法

flushBits, write, writeBit, writeBits, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeChars, writeDouble, writeDoubles, writeFloat, writeFloats, writeInt, writeInts, writeLong, writeLongs, writeShort, writeShorts, writeUTF

从类 javax.imageio.stream.ImageInputStreamImpl 继承的方法

checkClosed, finalize, flush, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, 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, seek, setBitOffset, setByteOrder, skipBytes, skipBytes

从类 java.lang.Object 继承的方法

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

从接口 javax.imageio.stream.ImageInputStream 继承的方法

flush, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, 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, seek, setBitOffset, setByteOrder, skipBytes, skipBytes

构造方法详细信息

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