Package org.hibernate.query.results

Interface ResultSetMapping

All Superinterfaces:

JdbcValuesMappingProducer

@Incubating
public interface ResultSetMapping
extends JdbcValuesMappingProducer

JdbcValuesMappingProducer implementation based on a graph of ResultBuilder and FetchBuilder reference. Used to model result-set mappings from:

• SqlResultSetMapping
• orm.xml
• mapping.xml
• hbm.xml
• Hibernate-specific APIs:
  • NativeQuery.addScalar(java.lang.String)
  • NativeQuery.addEntity(java.lang.String)
  • NativeQuery.addJoin(java.lang.String, java.lang.String)
  • NativeQuery.addFetch(java.lang.String, java.lang.String, java.lang.String)
  • NativeQuery.addRoot(java.lang.String, java.lang.String)

See Also:

• NativeQuery
• ProcedureCall
• StoredProcedureQuery

Method Summary

Modifier and Type	Method	Description
void	addLegacyFetchBuilder(LegacyFetchBuilder fetchBuilder)	Add a legacy fetch builder
void	addResultBuilder(ResultBuilder resultBuilder)	Add a builder
ResultSetMapping	cacheKeyInstance()
String	getMappingIdentifier()	An identifier for the mapping
int	getNumberOfResultBuilders()	The number of result builders currently associated with this mapping
List<ResultBuilder>	getResultBuilders()	The result builders currently associated with this mapping
boolean	isDynamic()	Indicates whether the mapping is dynamic per ResultSetMapping
static ResultSetMapping	resolveResultSetMapping(String name, boolean isDynamic, SessionFactoryImplementor sessionFactory)
static ResultSetMapping	resolveResultSetMapping(String name, SessionFactoryImplementor sessionFactory)
NamedResultSetMappingMemento	toMemento(String name)	Create a memento from this mapping.
void	visitLegacyFetchBuilders(Consumer<LegacyFetchBuilder> resultBuilderConsumer)	Visit the "legacy" fetch builders.
void	visitResultBuilders(BiConsumer<Integer,ResultBuilder> resultBuilderConsumer)	Visit each result builder

Methods inherited from interface org.hibernate.sql.results.jdbc.spi.JdbcValuesMappingProducer

addAffectedTableNames, resolve

Method Details

getMappingIdentifier

String getMappingIdentifier()

An identifier for the mapping

isDynamic

boolean isDynamic()

Indicates whether the mapping is dynamic per ResultSetMapping

getNumberOfResultBuilders

int getNumberOfResultBuilders()

The number of result builders currently associated with this mapping

getResultBuilders

List<ResultBuilder> getResultBuilders()

The result builders currently associated with this mapping

visitResultBuilders

void visitResultBuilders(BiConsumer<Integer,ResultBuilder> resultBuilderConsumer)

Visit each result builder

visitLegacyFetchBuilders

void visitLegacyFetchBuilders(Consumer<LegacyFetchBuilder> resultBuilderConsumer)

Visit the "legacy" fetch builders.

Historically these mappings in Hibernate were defined such that results and fetches are unaware of each other. So while ResultBuilder encapsulates the fetches (see ResultBuilder.visitFetchBuilders(java.util.function.BiConsumer<org.hibernate.sql.results.graph.Fetchable, org.hibernate.query.results.FetchBuilder>)), fetches defined in the legacy way are unassociated to their "parent".

addResultBuilder

void addResultBuilder(ResultBuilder resultBuilder)

Add a builder

addLegacyFetchBuilder

void addLegacyFetchBuilder(LegacyFetchBuilder fetchBuilder)

Add a legacy fetch builder

toMemento

NamedResultSetMappingMemento toMemento(String name)

Create a memento from this mapping.

resolveResultSetMapping

static ResultSetMapping resolveResultSetMapping(String name,
 SessionFactoryImplementor sessionFactory)

resolveResultSetMapping

static ResultSetMapping resolveResultSetMapping(String name,
 boolean isDynamic,
 SessionFactoryImplementor sessionFactory)

cacheKeyInstance

ResultSetMapping cacheKeyInstance()

Specified by:

cacheKeyInstance in interface JdbcValuesMappingProducer