ImageOutputStreamImpl (Java Platform SE 8 )

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

All Implemented Interfaces:

Closeable ， DataInput ， DataOutput ， AutoCloseable ， ImageInputStream ， ImageOutputStream

已知直接子类：

FileCacheImageOutputStream ， FileImageOutputStream ， MemoryCacheImageOutputStream
```
public abstract class ImageOutputStreamImpl
extends ImageInputStreamImpl
implements ImageOutputStream
```
抽象类实现ImageOutputStream接口。该类旨在减少子类必须实现的方法的数量。

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

构造方法摘要

构造方法
Constructor and Description
`ImageOutputStreamImpl()` 构造一个 `ImageOutputStreamImpl` 。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`protected void`	`flushBits()` 如果位偏移量不为零，则强制当前字节中的剩余位为0，并将流位置提前一位。
`void`	`write(byte[] b)` 在当前位置写入一串字节。
`abstract void`	`write(byte[] b, int off, int len)` 在当前位置写入一串字节。
`abstract void`	`write(int b)` 将当前位置的单个字节写入流。
`void`	`writeBit(int bit)` 将由参数的最低有效位给出的单个位写入当前字节位置中当前位偏移量的流。
`void`	`writeBits(long bits, int numBits)` 将 `bits`参数的 `numBits`最低有效位由左到右的顺序写入到当前字节位置当前位偏移量的流中的位序列。
`void`	`writeBoolean(boolean v)` 向流中写入一个 `boolean`值。
`void`	`writeByte(int v)` 将 `v`的8位低位写入流。
`void`	`writeBytes(String s)` 将一个字符串写入输出流。
`void`	`writeChar(int v)` 这种方法是 `writeShort`的同义词。
`void`	`writeChars(char[] c, int off, int len)` 在当前位置将一串字符写入流。
`void`	`writeChars(String s)` 将一个字符串写入输出流。
`void`	`writeDouble(double v)` 将 `double`值（由四个字节组成）写入输出流。
`void`	`writeDoubles(double[] d, int off, int len)` 将当前位置的一系列双精度写入流。
`void`	`writeFloat(float v)` 将 `float`值（由四个字节组成）写入输出流。
`void`	`writeFloats(float[] f, int off, int len)` 在当前位置将一系列浮点写入流。
`void`	`writeInt(int v)` 将 `v`的32位写入流。
`void`	`writeInts(int[] i, int off, int len)` 在当前位置写入流的序列。
`void`	`writeLong(long v)` 将 `v`的64位写入流。
`void`	`writeLongs(long[] l, int off, int len)` 在当前位置写入流的序列。
`void`	`writeShort(int v)` 将 `v`的16位低位写入流。
`void`	`writeShorts(short[] s, int off, int len)` 在当前位置写入流的序列。
`void`	`writeUTF(String s)` 将两个字节写入的长度信息，以网络字节顺序输出流，接着是 modified UTF-8每个字符的字符串中表示 `s` 。

Methods inherited from class javax.imageio.stream.ImageInputStreamImpl
checkClosed, close, finalize, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, length, mark, read, read, 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

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

Methods inherited from interface javax.imageio.stream.ImageOutputStream
flushBefore

Methods inherited from interface javax.imageio.stream.ImageInputStream
close, flush, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, length, mark, read, read, 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

- 构造方法详细信息
  - ImageOutputStreamImpl
```
public ImageOutputStreamImpl()
```
    构造一个 ImageOutputStreamImpl 。
- 方法详细信息
  - write
```
public abstract void write(int b)
                    throws IOException
```
    说明从界面复制： ImageOutputStream
    
    将当前位置的单个字节写入流。 b的24个高位被忽略。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。实施者可以使用flushBits的方法ImageOutputStreamImpl保证这一点。
    
    Specified by:
    
    write在接口 DataOutput
    
    Specified by:
    
    write在接口 ImageOutputStream
    
    参数
    
    b - 要写入低8位的 int 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - write
```
public void write(byte[] b)
           throws IOException
```
    说明从界面复制： ImageOutputStream
    
    在当前位置写入一串字节。如果b.length为0，则不写任何内容。字节b[0]先写，然后字节b[1]等等。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    write在接口 DataOutput
    
    Specified by:
    
    write在接口 ImageOutputStream
    
    参数
    
    b -的阵列 byte s到被写入。
    
    异常
    
    IOException - 如果发生I / O错误。
  - write
```
public abstract 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
    
    参数
    
    b - 要写入的数组 byte 。
    
    off - 数据中的起始偏移量。
    
    len -数量 byte s到写。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeBoolean
```
public void writeBoolean(boolean v)
                  throws IOException
