Package org.hibernate.metamodel.mapping

Interface Bindable

All Superinterfaces:

JdbcMappingContainer

All Known Subinterfaces:

AdjustableBasicType<J>, AggregatedIdentifierMapping, Association, AttributeMapping, BasicEntityIdentifierMapping, BasicPluralType<C,E>, BasicType<T>, BasicValuedMapping, BasicValuedModelPart, CollectionIdentifierDescriptor, CollectionPart, CompositeIdentifierMapping, ConvertedBasicType<J>, DatabaseSnapshotContributor, DeprecatedEntityStuff, DiscriminatedAssociationModelPart, DiscriminatorMapping, DiscriminatorType<O>, EmbeddableDiscriminatorMapping, EmbeddableMappingType, EmbeddableValuedFetchable, EmbeddableValuedModelPart, EntityAssociationMapping, EntityCollectionPart, EntityDiscriminatorMapping, EntityIdentifierMapping, EntityMappingType, EntityPersister, EntityRowIdMapping, EntityValuedFetchable, EntityValuedModelPart, EntityVersionMapping, Fetchable, FetchableContainer, ForeignKeyDescriptor, InFlightEntityMappingType, Loadable, Loadable, Lockable, ManagedMappingType, MappingModelExpressible<T>, ModelPart, ModelPartContainer, NaturalIdMapping, NonAggregatedIdentifierMapping, NonAggregatedIdentifierMapping.IdentifierValueMapper, OuterJoinLoadable, OwnedValuedModelPart, PluralAttributeMapping, PostInsertIdentityPersister, Queryable, RootTableGroupProducer, SingleAttributeIdentifierMapping, SingularAttributeMapping, SoftDeletableModelPart, SoftDeleteMapping, SQLLoadable, TableGroupJoinProducer, TableGroupProducer, UniqueKeyLoadable, ValuedModelPart, ValueMapping, VirtualModelPart

All Known Implementing Classes:

AbstractAttributeMapping, AbstractCompositeIdentifierMapping, AbstractDiscriminatorMapping, AbstractEmbeddableMapping, AbstractEntityCollectionPart, AbstractEntityPersister, AbstractJdbcParameter, AbstractNaturalIdMapping, AbstractSingleColumnStandardBasicType, AbstractSingularAttributeMapping, AbstractStandardBasicType, AbstractStateArrayContributorMapping, AnonymousTupleBasicEntityIdentifierMapping, AnonymousTupleBasicValuedModelPart, AnonymousTupleEmbeddableValuedModelPart, AnonymousTupleEmbeddedEntityIdentifierMapping, AnonymousTupleEntityValuedModelPart, AnonymousTupleNonAggregatedEntityIdentifierMapping, AnonymousTupleTableGroupProducer, AnyDiscriminatorPart, AnyKeyPart, ArrayTupleType, BasicArrayType, BasicAttributeMapping, BasicCollectionType, BasicEntityIdentifierMappingImpl, BasicTypeImpl, BasicValuedCollectionPart, BottomType, CaseStatementDiscriminatorMappingImpl, CollectionIdentifierDescriptorImpl, ColumnValueParameter, CompoundNaturalIdMapping, ConvertedBasicArrayType, ConvertedBasicCollectionType, ConvertedBasicTypeImpl, CteTupleTableGroupProducer, CustomMutabilityConvertedBasicTypeImpl, CustomMutabilityConvertedPrimitiveBasicTypeImpl, CustomType, DiscriminatedAssociationAttributeMapping, DiscriminatedCollectionPart, DiscriminatorType, DiscriminatorTypeImpl, EmbeddableMappingTypeImpl, EmbeddableTypeLiteral, EmbeddedAttributeMapping, EmbeddedCollectionPart, EmbeddedForeignKeyDescriptor, EmbeddedIdentifierMappingImpl, EntityRowIdMappingImpl, EntityTypeLiteral, EntityVersionMappingImpl, ExplicitColumnDiscriminatorMappingImpl, IdClassEmbeddable, ImmutableNamedBasicTypeImpl, InverseNonAggregatedIdentifierMapping, JavaObjectType, JdbcLiteral, JdbcParameterImpl, JoinedSubclassEntityPersister, ManyToManyCollectionPart, MockEntityPersister, NamedBasicTypeImpl, NonAggregatedIdentifierMappingImpl, NullType, OneToManyCollectionPart, PluralAttributeMappingImpl, ProcessorSessionFactory.EntityPersister, QueryParameterJavaObjectType, SerializableToBlobType, SerializableType, SimpleForeignKeyDescriptor, SimpleNaturalIdMapping, SingleTableEntityPersister, SoftDeleteMappingImpl, SqlTypedMappingJdbcParameter, StandardBasicTypeTemplate, ToOneAttributeMapping, TupleMappingModelExpressible, UnionSubclassEntityPersister, VersionTypeSeedParameterSpecification, VirtualEmbeddedAttributeMapping, VirtualIdEmbeddable

