com.google.crypto.tink

Interface PrimitiveWrapper<B,P>

All Known Implementing Classes:

AeadWrapper, ChunkedMacWrapper, DeterministicAeadWrapper, HybridDecryptWrapper, HybridEncryptWrapper, PrfSetWrapper, PublicKeySignWrapper, StreamingAeadWrapper

public interface PrimitiveWrapper<B,P>

Basic interface for wrapping a primitive.

A PrimitiveSet can be wrapped by a single primitive in order to fulfil a cryptographic task. This is done by the PrimitiveWrapper. Whenever a new primitive type is added to Tink, the user should define a new PrimitiveWrapper and register it by calling com.google.crypto.tink.Registry#registerPrimitiveWrapper.

The primitive wrapper wraps primitives of type B into primitives of type P. Often, these are the same classes, but in some cases they may not be. There can only be one wrapper for each result primitive P (as Tink needs to know how to generate a P), but there may be many wrapping the same B.

Method Summary

Modifier and Type	Method and Description
Class<B>	getInputPrimitiveClass() Returns the primitive class object of the primitive used to create B.
Class<P>	getPrimitiveClass() Returns the primitive class object of the primitive managed.
P	wrap(PrimitiveSet<B> primitiveSet) Wraps a PrimitiveSet and returns a single instance.

Method Detail

wrap

P wrap(PrimitiveSet<B> primitiveSet)
throws GeneralSecurityException

Wraps a PrimitiveSet and returns a single instance.

This method gets called when a new primitive is created. primitiveSet is immutable. This has to be implemented when a new primitive type is added.

Throws:

GeneralSecurityException

getPrimitiveClass

Class<P> getPrimitiveClass()

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.

getInputPrimitiveClass

Class<B> getInputPrimitiveClass()

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