FileCacheImageOutputStream (Java Platform SE 8 )

java.lang.Object
- javax.imageio.stream.ImageInputStreamImpl
- - javax.imageio.stream.ImageOutputStreamImpl
  - - javax.imageio.stream.FileCacheImageOutputStream

All Implemented Interfaces:

Closeable ， DataInput ， DataOutput ， AutoCloseable ， ImageInputStream ， ImageOutputStream
```
public class FileCacheImageOutputStream
extends ImageOutputStreamImpl
```
ImageOutputStream的一个ImageOutputStream ，将其输出写入常规的OutputStream 。一个文件用于缓存数据，直到它被刷新到输出流。

Field Summary
- Fields inherited from class javax.imageio.stream.ImageInputStreamImpl
  bitOffset, byteOrder, flushedPos, streamPos

构造方法摘要

构造方法
Constructor and Description
`FileCacheImageOutputStream(OutputStream stream, File cacheDir)` 构造一个 `FileCacheImageOutputStream` ，它将写入给定的 `outputStream` 。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`close()` 关闭此 `FileCacheImageOutputStream` 。
`void`	`flushBefore(long pos)` 在指示的位置之前丢弃流的初始部分。
`boolean`	`isCached()` 返回 `true`因为这 `ImageOutputStream`缓存数据以允许向后搜索。
`boolean`	`isCachedFile()` 返回 `true`因为这个 `ImageOutputStream`维护一个文件缓存。
`boolean`	`isCachedMemory()` 返回 `false`因为这 `ImageOutputStream`不维护主内存缓存。
`long`	`length()` 返回 `-1L`以表示该流具有未知长度。
`int`	`read()` 从流中读取一个字节，并将其作为0和255之间的 `int`返回。
`int`	`read(byte[] b, int off, int len)` 读取到 `len`从流字节，并将其存储到 `b`开始于索引 `off` 。
`void`	`seek(long pos)` 设置当前流位置，并将位偏移重置为0。
`void`	`write(byte[] b, int off, int len)` 在当前位置写入一串字节。
`void`	`write(int b)` 将当前位置的单个字节写入流。

Methods inherited from class 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

Methods inherited from class 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, setBitOffset, setByteOrder, skipBytes, skipBytes

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface 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, setBitOffset, setByteOrder, skipBytes, skipBytes

- 构造方法详细信息
  - FileCacheImageOutputStream
```
public FileCacheImageOutputStream(OutputStream stream,
                                  File cacheDir)
                           throws IOException
```
    构造一个FileCacheImageOutputStream ，它将写入给定的outputStream 。
    临时文件用作缓存。如果cacheDir是非null并且是一个目录，那么该文件将在那里创建。如果是null ，将使用系统相关的默认临时文件目录（有关详细信息，请参阅File.createTempFile的File.createTempFile ）。
    
    参数
    
    stream - OutputStream 。
    
    cacheDir - 一个 File指示应该创建缓存文件的位置，或者使用 null来使用系统目录。
    
    异常
    
    IllegalArgumentException - 如果 stream是 null 。
    
    IllegalArgumentException - 如果 cacheDir不是 null但不是目录。
    
    IOException - 如果无法创建缓存文件。
- 方法详细信息
  - 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错误。
  - write
```
public void write(int b)
           throws IOException
```
    说明从界面： ImageOutputStream复制
    
    将当前位置的单个字节写入流。 b的24位b被忽略。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。实施者可以使用flushBits的方法ImageOutputStreamImpl保证这一点。
    
    Specified by:
    
    write在接口 DataOutput
    
    Specified by:
    
    write在接口 ImageOutputStream
    
    Specified by:
    
    write在 ImageOutputStreamImpl
    
    参数
    
    b - 要写入低8位的 int 。
    
    异常
    
    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。实施者可以使用flushBits的方法ImageOutputStreamImpl保证这一点。
    
    Specified by:
    
    write在接口 DataOutput
    
    Specified by:
    
    write在接口 ImageOutputStream
    
    Specified by:
    
    write在 ImageOutputStreamImpl
    
    参数
    
    b - 要编写的 byte的数组。
    
    off - 数据中的起始偏移量。
    
    len -数量 byte s到写。
    
    异常
    
    IOException - 如果发生I / O错误。
  - length