@Incubating
public interface Bindable
extends JdbcMappingContainer

Contract for things at the domain mapping level that can be bound into a JDBC PreparedStatement.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	Bindable.JdbcValuesBiConsumer<X,Y>	Functional interface for consuming the JDBC values, along with two values of type X and Y.
static interface	Bindable.JdbcValuesConsumer	Functional interface for consuming the JDBC values.

Method Summary

Modifier and Type	Method	Description
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.
Object	disassemble(Object value, SharedSessionContractImplementor session)	Breaks down a value of J into its simple pieces.
default int	forEachDisassembledJdbcValue(Object value, int offset, Bindable.JdbcValuesConsumer valuesConsumer, SharedSessionContractImplementor session)	A short hand form of forEachDisassembledJdbcValue(Object, int, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), that passes null for the two values X and Y .
<X,Y> int	forEachDisassembledJdbcValue(Object value, int offset, X x, Y y, Bindable.JdbcValuesBiConsumer<X,Y> valuesConsumer, SharedSessionContractImplementor session)	Like forEachDisassembledJdbcValue(Object, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), but additionally receives an offset by which the selectionIndex is incremented when calling Bindable.JdbcValuesBiConsumer.consume(int, Object, Object, Object, JdbcMapping).
default int	forEachDisassembledJdbcValue(Object value, Bindable.JdbcValuesConsumer valuesConsumer, SharedSessionContractImplementor session)	A short hand form of forEachDisassembledJdbcValue(Object, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), that passes null for the two values X and Y.
default <X,Y> int	forEachDisassembledJdbcValue(Object value, X x, Y y, Bindable.JdbcValuesBiConsumer<X,Y> valuesConsumer, SharedSessionContractImplementor session)	Visit each constituent JDBC value over the result from disassemble(java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor).
default int	forEachJdbcType(IndexedConsumer<JdbcMapping> action)	Visit each of JdbcMapping
default int	forEachJdbcValue(Object value, int offset, Bindable.JdbcValuesConsumer valuesConsumer, SharedSessionContractImplementor session)	A short hand form of forEachJdbcValue(Object, int, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), that passes null for the two values X and Y.
default <X,Y> int	forEachJdbcValue(Object value, int offset, X x, Y y, Bindable.JdbcValuesBiConsumer<X,Y> valuesConsumer, SharedSessionContractImplementor session)	Visit each constituent JDBC value extracted from the entity instance itself.
default int	forEachJdbcValue(Object value, Bindable.JdbcValuesConsumer valuesConsumer, SharedSessionContractImplementor session)	A short hand form of forEachJdbcValue(Object, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), that passes null for the two values X and Y.
default <X,Y> int	forEachJdbcValue(Object value, X x, Y y, Bindable.JdbcValuesBiConsumer<X,Y> valuesConsumer, SharedSessionContractImplementor session)	Visit each constituent JDBC value extracted from the entity instance itself.
default int	getJdbcTypeCount()	The number of JDBC mappings

Methods inherited from interface org.hibernate.metamodel.mapping.JdbcMappingContainer

forEachJdbcType, getJdbcMapping, getSingleJdbcMapping

Method Detail

getJdbcTypeCount

default int getJdbcTypeCount()

The number of JDBC mappings

Specified by:

getJdbcTypeCount in interface JdbcMappingContainer

