oracle.security.crypto.cms
Class CMSCompressedDataOutputStream

java.lang.Object
java.io.OutputStream
java.io.FilterOutputStream
oracle.security.crypto.cms.CMSOutputStream
oracle.security.crypto.cms.CMSCompressedDataOutputStream

public class CMSCompressedDataOutputStream

extends CMSOutputStream

A CMSCompressedDataOutputStream writes its output in the form of a CMS digested-data structure, generating the message digest in the process.

Specifically, the effect of using this class is as if the following process took place:

• All of the data written to this stream is accumulated into a EncapsulatedContentInfo structure of the specified content-type.
• The resulting EncapsulatedContentInfo structure is then provided as the input to a ContentInfo structure of type digested-data.
• A BER encoding of the resulting ContentInfo structure is written to the underlying output stream;

except that the actual process is done in one pass, eliminating the necessity to accumulate all of the input data before writing any output.

In the case where a <ocde>CMSConnector is provided instead of a CMSOutputStream, only the exposed content i.e. the Content field of the ContentInfo structure minus the explicit [0] tag is written to the underlying output stream.

IMPORTANT: This class generates large CMS digested-data Objects more efficiently (Java VM memory usage) than the CMSCompressedDataContentInfo class.

See Also:

CMSOutputStream, CMSCompressedDataContentInfo, CMSCompressedDataOutputConnector

Field Summary

Fields inherited from class java.io.FilterOutputStream

out

Constructor Summary

CMSCompressedDataOutputStream(CMSOutputConnector conn, AlgorithmIdentifier digestAlgID, ASN1ObjectID contentType)
Creates a CMSCompressedDataOutputStream.

CMSCompressedDataOutputStream(java.io.OutputStream out, AlgorithmIdentifier compressionAlgID, ASN1ObjectID contentType)
Creates a CMSCompressedDataOutputStream.

Method Summary

void	close()
ASN1ObjectID	getExposedContentType() Returns the content type of the data that is output to the underlying output stream.
void	terminate() Finish writing the CMS compressed-data structure.
void	write(byte[] b, int off, int len)
void	write(int ch)

Methods inherited from class java.io.FilterOutputStream

flush, write

Methods inherited from class java.lang.Object

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

Constructor Detail

CMSCompressedDataOutputStream

public CMSCompressedDataOutputStream(java.io.OutputStream out,
                                     AlgorithmIdentifier compressionAlgID,
                                     ASN1ObjectID contentType)
                              throws AlgorithmIdentifierException

Creates a CMSCompressedDataOutputStream.

Parameters:

out - The underlying output stream.

compressionAlgID - The compression algorithm.

contentType - The encapsulated content type.

Throws:

AlgorithmIdentifierException - Digest algorithm is not supported.

CMSCompressedDataOutputStream

public CMSCompressedDataOutputStream(CMSOutputConnector conn,
                                     AlgorithmIdentifier digestAlgID,
                                     ASN1ObjectID contentType)
                              throws AlgorithmIdentifierException

Creates a CMSCompressedDataOutputStream.

Parameters:

conn - The underlying output connector.

digestAlgID - The message digest algorithm.

contentType - The encapsulated content type.

Throws:

AlgorithmIdentifierException - Digest algorithm is not supported.

Method Detail

terminate

public void terminate()
               throws java.io.IOException

Finish writing the CMS compressed-data structure.

This method must be called after the content has been completely written.

Specified by:

terminate in class CMSOutputStream

Returns:

IOException An I/O error occurred.

Throws:

java.io.IOException - An I/O error occurred.

write

public void write(int ch)
           throws java.io.IOException

Throws:

java.io.IOException

write

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

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Throws:

java.io.IOException

getExposedContentType

public ASN1ObjectID getExposedContentType()

Returns the content type of the data that is output to the underlying output stream.

Specified by:

getExposedContentType in class CMSOutputStream

Returns:

The content type identifier.