de.schlichtherle.truezip.crypto.raes

Class RaesOutputStream

java.lang.Object

java.io.OutputStream

de.schlichtherle.truezip.io.DecoratingOutputStream

de.schlichtherle.truezip.crypto.CipherOutputStream

de.schlichtherle.truezip.crypto.raes.RaesOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

@NotThreadSafe
public abstract class RaesOutputStream
extends CipherOutputStream

An OutputStream to produce a file with data ecnrypted according to the Random Access Encryption Specification (RAES).

Author:

Christian Schlichtherle

See Also:

RaesReadOnlyFile

Field Summary

Fields inherited from class de.schlichtherle.truezip.crypto.CipherOutputStream

cipher

Fields inherited from class de.schlichtherle.truezip.io.DecoratingOutputStream

delegate

Method Summary

Modifier and Type	Method and Description
static RaesOutputStream	getInstance(OutputStream out, RaesParameters param) Returns a new RaesOutputStream.
abstract KeyStrength	getKeyStrength() Returns the key strength which is actually used to encrypt the data of the RAES file.

Methods inherited from class de.schlichtherle.truezip.crypto.CipherOutputStream

close, finish, write, write

Methods inherited from class de.schlichtherle.truezip.io.DecoratingOutputStream

flush, toString, write

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

@CreatesObligation
public static RaesOutputStream getInstance(@WillCloseWhenClosed
                                                              OutputStream out,
                                                              @CheckForNull
                                                              RaesParameters param)
                                                       throws IOException

Returns a new RaesOutputStream.

Parameters:

out - the output stream to decorate for writing the ciphered data.

param - The RaesParameters used to determine and configure the type of RAES file created. If the run time class of this parameter matches multiple parameter interfaces, it is at the discretion of this implementation which one is picked and hence which type of RAES file is created. If you need more control over this, pass in an instance which's run time class just implements the RaesParametersProvider interface. Instances of this interface are queried to find RAES parameters which match a known RAES type. This algorithm is recursively applied.

Returns:

A new RaesOutputStream.

Throws:

RaesParametersException - if param is null or no suitable RAES parameters can be found.

IOException - on any I/O error.

getKeyStrength

public abstract KeyStrength getKeyStrength()

Returns the key strength which is actually used to encrypt the data of the RAES file.