Package com.google.crypto.tink.aead

Class AeadWrapper

java.lang.Object

com.google.crypto.tink.aead.AeadWrapper

All Implemented Interfaces:

PrimitiveWrapper<Aead,Aead>

public class AeadWrapper
extends java.lang.Object
implements PrimitiveWrapper<Aead,Aead>

AeadWrapper is the implementation of SetWrapper for the Aead primitive.

Key rotation works as follows: each ciphertext is prefixed with the keyId. When decrypting, we first try all primitives whose keyId starts with the prefix of the ciphertext. If none of these succeed, we try the raw primitives. If any succeeds, we return the ciphertext, otherwise we simply throw a GeneralSecurityException.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.crypto.tink.internal.PrimitiveWrapper

PrimitiveWrapper.PrimitiveFactory<B>

Method Summary

Modifier and Type	Method	Description
java.lang.Class<Aead>	getInputPrimitiveClass()	Returns the primitive class object of the primitive used to create B.
java.lang.Class<Aead>	getPrimitiveClass()	Returns the primitive class object of the primitive managed.
static void	register()
static void	registerToInternalPrimitiveRegistry(PrimitiveRegistry.Builder primitiveRegistryBuilder)	registerToInternalPrimitiveRegistry is a non-public method (it takes an argument of an internal-only type) registering an instance of AeadWrapper to the provided PrimitiveRegistry.Builder.
Aead	wrap(KeysetHandleInterface keysetHandle, MonitoringAnnotations annotations, PrimitiveWrapper.PrimitiveFactory<Aead> factory)	Wraps a PrimitiveSet and returns a single instance.

Methods inherited from class java.lang.Object

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

Method Detail

wrap

public Aead wrap(KeysetHandleInterface keysetHandle,
                 MonitoringAnnotations annotations,
                 PrimitiveWrapper.PrimitiveFactory<Aead> factory)
          throws java.security.GeneralSecurityException

Description copied from interface: PrimitiveWrapper

Wraps a PrimitiveSet and returns a single instance.

This method gets called when a new primitive is created.

Specified by:

wrap in interface PrimitiveWrapper<Aead,Aead>

Throws:

java.security.GeneralSecurityException

getPrimitiveClass

public java.lang.Class<Aead> getPrimitiveClass()

Description copied from interface: PrimitiveWrapper

Returns the primitive class object of the primitive managed. Used for internal management. Should be implemented as return P.class; when implementing a wrapper creating objects of type P.

Specified by:

getPrimitiveClass in interface PrimitiveWrapper<Aead,Aead>

getInputPrimitiveClass

public java.lang.Class<Aead> getInputPrimitiveClass()

Description copied from interface: PrimitiveWrapper

Returns the primitive class object of the primitive used to create B. Used for internal management. Should be implemented as return B.class;.

Specified by:

getInputPrimitiveClass in interface PrimitiveWrapper<Aead,Aead>

register

public static void register()
                     throws java.security.GeneralSecurityException

Throws:

java.security.GeneralSecurityException

registerToInternalPrimitiveRegistry

public static void registerToInternalPrimitiveRegistry(PrimitiveRegistry.Builder primitiveRegistryBuilder)
                                                throws java.security.GeneralSecurityException

registerToInternalPrimitiveRegistry is a non-public method (it takes an argument of an internal-only type) registering an instance of AeadWrapper to the provided PrimitiveRegistry.Builder.

Throws:

java.security.GeneralSecurityException