javax.crypto

Class CipherOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

javax.crypto.CipherOutputStream

All Implemented Interfaces:

Closeable， Flushable， AutoCloseable

public class CipherOutputStream
extends FilterOutputStream

一个cipheroutputstream由OutputStream和密码，write()方法过程之前写出来的底层的数据输出流。密码必须完全初始化之前被cipheroutputstream使用。

例如，如果密码是加密的cipheroutputstream初始化，将加密数据在加密的数据写出来。

这类坚持严格的语义，特别是失败的语义，其祖先类java.io.outputstream和java.io.filteroutputstream。这类有其祖先类的指定方法，并覆盖他们所有的。此外，这个类捕获所有不被它的祖先类抛出的异常。

对于一个程序员使用这类不使用的方法不定义或修改这个类是至关重要的（如一个新的方法或构造函数是后来加入到一个超类），因为这些方法的设计与实现是不太可能考虑cipheroutputstream安全的影响。

从以下版本开始：

一点四

另请参见：

OutputStream， FilterOutputStream， Cipher， CipherInputStream

Field Summary

Fields inherited from class java.io.FilterOutputStream

out

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	CipherOutputStream(OutputStream os) 构建一cipheroutputstream OutputStream不指定一个密码。
	CipherOutputStream(OutputStream os, Cipher c) 构建从OutputStream和密码cipheroutputstream。

方法摘要

Modifier and Type	Method and Description
void	close() 关闭此输出流并释放与此流关联的任何系统资源。
void	flush() 刷新输出流的强迫任何缓冲输出字节已经被封装的对象处理密码写出来。
void	write(byte[] b) 写 b.length字节从指定的字节数组的输出流。
void	write(byte[] b, int off, int len) 写 len字节指定字节数组中的偏移 off开始到输出流。
void	write(int b) 将指定的字节写入该输出流中。

Methods inherited from class java.lang.Object

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

Constructor Detail

CipherOutputStream

public CipherOutputStream(OutputStream os,
                          Cipher c)

构建从OutputStream和密码cipheroutputstream。
note：如果指定的输出流或密码为空，一个空指针异常被抛出后，当他们使用。

参数

os的OutputStream对象

c -初始化密码对象

CipherOutputStream

protected CipherOutputStream(OutputStream os)

构建一cipheroutputstream OutputStream不指定一个密码。这是用nullcipher构建cipheroutputstream效果。
note：如果指定的输出流为空，一个空指针异常被抛出后，使用时。

参数

os的OutputStream对象

方法详细信息

write

public void write(int b)
           throws IOException

将指定的字节写入该输出流中。

重写：

write 方法重写，继承类 FilterOutputStream

参数

b - byte。

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

write

public void write(byte[] b)
           throws IOException

写 b.length字节从指定的字节数组的输出流。

对CipherOutputStream的write方法调用三参数和三参数b，0的write方法和b.length。

重写：

write 方法重写，继承类 FilterOutputStream

参数

b -数据。

异常

NullPointerException -如果 b是空的。

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

另请参见：

write(byte[], int, int)

write

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

写 len字节指定字节数组中的偏移 off开始到输出流。

重写：

write 方法重写，继承类 FilterOutputStream

参数

b -数据。

off的起始偏移量的数据。

len -字节数写。

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

另请参见：

FilterOutputStream.write(int)

flush

public void flush()
           throws IOException

刷新输出流的强迫任何缓冲输出字节已经被封装的对象处理密码写出来。

由封装的密码缓冲的任何字节，并等待被处理，它不会被写出来。例如，如果封装的密码是一种分组密码，并使用其中的write方法写入的总字节数小于密码的块大小，没有字节将被写出来。

Specified by:

flush 接口 Flushable

重写：

flush 方法重写，继承类 FilterOutputStream

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

另请参见：

FilterOutputStream.out

close

public void close()
           throws IOException

关闭此输出流并释放与此流关联的任何系统资源。

此方法调用封装的加密对象的doFinal方法，使任何字节缓冲由封装的密码进行处理。结果写出来，通过调用输出流的flush方法。

这种方法重置密码对象封装到初始状态，调用底层输出流的close方法。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

重写：

close 方法重写，继承类 FilterOutputStream

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

另请参见：

FilterOutputStream.flush()， FilterOutputStream.out