```
public long length()
```
    描述从类别复制： ImageInputStreamImpl
    
    返回-1L以表示该流具有未知长度。子类必须覆盖此方法以提供实际的长度信息。
    
    Specified by:
    
    length在接口 ImageInputStream
    
    重写：
    
    length在 ImageInputStreamImpl类
    
    结果
    
    -1L表示未知长度。
  - seek
```
public void seek(long pos)
          throws IOException
```
    设置当前流位置，并将位偏移量重置为0.合法查找文件的结尾; 一个EOFException会，如果执行读取只抛出。在执行写入之前，文件长度不会增加。
    
    Specified by:
    
    seek在接口 ImageInputStream
    
    重写：
    
    seek在 ImageInputStreamImpl
    
    参数
    
    pos - 一个 long所需文件指针位置的long。
    
    异常
    
    IndexOutOfBoundsException - 如果 pos小于冲洗位置。
    
    IOException - 如果发生任何其他I / O错误。
  - isCached
```
public boolean isCached()
```
    返回 true因为这 ImageOutputStream缓存数据，以便向后追溯。
    
    Specified by:
    
    isCached在接口 ImageInputStream
    
    重写：
    
    isCached在 ImageInputStreamImpl
    
    结果
    
    true 。
    
    另请参见：
    
    isCachedMemory() ， isCachedFile()
  - isCachedFile
```
public boolean isCachedFile()
```
    返回 true因为这 ImageOutputStream维护一个文件缓存。
    
    Specified by:
    
    isCachedFile在接口 ImageInputStream
    
    重写：
    
    isCachedFile在 ImageInputStreamImpl
    
    结果
    
    true 。
    
    另请参见：
    
    isCached() ， isCachedMemory()
  - isCachedMemory
```
public boolean isCachedMemory()
```
    返回 false因为此 ImageOutputStream不维护主内存缓存。
    
    Specified by:
    
    isCachedMemory中的 ImageInputStream
    
    重写：
    
    isCachedMemory在 ImageInputStreamImpl
    
    结果
    
    false 。
    
    另请参见：
    
    isCached() ， isCachedFile()
  - close
```
public void close()
           throws IOException
```
    关闭此FileCacheImageOutputStream 。所有挂起的数据都被刷新到输出，缓存文件被关闭并被删除。目的地OutputStream未关闭。
    
    Specified by:
    
    close在接口 Closeable
    
    Specified by:
    
    close在接口 AutoCloseable
    
    Specified by:
    
    close在接口 ImageInputStream
    
    重写：
    
    close在 ImageInputStreamImpl
    
    异常
    
    IOException - 如果发生错误。
  - flushBefore
```
public void flushBefore(long pos)
                 throws IOException
```
    从接口复制： ImageInputStream
    
    在指示的位置之前丢弃流的初始部分。试图寻求在流的冲洗部分内的偏移将导致IndexOutOfBoundsException 。
    调用flushBefore可能允许实现此接口的类释放用于存储流中的数据的资源（如内存或磁盘空间）。
    
    Specified by:
    
    flushBefore在接口 ImageInputStream
    
    Specified by:
    
    flushBefore中的 ImageOutputStream
    
    重写：
    
    flushBefore在 ImageInputStreamImpl
    
    参数
    
    pos - 一个 long其中包含可能被刷新的流前缀的长度。
    
    异常
    
    IOException - 如果发生I / O错误。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class FileCacheImageOutputStream

Field Summary

Fields inherited from class javax.imageio.stream.ImageInputStreamImpl

构造方法摘要

方法摘要

Methods inherited from class javax.imageio.stream.ImageOutputStreamImpl

Methods inherited from class javax.imageio.stream.ImageInputStreamImpl

Methods inherited from class java.lang.Object

Methods inherited from interface javax.imageio.stream.ImageInputStream

构造方法详细信息

FileCacheImageOutputStream

方法详细信息

read

read

write

write

length

seek

isCached

isCachedFile

isCachedMemory

close

flushBefore