com.apple.foundationdb.record.provider.common

Class TransformedRecordSerializerJCE<M extends Message>

java.lang.Object

com.apple.foundationdb.record.provider.common.TransformedRecordSerializer<M>

com.apple.foundationdb.record.provider.common.TransformedRecordSerializerJCE<M>

Type Parameters:

M - type of Message that underlying records will use

All Implemented Interfaces:

RecordSerializer<M>

@API(value=UNSTABLE)
public class TransformedRecordSerializerJCE<M extends Message>
extends TransformedRecordSerializer<M>

An extension of TransformedRecordSerializer to use JCE to encrypt and decrypt records.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TransformedRecordSerializerJCE.Builder<M extends Message> Builder class for the TransformedRecordSerializerJCE class.

Nested classes/interfaces inherited from class com.apple.foundationdb.record.provider.common.TransformedRecordSerializer

TransformedRecordSerializer.TransformState

Nested classes/interfaces inherited from interface com.apple.foundationdb.record.provider.common.RecordSerializer

RecordSerializer.Counts, RecordSerializer.Events

Field Summary

Fields

Modifier and Type	Field and Description
protected String	cipherName
protected static String	DEFAULT_CIPHER
protected Key	encryptionKey
protected static int	IV_SIZE
protected SecureRandom	secureRandom

Fields inherited from class com.apple.foundationdb.record.provider.common.TransformedRecordSerializer

compressionLevel, compressWhenSerializing, DEFAULT_COMPRESSION_LEVEL, ENCODING_CLEAR, ENCODING_COMPRESSED, ENCODING_ENCRYPTED, ENCODING_PROTO_MESSAGE_FIELD, ENCODING_PROTO_TYPE_MASK, encryptWhenSerializing, inner, MAX_COMPRESSION_VERSION, MIN_COMPRESSION_VERSION

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TransformedRecordSerializerJCE(RecordSerializer<M> inner, boolean compressWhenSerializing, int compressionLevel, boolean encryptWhenSerializing, String cipherName, Key encryptionKey, SecureRandom secureRandom)

Method Summary

Modifier and Type	Method and Description
protected void	decrypt(TransformedRecordSerializer.TransformState state, StoreTimer timer)
protected void	encrypt(TransformedRecordSerializer.TransformState state, StoreTimer timer)
static <M extends Message> TransformedRecordSerializerJCE.Builder<M>	newBuilder(RecordSerializer<M> inner) Creates a new TransformedRecordSerializerJCE.Builder instance around the given serializer.
static TransformedRecordSerializerJCE.Builder<Message>	newDefaultBuilder() Creates a new TransformedRecordSerializerJCE.Builder instance that is backed by the default serializer for Messages, namely a DynamicMessageRecordSerializer.

Methods inherited from class com.apple.foundationdb.record.provider.common.TransformedRecordSerializer

compress, decompress, deserialize, serialize, widen

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CIPHER

protected static final String DEFAULT_CIPHER

See Also:

Constant Field Values

IV_SIZE

protected static final int IV_SIZE

See Also:

Constant Field Values

cipherName

@Nullable
protected final String cipherName

encryptionKey

@Nullable
protected final Key encryptionKey

secureRandom

@Nullable
protected final SecureRandom secureRandom

Constructor Detail

TransformedRecordSerializerJCE

protected TransformedRecordSerializerJCE(@Nonnull
                                         RecordSerializer<M> inner,
                                         boolean compressWhenSerializing,
                                         int compressionLevel,
                                         boolean encryptWhenSerializing,
                                         @Nullable
                                         String cipherName,
                                         @Nullable
                                         Key encryptionKey,
                                         @Nullable
                                         SecureRandom secureRandom)

Method Detail

encrypt

protected void encrypt(@Nonnull
                       TransformedRecordSerializer.TransformState state,
                       @Nullable
                       StoreTimer timer)
                throws GeneralSecurityException

Overrides:

encrypt in class TransformedRecordSerializer<M extends Message>

Throws:

GeneralSecurityException

decrypt

protected void decrypt(@Nonnull
                       TransformedRecordSerializer.TransformState state,
                       @Nullable
                       StoreTimer timer)
                throws GeneralSecurityException

Overrides:

decrypt in class TransformedRecordSerializer<M extends Message>

Throws:

GeneralSecurityException

newDefaultBuilder

public static TransformedRecordSerializerJCE.Builder<Message> newDefaultBuilder()

Creates a new TransformedRecordSerializerJCE.Builder instance that is backed by the default serializer for Messages, namely a DynamicMessageRecordSerializer. Methods on the returned Builder instance can be used to specify which transformations to apply after using the default serializer.

Returns:

Builder instance backed by a DynamicMessageRecordSerializer

newBuilder

public static <M extends Message> TransformedRecordSerializerJCE.Builder<M> newBuilder(@Nonnull
                                                                                       RecordSerializer<M> inner)

Creates a new TransformedRecordSerializerJCE.Builder instance around the given serializer. Methods on the Builder instance can be used to specify which transformations after using the provided serializer.

Type Parameters:

M - type of Message that underlying records will use

Parameters:

inner - RecordSerializer to use before/after applying transformations

Returns:

Builder instance that can be used to specify transformations