Package org.hibernate.type.descriptor.converter.internal

Class AttributeConverterMutabilityPlan<T,S>

java.lang.Object

org.hibernate.type.descriptor.java.MutableMutabilityPlan<T>

org.hibernate.type.descriptor.converter.internal.AttributeConverterMutabilityPlan<T,S>

All Implemented Interfaces:

Serializable, MutabilityPlan<T>

public final class AttributeConverterMutabilityPlan<T,S>
extends MutableMutabilityPlan<T>

The default MutabilityPlan for a converted value assumes, in the absence of additional evidence, that the value is mutable, so that dirty checking, deep copying, and second-level caching all work correctly in the case where it really is mutable.

As an exception to this, Java primitive types and enums are inferred to be immutable.

To explicitly mark a converted value is immutable and avoid the extra processing required for a mutable value, either:

• mark the Java type of the attribute, the type passed to the converter, as @Immutable,
• explicitly specify a MutabilityPlan using @Mutability, or
• explicitly specify its JavaTypeDescriptor using @JavaType.

See Also:

• HHH-10111
• HHH-10127
• RegistryHelper.determineMutabilityPlan(Type, TypeConfiguration)
• Serialized Form

Field Summary

Fields inherited from class org.hibernate.type.descriptor.java.MutableMutabilityPlan

INSTANCE

Constructor Summary

Constructors

Constructor	Description
AttributeConverterMutabilityPlan(JpaAttributeConverter<T,S> converter, boolean mutable)

Method Summary

Modifier and Type	Method	Description
T	assemble(Serializable cached, SharedSessionContract session)	Assemble a previously disassembled value.
protected T	deepCopyNotNull(T value)
Serializable	disassemble(T value, SharedSessionContract session)	Return a disassembled representation of the value.
boolean	isMutable()	Can the internal state of instances of T be changed?

Methods inherited from class org.hibernate.type.descriptor.java.MutableMutabilityPlan

deepCopy

Methods inherited from class java.lang.Object

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

Constructor Details

AttributeConverterMutabilityPlan

public AttributeConverterMutabilityPlan(JpaAttributeConverter<T,S> converter,
 boolean mutable)

Method Details

isMutable

public boolean isMutable()

Description copied from interface: MutabilityPlan

Can the internal state of instances of T be changed?

Specified by:

isMutable in interface MutabilityPlan<T>

Overrides:

isMutable in class MutableMutabilityPlan<T>

Returns:

True if the internal state can be changed; false otherwise.

deepCopyNotNull

protected T deepCopyNotNull(T value)

Specified by:

deepCopyNotNull in class MutableMutabilityPlan<T>

disassemble

public Serializable disassemble(T value,
 SharedSessionContract session)

Description copied from interface: MutabilityPlan

Return a disassembled representation of the value.

Called before storing a value in the second-level cache.

Complementary to MutabilityPlan.assemble(java.io.Serializable, org.hibernate.SharedSessionContract).

Specified by:

disassemble in interface MutabilityPlan<T>

Overrides:

disassemble in class MutableMutabilityPlan<T>

See Also:

• MutabilityPlan.assemble(java.io.Serializable, org.hibernate.SharedSessionContract)

assemble

public T assemble(Serializable cached,
 SharedSessionContract session)

Description copied from interface: MutabilityPlan

Assemble a previously disassembled value.

Called after reading a value from the second level cache.

Complementary to MutabilityPlan.disassemble(T, org.hibernate.SharedSessionContract).

Specified by:

assemble in interface MutabilityPlan<T>

Overrides:

assemble in class MutableMutabilityPlan<T>

See Also:

• MutabilityPlan.disassemble(T, org.hibernate.SharedSessionContract)