Class ConvertedBasicTypeImpl<J>
- java.lang.Object
-
- org.hibernate.type.internal.ConvertedBasicTypeImpl<J>
-
- All Implemented Interfaces:
BasicType<J>
,Type<J>
,Serializable
,BasicValuedMapping
,Bindable
,JdbcMapping
,JdbcMappingContainer
,MappingModelExpressible
,MappingType
,SqlExpressible
,ValueMapping
,BasicDomainType<J>
,DomainType<J>
,SimpleDomainType<J>
,BindableType<J>
,OutputableType<J>
,ReturnableType<J>
,SqmExpressible<J>
,AdjustableBasicType<J>
,BasicType<J>
,ConvertedBasicType<J>
,JavaTypedExpressible
,ProcedureParameterExtractionAware<J>
,ProcedureParameterNamedBinder<J>
,Type
- Direct Known Subclasses:
CustomMutabilityConvertedBasicTypeImpl
,DiscriminatorTypeImpl
public class ConvertedBasicTypeImpl<J> extends Object implements ConvertedBasicType<J>, AdjustableBasicType<J>, ProcedureParameterExtractionAware<J>, ProcedureParameterNamedBinder<J>
- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.hibernate.metamodel.mapping.Bindable
Bindable.JdbcValuesBiConsumer<X,Y>, Bindable.JdbcValuesConsumer
-
Nested classes/interfaces inherited from interface jakarta.persistence.metamodel.Type
Type.PersistenceType
-
-
Field Summary
Fields Modifier and Type Field Description static String
EXTERNALIZED_PREFIX
static String[]
NO_REG_KEYS
-
Constructor Summary
Constructors Constructor Description ConvertedBasicTypeImpl(String name, String description, JdbcType jdbcType, BasicValueConverter<J,?> converter)
ConvertedBasicTypeImpl(String name, JdbcType jdbcType, BasicValueConverter<J,?> converter)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Object
assemble(Serializable cached, SharedSessionContractImplementor session, Object owner)
Reconstruct the object from its disassembled state.void
beforeAssemble(Serializable cached, SharedSessionContractImplementor session)
Called before assembling a query result set from the query cache, to allow batch fetching of entities missing from the second-level cache.boolean
canDoExtraction()
Can the given instance of this type actually perform the parameter value extractions?boolean
canDoSetting()
Can the given instance of this type actually set the parameter value by nameint
compare(Object x, Object y)
Perform aComparator
-style comparison of the given values.Object
deepCopy(Object value, SessionFactoryImplementor factory)
Return a deep copy of the persistent state, stopping at entities and at collections.Object
disassemble(Object value, SharedSessionContractImplementor session)
Breaks down a value ofJ
into its simple pieces.Serializable
disassemble(Object value, SharedSessionContractImplementor session, Object owner)
Return a disassembled representation of the object.J
extract(CallableStatement statement, int startIndex, SharedSessionContractImplementor session)
Perform the extractionJ
extract(CallableStatement statement, String paramName, SharedSessionContractImplementor session)
Perform the extractionCastType
getCastType()
int
getColumnSpan(Mapping mapping)
How many columns are used to persist this type?int
getHashCode(Object x)
Get a hash code, consistent with persistence "equality".int
getHashCode(Object x, SessionFactoryImplementor factory)
Get a hash code, consistent with persistence "equality".Class<J>
getJavaType()
JavaType<J>
getJavaTypeDescriptor()
The descriptor for the Java type represented by this expressible typeJavaType<?>
getJdbcJavaType()
JdbcLiteralFormatter
getJdbcLiteralFormatter()
The strategy for formatting values of this expressible type to a SQL literal.JdbcType
getJdbcType()
Descriptor for the SQL type mapped by this type.ValueBinder<J>
getJdbcValueBinder()
The strategy for binding values of this expressible type to JDBCPreparedStatement
s andCallableStatement
s.ValueExtractor<J>
getJdbcValueExtractor()
The strategy for extracting values of this expressible type from JDBC ResultSets, CallableStatements, etcprotected MutabilityPlan<J>
getMutabilityPlan()
String
getName()
Returns the abbreviated name of the type.String[]
getRegistrationKeys()
Get the names under which this type should be registered in the type registry.Class
getReturnedClass()
The class handled by this type.int[]
getSqlTypeCodes(Mapping mapping)
BasicValueConverter
getValueConverter()
Returns the converter that this basic type uses for transforming from the domain type, to the relational type, ornull
if there is no conversion.boolean
isAnyType()
Return true if the implementation is castable toAnyType
.boolean
isAssociationType()
Return true if the implementation is castable toAssociationType
.boolean
isCollectionType()
Return true if the implementation is castable toCollectionType
.boolean
isComponentType()
Return true if the implementation is castable toCompositeType
.protected boolean
isDirty(Object old, Object current)
boolean
isDirty(Object old, Object current, boolean[] checkable, SharedSessionContractImplementor session)
Should the parent be considered dirty, given both the old and current value?boolean
isDirty(Object old, Object current, SharedSessionContractImplementor session)
Should the parent be considered dirty, given both the old and current value?boolean
isEntityType()
Return true if the implementation is castable toEntityType
.boolean
isEqual(Object one, Object another)
Compare two instances of the class mapped by this type for persistence "equality", that is, equality of persistent state.boolean
isEqual(Object x, Object y, SessionFactoryImplementor factory)
Compare two instances of the class mapped by this type for persistence "equality", that is, equality of persistent state.boolean
isModified(Object oldHydratedState, Object currentState, boolean[] checkable, SharedSessionContractImplementor session)
Has the value been modified compared to the current database state? The difference between this and theType.isDirty(java.lang.Object, java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor)
methods is that here we need to account for "partially" built values.boolean
isMutable()
Are objects of this type mutable with respect to the referencing object? Entities and collections are considered immutable because they manage their own internal state.boolean
isSame(Object x, Object y)
Compare two instances of the class mapped by this type for persistence "equality", that is, equality of persistent state, taking a shortcut for entity references.void
nullSafeSet(CallableStatement st, J value, String name, SharedSessionContractImplementor session)
Bind a value to the JDBC prepared statement, ignoring some columns as dictated by the 'settable' parameter.void
nullSafeSet(PreparedStatement st, Object value, int index, boolean[] settable, SharedSessionContractImplementor session)
Bind a value represented by an instance of themapped class
to the given JDBCPreparedStatement
, ignoring some columns as dictated by thesettable
parameter.void
nullSafeSet(PreparedStatement st, Object value, int index, SharedSessionContractImplementor session)
Bind a value represented by an instance of themapped class
to the given JDBCPreparedStatement
, ignoring some columns as dictated by thesettable
parameter.Object
replace(Object original, Object target, SharedSessionContractImplementor session, Object owner, Map<Object,Object> copyCache)
During merge, replace the existing (target) value in the entity we are merging to with a new (original) value from the detached entity we are merging.Object
replace(Object original, Object target, SharedSessionContractImplementor session, Object owner, Map<Object,Object> copyCache, ForeignKeyDirection foreignKeyDirection)
During merge, replace the existing (target) value in the entity we are merging to with a new (original) value from the detached entity we are merging.boolean[]
toColumnNullness(Object value, Mapping mapping)
Given an instance of the type, return an array ofboolean
values indicating which mapped columns would be null.String
toLoggableString(Object value, SessionFactoryImplementor factory)
Generate a representation of the given value for logging purposes.String
toString()
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.hibernate.type.AdjustableBasicType
resolveIndicatedType
-
Methods inherited from interface org.hibernate.metamodel.model.domain.BasicDomainType
areEqual, getPersistenceType
-
Methods inherited from interface org.hibernate.type.BasicType
compare, forEachDisassembledJdbcValue, forEachJdbcType, forEachJdbcType, getCheckCondition, getExpressibleJavaType, getJdbcMapping, getJdbcMapping, getJdbcTypeCount, getMappedJavaType, getMappedType, getSingleJdbcMapping
-
Methods inherited from interface org.hibernate.metamodel.mapping.BasicValuedMapping
addToCacheKey
-
Methods inherited from interface org.hibernate.metamodel.mapping.Bindable
forEachDisassembledJdbcValue, forEachDisassembledJdbcValue, forEachDisassembledJdbcValue, forEachJdbcValue, forEachJdbcValue, forEachJdbcValue, forEachJdbcValue
-
Methods inherited from interface org.hibernate.metamodel.model.domain.DomainType
getSqmType, getTupleLength
-
Methods inherited from interface org.hibernate.metamodel.mapping.JdbcMapping
convertToDomainValue, convertToRelationalValue
-
Methods inherited from interface org.hibernate.metamodel.model.domain.SimpleDomainType
getBindableJavaType
-
Methods inherited from interface org.hibernate.query.sqm.SqmExpressible
getRelationalJavaType, getTypeName, isInstance, resolveExpressible
-
Methods inherited from interface org.hibernate.type.Type
disassemble, getReturnedClassName, getTypeForEqualsHashCode
-
Methods inherited from interface org.hibernate.metamodel.mapping.ValueMapping
treatAs
-
-
-
-
Field Detail
-
EXTERNALIZED_PREFIX
public static final String EXTERNALIZED_PREFIX
- See Also:
- Constant Field Values
-
NO_REG_KEYS
public static final String[] NO_REG_KEYS
-
-
Constructor Detail
-
ConvertedBasicTypeImpl
public ConvertedBasicTypeImpl(String name, JdbcType jdbcType, BasicValueConverter<J,?> converter)
-
ConvertedBasicTypeImpl
public ConvertedBasicTypeImpl(String name, String description, JdbcType jdbcType, BasicValueConverter<J,?> converter)
-
-
Method Detail
-
getName
public String getName()
Description copied from interface:Type
Returns the abbreviated name of the type.
-
getRegistrationKeys
public String[] getRegistrationKeys()
Description copied from interface:BasicType
Get the names under which this type should be registered in the type registry.- Specified by:
getRegistrationKeys
in interfaceBasicType<J>
- Returns:
- The keys under which to register this type.
-
getValueConverter
public BasicValueConverter getValueConverter()
Description copied from interface:JdbcMapping
Returns the converter that this basic type uses for transforming from the domain type, to the relational type, ornull
if there is no conversion.- Specified by:
getValueConverter
in interfaceBasicType<J>
- Specified by:
getValueConverter
in interfaceConvertedBasicType<J>
- Specified by:
getValueConverter
in interfaceJdbcMapping
-
getJdbcValueExtractor
public ValueExtractor<J> getJdbcValueExtractor()
Description copied from interface:JdbcMapping
The strategy for extracting values of this expressible type from JDBC ResultSets, CallableStatements, etc- Specified by:
getJdbcValueExtractor
in interfaceBasicType<J>
- Specified by:
getJdbcValueExtractor
in interfaceJdbcMapping
-
getJdbcValueBinder
public ValueBinder<J> getJdbcValueBinder()
Description copied from interface:JdbcMapping
The strategy for binding values of this expressible type to JDBCPreparedStatement
s andCallableStatement
s.- Specified by:
getJdbcValueBinder
in interfaceBasicType<J>
- Specified by:
getJdbcValueBinder
in interfaceJdbcMapping
-
getJdbcLiteralFormatter
public JdbcLiteralFormatter getJdbcLiteralFormatter()
Description copied from interface:JdbcMapping
The strategy for formatting values of this expressible type to a SQL literal.- Specified by:
getJdbcLiteralFormatter
in interfaceBasicType<J>
- Specified by:
getJdbcLiteralFormatter
in interfaceJdbcMapping
-
getJavaType
public Class<J> getJavaType()
- Specified by:
getJavaType
in interfaceType<J>
-
getJdbcJavaType
public JavaType<?> getJdbcJavaType()
- Specified by:
getJdbcJavaType
in interfaceJdbcMapping
-
toColumnNullness
public boolean[] toColumnNullness(Object value, Mapping mapping)
Description copied from interface:Type
Given an instance of the type, return an array ofboolean
values indicating which mapped columns would be null.- Specified by:
toColumnNullness
in interfaceType
- Parameters:
value
- an instance of the typemapping
- The mapping abstraction- Returns:
- array indicating column nullness for a value instance
-
getJavaTypeDescriptor
public final JavaType<J> getJavaTypeDescriptor()
Description copied from interface:JdbcMapping
The descriptor for the Java type represented by this expressible type- Specified by:
getJavaTypeDescriptor
in interfaceBasicType<J>
- Specified by:
getJavaTypeDescriptor
in interfaceJdbcMapping
-
getJdbcType
public final JdbcType getJdbcType()
Description copied from interface:OutputableType
Descriptor for the SQL type mapped by this type.- Specified by:
getJdbcType
in interfaceJdbcMapping
- Specified by:
getJdbcType
in interfaceOutputableType<J>
-
getReturnedClass
public final Class getReturnedClass()
Description copied from interface:Type
The class handled by this type.- Specified by:
getReturnedClass
in interfaceType
- Returns:
- The Java class handled by this type.
-
getColumnSpan
public final int getColumnSpan(Mapping mapping) throws MappingException
Description copied from interface:Type
How many columns are used to persist this type?Always the same as
getSqlTypCodes(mapping).length
.- Specified by:
getColumnSpan
in interfaceType
- Parameters:
mapping
- The mapping object :/- Returns:
- The number of columns
- Throws:
MappingException
- Generally indicates an issue accessing the passed mapping object.
-
getSqlTypeCodes
public final int[] getSqlTypeCodes(Mapping mapping) throws MappingException
Description copied from interface:Type
Return the JDBC types codes as defined byTypes
orSqlTypes
for the columns mapped by this type.The number of elements in this array must match the return from
Type.getColumnSpan(org.hibernate.engine.spi.Mapping)
.- Specified by:
getSqlTypeCodes
in interfaceType
- Parameters:
mapping
- The mapping object :/- Returns:
- The JDBC type codes.
- Throws:
MappingException
- Generally indicates an issue accessing the passed mapping object.
-
isAssociationType
public final boolean isAssociationType()
Description copied from interface:Type
Return true if the implementation is castable toAssociationType
. This does not necessarily imply that the type actually represents an association. Shortcut fortype instanceof AssociationType
.- Specified by:
isAssociationType
in interfaceType
- Returns:
- True if this type is also an
AssociationType
implementor; false otherwise.
-
isCollectionType
public final boolean isCollectionType()
Description copied from interface:Type
Return true if the implementation is castable toCollectionType
. Shortcut fortype instanceof CollectionType
A
CollectionType
is additionally anAssociationType
; so if this method returns true,Type.isAssociationType()
should also return true.- Specified by:
isCollectionType
in interfaceType
- Returns:
- True if this type is also a
CollectionType
implementor; false otherwise.
-
isComponentType
public final boolean isComponentType()
Description copied from interface:Type
Return true if the implementation is castable toCompositeType
. Shortcut fortype instanceof CompositeType
.A component type may own collections or associations and hence must provide certain extra functionality.
- Specified by:
isComponentType
in interfaceType
- Returns:
- True if this type is also a
CompositeType
implementor; false otherwise.
-
isEntityType
public final boolean isEntityType()
Description copied from interface:Type
Return true if the implementation is castable toEntityType
. Shortcut fortype instanceof EntityType
.An
EntityType
is additionally anAssociationType
; so if this method returns true,Type.isAssociationType()
should also return true.- Specified by:
isEntityType
in interfaceType
- Returns:
- True if this type is also an
EntityType
implementor; false otherwise.
-
isAnyType
public final boolean isAnyType()
Description copied from interface:Type
Return true if the implementation is castable toAnyType
. Shortcut fortype instanceof AnyType
.An
AnyType
is additionally anAssociationType
; so if this method returns true, thenType.isAssociationType()
should also return true.
-
isSame
public final boolean isSame(Object x, Object y)
Description copied from interface:Type
Compare two instances of the class mapped by this type for persistence "equality", that is, equality of persistent state, taking a shortcut for entity references.For most types this should boil down to an equality comparison of the given values, and it's reasonable to simply delegate to
Type.isEqual(Object, Object)
. But for associations the semantics are a bit different.
-
isEqual
public final boolean isEqual(Object x, Object y, SessionFactoryImplementor factory)
Description copied from interface:Type
Compare two instances of the class mapped by this type for persistence "equality", that is, equality of persistent state. For most types this could simply delegate toType.isEqual(Object, Object)
.This should always equate to some form of comparison of the value's internal state. As an example, for Java's
Date
class, the comparison should be of its internal state, but based only on the specific part which is persistent (the timestamp, date, or time).
-
isEqual
public boolean isEqual(Object one, Object another)
Description copied from interface:Type
Compare two instances of the class mapped by this type for persistence "equality", that is, equality of persistent state. For most types this could simply delegate toequals()
.This should always equate to some form of comparison of the value's internal state. As an example, for Java's
Date
class, the comparison should be of its internal state, but based only on the specific part which is persistent (the timestamp, date, or time).
-
getHashCode
public int getHashCode(Object x)
Description copied from interface:Type
Get a hash code, consistent with persistence "equality". For most types this could simply delegate to the given value'shashCode
.- Specified by:
getHashCode
in interfaceType
- Parameters:
x
- The value for which to retrieve a hash code- Returns:
- The hash code
-
getHashCode
public final int getHashCode(Object x, SessionFactoryImplementor factory)
Description copied from interface:Type
Get a hash code, consistent with persistence "equality". For most types this could simply delegate toType.getHashCode(Object)
.- Specified by:
getHashCode
in interfaceType
- Parameters:
x
- The value for which to retrieve a hash codefactory
- The session factory- Returns:
- The hash code
-
compare
public final int compare(Object x, Object y)
Description copied from interface:Type
Perform aComparator
-style comparison of the given values.- Specified by:
compare
in interfaceType
- Parameters:
x
- The first valuey
- The second value- Returns:
- The comparison result.
- See Also:
Comparator.compare(Object, Object)
-
isDirty
public final boolean isDirty(Object old, Object current, SharedSessionContractImplementor session)
Description copied from interface:Type
Should the parent be considered dirty, given both the old and current value?
-
isDirty
public final boolean isDirty(Object old, Object current, boolean[] checkable, SharedSessionContractImplementor session)
Description copied from interface:Type
Should the parent be considered dirty, given both the old and current value?
-
isModified
public final boolean isModified(Object oldHydratedState, Object currentState, boolean[] checkable, SharedSessionContractImplementor session)
Description copied from interface:Type
Has the value been modified compared to the current database state? The difference between this and theType.isDirty(java.lang.Object, java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor)
methods is that here we need to account for "partially" built values. This is really only an issue with association types. For most type implementations it is enough to simply delegate toType.isDirty(java.lang.Object, java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor)
.- Specified by:
isModified
in interfaceType
- Parameters:
oldHydratedState
- the database state, in a "hydrated" form, with identifiers unresolvedcurrentState
- the current state of the objectcheckable
- which columns are actually checkablesession
- The session from which the request originated.- Returns:
- true if the field has been modified
-
nullSafeSet
public final void nullSafeSet(PreparedStatement st, Object value, int index, boolean[] settable, SharedSessionContractImplementor session) throws HibernateException, SQLException
Description copied from interface:Type
Bind a value represented by an instance of themapped class
to the given JDBCPreparedStatement
, ignoring some columns as dictated by thesettable
parameter. Implementors should handle the possibility of null values. A multi-column type should bind parameters starting fromindex
.- Specified by:
nullSafeSet
in interfaceType
- Parameters:
st
- The JDBC prepared statement to which to bindvalue
- the object to writeindex
- starting parameter bind indexsettable
- an array indicating which columns to bind/ignoresession
- The originating session- Throws:
HibernateException
- An error from HibernateSQLException
- An error from the JDBC driver
-
nullSafeSet
public void nullSafeSet(CallableStatement st, J value, String name, SharedSessionContractImplementor session) throws SQLException
Description copied from interface:ProcedureParameterNamedBinder
Bind a value to the JDBC prepared statement, ignoring some columns as dictated by the 'settable' parameter. Implementors should handle the possibility of null values. Does not support multi-column type- Specified by:
nullSafeSet
in interfaceProcedureParameterNamedBinder<J>
- Parameters:
st
- The CallableStatement to which to bindvalue
- the object to writename
- parameter bind namesession
- The originating session- Throws:
SQLException
- An error from the JDBC driver
-
nullSafeSet
public final void nullSafeSet(PreparedStatement st, Object value, int index, SharedSessionContractImplementor session) throws SQLException
Description copied from interface:Type
Bind a value represented by an instance of themapped class
to the given JDBCPreparedStatement
, ignoring some columns as dictated by thesettable
parameter. Implementors should handle the possibility of null values. A multi-column type should bind parameters starting fromindex
.- Specified by:
nullSafeSet
in interfaceType
- Parameters:
st
- The JDBC prepared statement to which to bindvalue
- the object to writeindex
- starting parameter bind indexsession
- The originating session- Throws:
SQLException
- An error from the JDBC driver
-
toLoggableString
public final String toLoggableString(Object value, SessionFactoryImplementor factory)
Description copied from interface:Type
Generate a representation of the given value for logging purposes.- Specified by:
toLoggableString
in interfaceType
- Parameters:
value
- The value to be loggedfactory
- The session factory- Returns:
- The loggable representation
-
getMutabilityPlan
protected MutabilityPlan<J> getMutabilityPlan()
-
isMutable
public final boolean isMutable()
Description copied from interface:Type
Are objects of this type mutable with respect to the referencing object? Entities and collections are considered immutable because they manage their own internal state.
-
deepCopy
public final Object deepCopy(Object value, SessionFactoryImplementor factory)
Description copied from interface:Type
Return a deep copy of the persistent state, stopping at entities and at collections.
-
beforeAssemble
public final void beforeAssemble(Serializable cached, SharedSessionContractImplementor session)
Description copied from interface:Type
Called before assembling a query result set from the query cache, to allow batch fetching of entities missing from the second-level cache.- Specified by:
beforeAssemble
in interfaceType
- Parameters:
cached
- The keysession
- The originating session
-
assemble
public final Object assemble(Serializable cached, SharedSessionContractImplementor session, Object owner) throws HibernateException
Description copied from interface:Type
Reconstruct the object from its disassembled state. This function is the inverse ofType.disassemble(Object, SharedSessionContractImplementor, Object)
.- Specified by:
assemble
in interfaceType
- Parameters:
cached
- the disassembled state from the cachesession
- the originating sessionowner
- the parent entity object- Returns:
- the (re)assembled object
- Throws:
HibernateException
- An error from Hibernate
-
disassemble
public final Serializable disassemble(Object value, SharedSessionContractImplementor session, Object owner) throws HibernateException
Description copied from interface:Type
Return a disassembled representation of the object. This is the representation that is stored in the second-level cache.A reference to an associated entity should be disassembled to its primary key value.
- Specified by:
disassemble
in interfaceType
- Parameters:
value
- the value to cachesession
- the originating sessionowner
- optional parent entity object (needed for collections)- Returns:
- the disassembled, deep cloned state
- Throws:
HibernateException
- An error from Hibernate
-
disassemble
public Object disassemble(Object value, SharedSessionContractImplementor session)
Description copied from interface:Bindable
Breaks down a value ofJ
into its simple pieces. E.g., an embedded value gets broken down into an array of its attribute state; a basic value converts to itself; etc.Generally speaking, this is the form in which entity state is kept relative to a Session via
EntityEntry
.@Entity class Person { @Id Integer id; @Embedded Name name; int age; } @Embeddable class Name { String familiarName; String familyName; }
At the top level, we would want to disassemble a
Person
value, so we'd ask theBindable
for thePerson
entity to disassemble. Given aPerson
value:Person( id=1, name=Name( 'Steve', 'Ebersole' ), 28 )
this disassemble would result in a multidimensional array:
[ ["Steve", "Ebersole"], 28 ]
Note that the identifier is not part of this disassembled state. Note also how the embedded value results in a sub-array.
- Specified by:
disassemble
in interfaceBasicType<J>
- Specified by:
disassemble
in interfaceBasicValuedMapping
- Specified by:
disassemble
in interfaceBindable
- See Also:
EntityEntry
-
replace
public final Object replace(Object original, Object target, SharedSessionContractImplementor session, Object owner, Map<Object,Object> copyCache)
Description copied from interface:Type
During merge, replace the existing (target) value in the entity we are merging to with a new (original) value from the detached entity we are merging. For immutable objects, or null values, it is safe to simply return the first parameter. For mutable objects, it is safe to return a copy of the first parameter. For objects with component values, it might make sense to recursively replace component values.- Specified by:
replace
in interfaceType
- Parameters:
original
- the value from the detached entity being mergedtarget
- the value in the managed entitysession
- The originating sessionowner
- The owner of the valuecopyCache
- The cache of already copied/replaced values- Returns:
- the value to be merged
-
replace
public Object replace(Object original, Object target, SharedSessionContractImplementor session, Object owner, Map<Object,Object> copyCache, ForeignKeyDirection foreignKeyDirection)
Description copied from interface:Type
During merge, replace the existing (target) value in the entity we are merging to with a new (original) value from the detached entity we are merging. For immutable objects, or null values, it is safe to simply return the first parameter. For mutable objects, it is safe to return a copy of the first parameter. For objects with component values, it might make sense to recursively replace component values.- Specified by:
replace
in interfaceType
- Parameters:
original
- the value from the detached entity being mergedtarget
- the value in the managed entitysession
- The originating sessionowner
- The owner of the valuecopyCache
- The cache of already copied/replaced valuesforeignKeyDirection
- For associations, which direction does the foreign key point?- Returns:
- the value to be merged
-
canDoExtraction
public boolean canDoExtraction()
Description copied from interface:OutputableType
Can the given instance of this type actually perform the parameter value extractions?- Specified by:
canDoExtraction
in interfaceOutputableType<J>
- Returns:
true
indicates thatOutputableType.extract(java.sql.CallableStatement, int, org.hibernate.engine.spi.SharedSessionContractImplementor)
calls will not fail due toIllegalStateException
.
-
extract
public J extract(CallableStatement statement, int startIndex, SharedSessionContractImplementor session) throws SQLException
Description copied from interface:OutputableType
Perform the extraction- Specified by:
extract
in interfaceOutputableType<J>
- Parameters:
statement
- The CallableStatement from which to extract the parameter value(s).startIndex
- The parameter index from which to extractsession
- The originating session- Returns:
- The extracted value.
- Throws:
SQLException
- Indicates an issue calling into the CallableStatement
-
extract
public J extract(CallableStatement statement, String paramName, SharedSessionContractImplementor session) throws SQLException
Description copied from interface:OutputableType
Perform the extraction- Specified by:
extract
in interfaceOutputableType<J>
- Parameters:
statement
- The CallableStatement from which to extract the parameter value(s).paramName
- The parameter names.session
- The originating session- Returns:
- The extracted value.
- Throws:
SQLException
- Indicates an issue calling into the CallableStatement
-
canDoSetting
public boolean canDoSetting()
Description copied from interface:ProcedureParameterNamedBinder
Can the given instance of this type actually set the parameter value by name- Specified by:
canDoSetting
in interfaceProcedureParameterNamedBinder<J>
- Returns:
true
indicates that @{link #nullSafeSet} calls will not fail
-
getCastType
public CastType getCastType()
- Specified by:
getCastType
in interfaceJdbcMapping
-
-