```
    说明从界面复制： ImageOutputStream
    
    向流中写入一个boolean值。如果v为真，则写入值(byte)1 ; 如果v为false，则写入值(byte)0 。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeBoolean在接口 DataOutput
    
    Specified by:
    
    writeBoolean在接口 ImageOutputStream
    
    参数
    
    v - boolean 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeByte
```
public void writeByte(int v)
               throws IOException
```
    描述复制自接口： ImageOutputStream
    
    将v的8位低位写入流。 v的24位v被忽略。（这意味着writeByte与整数参数完全一样，就像write ））
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeByte在接口 DataOutput
    
    Specified by:
    
    writeByte在接口 ImageOutputStream
    
    参数
    
    v - 包含要写入的字节值的 int 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeShort
```
public void writeShort(int v)
                throws IOException
```
    说明从界面复制： ImageOutputStream
    将v的16位低位写入流。 v的16位v被忽略。如果流使用网络字节顺序，则按顺序写入的字节为：
```
  (byte)((v >> 8) & 0xff)
 (byte)(v & 0xff) 
```
    否则写入的字节将为：
```
  (byte)(v & 0xff)
 (byte)((v >> 8) & 0xff) 
```
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    Specified by:
    
    writeShort在接口 DataOutput
    
    Specified by:
    
    writeShort在接口 ImageOutputStream
    
    参数
    
    v - 一个 int要写入的短值的 int 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeChar
```
public void writeChar(int v)
               throws IOException
```
    说明从界面复制： ImageOutputStream
    
    这种方法是 writeShort的同义词。
    
    Specified by:
    
    writeChar在接口 DataOutput
    
    Specified by:
    
    writeChar在接口 ImageOutputStream
    
    参数
    
    v - 包含 int写入的char（unsigned short）值的 int 。
    
    异常
    
    IOException - 如果发生I / O错误。
    
    另请参见：
    
    ImageOutputStream.writeShort(int)
  - writeInt
```
public void writeInt(int v)
              throws IOException
```
    说明从界面： ImageOutputStream复制
    将v的32位写入流。如果流使用网络字节顺序，则按顺序写入的字节为：
```
  (byte)((v >> 24) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)(v & 0xff) 
```
    Otheriwse，写入的字节将是：
```
  (byte)(v & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 24) & 0xff) 
```
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    Specified by:
    
    writeInt在接口 DataOutput
    
    Specified by:
    
    writeInt在接口 ImageOutputStream
    
    参数
    
    v - 一个 int要写入的值的 int 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeLong
```
public void writeLong(long v)
               throws IOException
```
    说明从界面复制： ImageOutputStream
    将v的64位写入流。如果流使用网络字节顺序，则按顺序写入的字节为：
```
  (byte)((v >> 56) & 0xff)
 (byte)((v >> 48) & 0xff)
 (byte)((v >> 40) & 0xff)
 (byte)((v >> 32) & 0xff)
 (byte)((v >> 24) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)(v & 0xff) 
```
    否则写入的字节将为：
```
  (byte)(v & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 24) & 0xff)
 (byte)((v >> 32) & 0xff)
 (byte)((v >> 40) & 0xff)
 (byte)((v >> 48) & 0xff)
 (byte)((v >> 56) & 0xff) 
```
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    Specified by:
    
    writeLong在接口 DataOutput
    
    Specified by:
    
    writeLong在接口 ImageOutputStream
    
    参数
    
    v - 一个 long要写入的值的 long 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeFloat
```
public void writeFloat(float v)
                throws IOException
```
    从接口复制： ImageOutputStream
    
    将float值（由四个字节组成）写入输出流。它这样做是因为，如果它首先将这个float值到int在完全相同的方式Float.floatToIntBits方法，然后在的完全相同的方式写入的int值writeInt方法。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeFloat在接口 DataOutput
    
    Specified by:
    
    writeFloat在接口 ImageOutputStream
    
    参数
    
    v - 包含要写入的值的 float 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeDouble
```
public void writeDouble(double v)
                 throws IOException
```
    说明从界面： ImageOutputStream复制
    
    将double值写入输出流，该值由四个字节组成。它这样做是因为，如果它首先将这个double值到long在完全相同的方式Double.doubleToLongBits方法，然后在完全相同的方式写入长值writeLong方法。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeDouble在接口 DataOutput
    
    Specified by:
    
    writeDouble在接口 ImageOutputStream
    
    参数
    
    v - 一个 double要写入的值的 double 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeBytes
```
public void writeBytes(String s)
                throws IOException
