com.levigo.jadice.format.pdf.crypt

Interface CryptoMaterialReceiver<T extends CryptoMaterial>

Type Parameters:

T - a concrete implementation of CryptoMaterial.

public interface CryptoMaterialReceiver<T extends CryptoMaterial>

A callback infrastructure, usually implemented by security handlers and passed in when calling CryptoMaterialProvider.provide(CryptoMaterialReceiver).

Method Summary

Modifier and Type	Method and Description
void	cancel() Tells the receiving object, that the provider cancelled the crypto material request.
boolean	receive(T cryptoMaterial) Receive CryptoMaterial to authenticate for access the highest possible AuthLevel.
boolean	receive(T cryptoMaterial, AuthLevel requestedLevel) Receive CryptoMaterial to authenticate for access on a specific AuthLevel.

Method Detail

receive

boolean receive(T cryptoMaterial)

Receive CryptoMaterial to authenticate for access the highest possible AuthLevel.

Gives the receiving object the crypto material it requests. Should check all provided data necessary to get ready for decryption (or encryption). If the provided data is not sufficient, the implementation should return false otherwise true.

Parameters:

cryptoMaterial - holds the credentials to be used for authentication

Returns:

true if given crypto material was sufficient and accepted,
false if not.

receive

boolean receive(T cryptoMaterial,
                AuthLevel requestedLevel)

Receive CryptoMaterial to authenticate for access on a specific AuthLevel.

Gives the receiving object the crypto material it requests. Should check all provided data necessary to get ready for decryption (or encryption). If the provided data is not sufficient, the implementation should return false otherwise true.

Parameters:

cryptoMaterial - holds the credentials to be used for authentication

requestedLevel - the level of access which is requested. If the given CryptoMaterial would give access to a lower AuthLevel, this method still returns false.

Returns:

true if given crypto material was sufficient and accepted,
false if not.

cancel

void cancel()

Tells the receiving object, that the provider cancelled the crypto material request.