Interface BasicValuedMapping

All Superinterfaces:

Bindable, JavaTypedExpressible, JdbcMappingContainer, MappingModelExpressible, SqlExpressible, ValueMapping

All Known Subinterfaces:

AdjustableBasicType<J>, BasicEntityIdentifierMapping, BasicPluralType<C,E>, BasicType<T>, BasicValuedModelPart, CollectionIdentifierDescriptor, ConvertedBasicType<J>, DiscriminatorMapping, DiscriminatorType<O>, EmbeddableDiscriminatorMapping, EntityDiscriminatorMapping, EntityRowIdMapping, EntityVersionMapping

All Known Implementing Classes:

org.hibernate.sql.exec.internal.AbstractJdbcParameter, AbstractSingleColumnStandardBasicType, AbstractStandardBasicType, BasicArrayType, BasicCollectionType, BottomType, ColumnValueParameter, ConvertedBasicArrayType, ConvertedBasicCollectionType, CustomType, EmbeddableTypeLiteral, EntityTypeLiteral, JavaObjectType, NullType, QueryParameterJavaObjectType, SerializableType, StandardBasicTypeTemplate

@SPI({USE,IMPLEMENT})
public interface BasicValuedMapping
extends ValueMapping, SqlExpressible

Any basic-typed ValueMapping. Generally this would be one of

• a Basic attribute
• a basic-valued collection part
• a BasicType

Nested Class Summary

Nested classes/interfaces inherited from interface Bindable

Bindable.JdbcValuesBiConsumer<X,Y>, Bindable.JdbcValuesConsumer

Method Summary

Modifier and Type	Method	Description
default void	addToCacheKey(MutableCacheKeyBuilder cacheKey, Object value, SharedSessionContractImplementor session)	Add to the MutableCacheKey the values obtained disassembling the value and the hasCode generated from the disassembled value.
default Object	disassemble(Object value, SharedSessionContractImplementor session)	Breaks down a value of J into its simple pieces.
JdbcMapping	getJdbcMapping()	Anything that is expressible at the SQL AST level would be of basic type.
default JdbcMapping	getJdbcMapping(int index)
default int	getJdbcTypeCount()	The number of JDBC mappings
default JdbcMapping	getSingleJdbcMapping()

Methods inherited from interface Bindable

forEachDisassembledJdbcValue, forEachDisassembledJdbcValue, forEachDisassembledJdbcValue, forEachDisassembledJdbcValue, forEachJdbcType, forEachJdbcValue, forEachJdbcValue, forEachJdbcValue, forEachJdbcValue

Methods inherited from interface JdbcMappingContainer

forEachJdbcType

Methods inherited from interface ValueMapping

getExpressibleJavaType, getMappedType, treatAs

Method Details

getJdbcTypeCount

default int getJdbcTypeCount()

Description copied from interface: Bindable

The number of JDBC mappings

Specified by:

getJdbcTypeCount in interface Bindable

Specified by:

getJdbcTypeCount in interface JdbcMappingContainer

getJdbcMapping

@Nonnull
default JdbcMapping getJdbcMapping(int index)

Specified by:

getJdbcMapping in interface JdbcMappingContainer

Specified by:

getJdbcMapping in interface SqlExpressible

getSingleJdbcMapping

@Nonnull
default JdbcMapping getSingleJdbcMapping()

Specified by:

getSingleJdbcMapping in interface JdbcMappingContainer

getJdbcMapping

@Nonnull
JdbcMapping getJdbcMapping()

Description copied from interface: SqlExpressible

Anything that is expressible at the SQL AST level would be of basic type.

Specified by:

getJdbcMapping in interface SqlExpressible

disassemble

@Nullable
default Object disassemble(@Nullable
 Object value,
 @Nullable
 SharedSessionContractImplementor session)

Description copied from interface: Bindable

Breaks down a value of J 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 the Bindable for the Person entity to disassemble. Given a Person 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 interface Bindable

See Also:

• EntityEntry

addToCacheKey

default void addToCacheKey(@Nonnull
 MutableCacheKeyBuilder cacheKey,
 @Nullable
 Object value,
 @Nullable
 SharedSessionContractImplementor session)

Description copied from interface: Bindable

Add to the MutableCacheKey the values obtained disassembling the value and the hasCode generated from the disassembled value.

Specified by:

addToCacheKey in interface Bindable

Specified by:

addToCacheKey in interface JavaTypedExpressible

Parameters:

cacheKey - the MutableCacheKey used to add the disassembled value and the hashCode

value - the value to disassemble

session - the SharedSessionContractImplementor