```
    说明从界面复制： ImageOutputStream
    
    将一个字符串写入输出流。对于字符串中的每个字符s ，为了拍摄，一个字节写入到输出流。如果s是null ，则抛出一个NullPointerException 。
    如果s.length为零，则不会写入任何字节。否则，字符s[0]先写，然后s[1]等等; 写最后一个字符是s[s.length-1] 。对于每个字符，写入一个字节，低字节，按照writeByte方法的方式。字符串中每个字符的高8位被忽略。
    
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeBytes在接口 DataOutput
    
    Specified by:
    
    writeBytes在接口 ImageOutputStream
    
    参数
    
    s - 一个 String要写入的值的 String 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeChars
```
public void writeChars(String s)
                throws IOException
```
    说明从界面： ImageOutputStream复制
    
    将一个字符串写入输出流。对于字符串中的每个字符s ，为了服用，两个字节被根据当前字节顺序设定写入到输出流中，排序。如果正在使用网络字节顺序，则首先写入高字节; 否则订单相反。如果s是null ，则抛出一个NullPointerException 。
    如果s.length为零，则不会写入任何字节。否则，字符s[0]先写，然后s[1]等; 写最后一个字符是s[s.length-1] 。
    
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeChars在接口 DataOutput
    
    Specified by:
    
    writeChars在接口 ImageOutputStream
    
    参数
    
    s - 一个 String要写入的值的 String 。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeUTF
```
public void writeUTF(String s)
              throws IOException
```
    说明从界面： ImageOutputStream复制
    以网络字节顺序将两个字节的长度信息写入输出流，其后是字符串 s中每个字符的s 。如果s是null ，则抛出一个NullPointerException 。根据字符的值，字符串s中的每个字符都将转换为一个，两个或三个字节的组。
    如果一个字符c在\u0001到\u007f ，它由一个字节表示：
```
  (byte)c 
```
    如果一个字符c是\u0000或者是在\u0080到\u07ff ，那么它由两个字节表示，按照显示的顺序写：
```
   (byte)(0xc0 | (0x1f & (c >> 6))) (byte)(0x80 | (0x3f & c))  
```
    如果一个字符c在\u0800到uffff ，那么它由三个字节表示，按照显示的顺序写：
```
   (byte)(0xe0 | (0x0f & (c >> 12))) (byte)(0x80 | (0x3f & (c >> 6))) (byte)(0x80 | (0x3f & c))  
```
    首先，以表示的所有字符所需的字节的总数s被计算。如果这个数字大于65535 ，那么会抛出一个UTFDataFormatException 。否则，该长度被写入到在完全相同的方式输出流writeShort方法; 之后，写入字符串s中每个字符的一个，两个或三个字节的表示。
    
    当前字节顺序设置被忽略。
    
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    注意：此方法不应用于执行使用标准UTF-8的图像格式，因为此处使用的修改后的UTF-8与标准UTF-8不兼容。
    Specified by:
    
    writeUTF在接口 DataOutput
    
    Specified by:
    
    writeUTF在接口 ImageOutputStream
    
    参数
    
    s - 一个 String要写入的值的 String 。
    
    异常
    
    UTFDataFormatException - 如果 UTFDataFormatException的修改的UTF-8 s需要超过65536个字节。
    
    IOException - 如果发生I / O错误。
  - writeShorts
```
public void writeShorts(short[] s,
                        int off,
                        int len)
                 throws IOException
```
    描述从接口： ImageOutputStream复制
    
    在当前位置写入流的序列。如果len为0，则不写任何内容。短s[off]先写，然后短s[off + 1] ，等等。流的字节顺序用于确定写入单个字节的顺序。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeShorts在接口 ImageOutputStream
    
    参数
    
    s - 要写入的 short的数组。
    
    off - 数据中的起始偏移量。
    
    len -数量 short s到写。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeChars
```
public void writeChars(char[] c,
                       int off,
                       int len)
                throws IOException
```
    说明从界面： ImageOutputStream复制
    
    在当前位置将一串字符写入流。如果len为0，则不写任何内容。 char c[off]是先写的，然后是char c[off + 1] ，等等。流的字节顺序用于确定写入单个字节的顺序。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeChars在接口 ImageOutputStream
    
    参数
    
    c - 要写入的 char的数组。
    
    off - 数据中的起始偏移量。
    
    len -数量 char s到写。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeInts
```
public void writeInts(int[] i,
                      int off,
                      int len)
               throws IOException
```
    描述从接口： ImageOutputStream复制
    
    在当前位置写入流的序列。如果len为0，则不写任何内容。 int i[off]是先写的，然后是int i[off + 1] ，等等。流的字节顺序用于确定写入单个字节的顺序。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeInts在接口 ImageOutputStream
    
    参数
    
    i - 要写入的 int数组。
    
    off - 数据中的起始偏移量。
    
    len -数量 int s到写。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeLongs
```
public void writeLongs(long[] l,
                       int off,
                       int len)
                throws IOException
