de.schlichtherle.crypto.io.raes
Interface RaesParametersAgent

All Superinterfaces:

RaesParameters

All Known Implementing Classes:

KeyManagerRaesParameters

public interface RaesParametersAgent
extends RaesParameters

These RaesParameters delegate to some other instance of a sibling interface or itself in order to locate the parameters required to read or write a certain RAES type. This may be implemented by clients to build RAES parameters of a certain type on demand rather than providing them upfront.

There are two usages of this interface:

1. RaesReadOnlyFile.getInstance(java.io.File, de.schlichtherle.crypto.io.raes.RaesParameters) uses it to locate RAES parameters which match the RAES type found in the file unless the provided parameters already match the required type.
2. RaesOutputStream.getInstance(java.io.OutputStream, de.schlichtherle.crypto.io.raes.RaesParameters) uses it to allow the client explict control about the type of RAES file created.

Since:

TrueZIP 6.0

Version:

$Id: RaesParametersAgent.java,v 1.4 2010/08/20 13:09:38 christian_schlichtherle Exp $

Author:

Christian Schlichtherle

Method Summary

RaesParameters

getParameters(Class type) Requests an RaesParameters instance of the given type.

Method Detail

getParameters

RaesParameters getParameters(Class type)

Requests an RaesParameters instance of the given type. It is permissible to return an instance of any other implementation of the RaesParameters interface. If the returned object is an instance of an implementation of this interface, it will be used to continue the search for RAES parameters recursively. Otherwise the search will be aborted.

Parameters:

type - The RaesParameters interface class which's implementation is searched.

Returns:

An instance of RaesParameters or null if no RAES parameters are available.