Class AbstractCopier<A>

java.lang.Object

com.github.benmanes.caffeine.jcache.copy.AbstractCopier<A>

All Implemented Interfaces:

Copier

Direct Known Subclasses:

JavaSerializationCopier

public abstract class AbstractCopier<A>
extends Object
implements Copier

A skeleton implementation where subclasses provide the serialization strategy. Serialization is not performed if the type is a known immutable, an array of known immutable types, or specially handled by a known cloning strategy.

Field Summary

Fields

Modifier and Type	Field	Description
private final Map<Class<?>, Function<Object,Object>>	deepCopyStrategies
private final Set<Class<?>>	immutableClasses
private static final Map<Class<?>, Function<Object,Object>>	JAVA_DEEP_COPY
private static final Set<Class<?>>	JAVA_IMMUTABLE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractCopier()
protected	AbstractCopier(Set<Class<?>> immutableClasses, Map<Class<?>, Function<Object,Object>> deepCopyStrategies)

Method Summary

Modifier and Type	Method	Description
private static <T> T	arrayCopy(T object)
protected boolean	canDeeplyCopy(Class<?> clazz)	Returns if the class has a known deep copy strategy.
<T> T	copy(T object, ClassLoader classLoader)	Returns a deep copy of the object.
private <T> T	deepCopy(T object)
protected abstract Object	deserialize(A data, ClassLoader classLoader)	Deserializes the data using the provided classloader.
private boolean	isArrayOfImmutableTypes(Class<?> clazz)
protected boolean	isImmutable(Class<?> clazz)	Returns if the class is an immutable type and does not need to be copied.
static Map<Class<?>, Function<Object,Object>>	javaDeepCopyStrategies()
static Set<Class<?>>	javaImmutableClasses()
protected <T> T	roundtrip(T object, ClassLoader classLoader)	Performs the serialization and deserialization, returning the copied object.
protected abstract A	serialize(Object object)	Serializes the object.

Methods inherited from class Object

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

Field Details

JAVA_DEEP_COPY

private static final Map<Class<?>, Function<Object,Object>> JAVA_DEEP_COPY

JAVA_IMMUTABLE

private static final Set<Class<?>> JAVA_IMMUTABLE

immutableClasses

private final Set<Class<?>> immutableClasses

deepCopyStrategies

private final Map<Class<?>, Function<Object,Object>> deepCopyStrategies

Constructor Details

AbstractCopier

protected AbstractCopier()

AbstractCopier

protected AbstractCopier(Set<Class<?>> immutableClasses,
 Map<Class<?>, Function<Object,Object>> deepCopyStrategies)

Method Details

javaImmutableClasses

public static Set<Class<?>> javaImmutableClasses()

Returns:

the set of Java native classes that are immutable

javaDeepCopyStrategies

public static Map<Class<?>, Function<Object,Object>> javaDeepCopyStrategies()

Returns:

the set of Java native classes that are deeply copied.

copy

public <T> T copy(T object,
 ClassLoader classLoader)

Description copied from interface: Copier

Returns a deep copy of the object.

Specified by:

copy in interface Copier

Type Parameters:

T - the type of object being copied

Parameters:

object - the object to copy

classLoader - the classloader to instantiate with

Returns:

a copy of the object

isImmutable

protected boolean isImmutable(Class<?> clazz)

Returns if the class is an immutable type and does not need to be copied.

Parameters:

clazz - the class of the object being copied

Returns:

if the class is an immutable type and does not need to be copied

canDeeplyCopy

protected boolean canDeeplyCopy(Class<?> clazz)

Returns if the class has a known deep copy strategy.

Parameters:

clazz - the class of the object being copied

Returns:

if the class has a known deep copy strategy

isArrayOfImmutableTypes

private boolean isArrayOfImmutableTypes(Class<?> clazz)

Returns:

if the class represents an array of immutable values.

arrayCopy

private static <T> T arrayCopy(T object)

Returns:

a shallow copy of the array.

deepCopy

private <T> T deepCopy(T object)

Returns:

a deep copy of the object.

roundtrip

protected <T> T roundtrip(T object,
 ClassLoader classLoader)

Performs the serialization and deserialization, returning the copied object.

Type Parameters:

T - the type of object being copied

Parameters:

object - the object to serialize

classLoader - the classloader to create the instance with

Returns:

the deserialized object

serialize

protected abstract A serialize(Object object)

Serializes the object.

Parameters:

object - the object to serialize

Returns:

the serialized bytes

deserialize

protected abstract Object deserialize(A data,
 ClassLoader classLoader)

Deserializes the data using the provided classloader.

Parameters:

data - the serialized bytes

classLoader - the classloader to create the instance with

Returns:

the deserialized object