de.schlichtherle.truezip.crypto.raes
Interface RaesParametersProvider

All Superinterfaces:

RaesParameters

All Known Implementing Classes:

KeyManagerRaesParameters

public interface RaesParametersProvider
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.truezip.crypto.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.truezip.crypto.raes.RaesParameters) uses it to allow the client explict control about the type of RAES file created.

Author:

Christian Schlichtherle

get

@CheckForNull
<P extends RaesParameters> P get(@NonNull
                                              Class<P> type)

Requests a RaesParameters instance of the given type.

Parameters:

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

Returns:

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