```
    说明从界面： ImageOutputStream复制
    
    在当前位置写入流的序列。如果len为0，则不写任何内容。长l[off]是先写的，那么长l[off + 1]等等。流的字节顺序用于确定写入单个字节的顺序。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeLongs在接口 ImageOutputStream
    
    参数
    
    l - 要写入的 long数组。
    
    off - 数据中的起始偏移量。
    
    len -数量 long s到写。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeFloats
```
public void writeFloats(float[] f,
                        int off,
                        int len)
                 throws IOException
```
    说明从界面复制： ImageOutputStream
    
    在当前位置将一系列浮点写入流。如果len为0，则不写任何内容。浮动f[off]先写，然后浮动f[off + 1]等等。流的字节顺序用于确定写入单个字节的顺序。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeFloats在接口 ImageOutputStream
    
    参数
    
    f - 要写入的数组 float 。
    
    off - 数据中的起始偏移量。
    
    len -数量 float s到写。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeDoubles
```
public void writeDoubles(double[] d,
                         int off,
                         int len)
                  throws IOException
```
    说明从界面： ImageOutputStream复制
    
    将当前位置的一系列双精度写入流。如果len为0，则不会写入。双d[off]先写，然后双d[off + 1]等等。流的字节顺序用于确定写入单个字节的顺序。
    如果流内的位偏移量不为零，则当前字节的剩余部分用0填充并首先写出。写入后位偏移将为0。
    
    Specified by:
    
    writeDoubles在接口 ImageOutputStream
    
    参数
    
    d -的阵列 doubles s到被写入。
    
    off - 数据中的起始偏移量。
    
    len -数量 double s到写。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeBit
```
public void writeBit(int bit)
              throws IOException
```
    说明从界面： ImageOutputStream复制
    
    将由参数的最低有效位给出的单个位写入当前字节位置中当前位偏移量的流。参数的高31位被忽略。给定位替换该位置上的前一位。位偏移前进一并减少模8。
    如果特定字节的任何位在字节被刷新到目的地时从未被设置，则这些位将自动设置为0。
    
    Specified by:
    
    writeBit在接口 ImageOutputStream
    
    参数
    
    bit - int最低有效位写入流的int。
    
    异常
    
    IOException - 如果发生I / O错误。
  - writeBits
```
public void writeBits(long bits,
                      int numBits)
               throws IOException
```
    说明从界面： ImageOutputStream复制
    
    写入由给定的比特序列， numBits所述的至少显著位bits的当前位的当前字节位置内的偏移在左到右的顺序参数，到流中。上限64 - numBits的参数被忽略。位偏移提前numBits并减小模8。注意，0的位偏移总是表示字节的最高有效位，并且位数的字节在遇到时按顺序写出。因此，位写入总是以网络字节顺序有效。实际流字节顺序设置被忽略。
    位数据可以无限期累积到存储器中，直到flushBefore 。那时候，闪存位置之前的所有位数据将被写入。
    
    如果特定字节的任何位在字节被刷新到目的地时从未被设置，则这些位将自动设置为0。
    
    Specified by:
    
    writeBits在接口 ImageOutputStream
    
    参数
    
    bits - 一个 long要写入的位的 numBits - 1 ，从位置 numBits - 1的位开始到最低有效位。
    
    numBits -一个 int 0和64之间，包括端值。
    
    异常
    
    IOException - 如果发生I / O错误。
  - flushBits
```
protected final void flushBits()
                        throws IOException
```
    如果位偏移量不为零，则强制当前字节中的剩余位为0，并将流位置提前一位。在write(int)和write(byte[], int, int)方法的开头应该由子类调用此方法。
    
    异常
    
    IOException - 如果发生I / O错误。

Class ImageOutputStreamImpl

Field Summary

Fields inherited from class javax.imageio.stream.ImageInputStreamImpl

构造方法摘要

方法摘要

Methods inherited from class javax.imageio.stream.ImageInputStreamImpl

Methods inherited from class java.lang.Object

Methods inherited from interface javax.imageio.stream.ImageOutputStream

Methods inherited from interface javax.imageio.stream.ImageInputStream

构造方法详细信息

ImageOutputStreamImpl

方法详细信息

write

write

write

writeBoolean

writeByte

writeShort

writeChar

writeInt

writeLong

writeFloat

writeDouble

writeBytes

writeChars

writeUTF

writeShorts

writeChars

writeInts

writeLongs

writeFloats

writeDoubles

writeBit

writeBits

flushBits