forEachJdbcType

default int forEachJdbcType(IndexedConsumer<JdbcMapping> action)

Visit each of JdbcMapping

Specified by:

forEachJdbcType in interface JdbcMappingContainer

API Note:

Same as JdbcMappingContainer.forEachJdbcType(int, IndexedConsumer) starting from `0`

disassemble

Object disassemble(Object value,
                   SharedSessionContractImplementor session)

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.

See Also:

EntityEntry

addToCacheKey

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.

Parameters:

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

value - the value to disassemble

session - the SharedSessionContractImplementor

forEachDisassembledJdbcValue

default <X,Y> int forEachDisassembledJdbcValue(Object value,
                                                     X x,
                                                     Y y,
                                                     Bindable.JdbcValuesBiConsumer<X,Y> valuesConsumer,
                                                     SharedSessionContractImplementor session)

Visit each constituent JDBC value over the result from disassemble(java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor).

Given the example in disassemble(java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor), this results in the consumer being called for each simple value. E.g.:

 consumer.consume( "Steve" );
 consumer.consume( "Ebersole" );
 consumer.consume( 28 );
 

Think of it as breaking the multidimensional array into a visitable flat array. Additionally, it passes through the values X and Y to the consumer.

forEachDisassembledJdbcValue

<X,Y> int forEachDisassembledJdbcValue(Object value,
                                             int offset,
                                             X x,
                                             Y y,
                                             Bindable.JdbcValuesBiConsumer<X,Y> valuesConsumer,
                                             SharedSessionContractImplementor session)

Like forEachDisassembledJdbcValue(Object, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), but additionally receives an offset by which the selectionIndex is incremented when calling Bindable.JdbcValuesBiConsumer.consume(int, Object, Object, Object, JdbcMapping).

forEachDisassembledJdbcValue

default int forEachDisassembledJdbcValue(Object value,
                                         Bindable.JdbcValuesConsumer valuesConsumer,
                                         SharedSessionContractImplementor session)

A short hand form of forEachDisassembledJdbcValue(Object, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), that passes null for the two values X and Y.

forEachDisassembledJdbcValue

default int forEachDisassembledJdbcValue(Object value,
                                         int offset,
                                         Bindable.JdbcValuesConsumer valuesConsumer,
                                         SharedSessionContractImplementor session)

A short hand form of forEachDisassembledJdbcValue(Object, int, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), that passes null for the two values X and Y .

forEachJdbcValue

default <X,Y> int forEachJdbcValue(Object value,
                                         X x,
                                         Y y,
                                         Bindable.JdbcValuesBiConsumer<X,Y> valuesConsumer,
                                         SharedSessionContractImplementor session)

Visit each constituent JDBC value extracted from the entity instance itself. Short-hand form of calling disassemble(java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor) and piping its result to forEachDisassembledJdbcValue(Object, JdbcValuesConsumer, SharedSessionContractImplementor)

forEachJdbcValue

default <X,Y> int forEachJdbcValue(Object value,
                                         int offset,
                                         X x,
                                         Y y,
                                         Bindable.JdbcValuesBiConsumer<X,Y> valuesConsumer,
                                         SharedSessionContractImplementor session)

Visit each constituent JDBC value extracted from the entity instance itself. Short-hand form of calling disassemble(java.lang.Object, org.hibernate.engine.spi.SharedSessionContractImplementor) and piping its result to forEachDisassembledJdbcValue(Object, int, JdbcValuesConsumer, SharedSessionContractImplementor)

forEachJdbcValue

default int forEachJdbcValue(Object value,
                             Bindable.JdbcValuesConsumer valuesConsumer,
                             SharedSessionContractImplementor session)

A short hand form of forEachJdbcValue(Object, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), that passes null for the two values X and Y.

forEachJdbcValue

default int forEachJdbcValue(Object value,
                             int offset,
                             Bindable.JdbcValuesConsumer valuesConsumer,
                             SharedSessionContractImplementor session)

A short hand form of forEachJdbcValue(Object, int, Object, Object, JdbcValuesBiConsumer, SharedSessionContractImplementor), that passes null for the two values X and Y.