Package org.hibernate.query.sqm.mutation.spi

Interface SqmMultiTableMutationStrategy

public interface SqmMultiTableMutationStrategy

Pluggable strategy for defining how mutation (UPDATE or DELETE) queries should be handled when the target entity is mapped to multiple tables via secondary tables or certain inheritance strategies.

The main contracts here are executeUpdate(org.hibernate.query.sqm.tree.update.SqmUpdateStatement<?>, org.hibernate.query.sqm.internal.DomainParameterXref, org.hibernate.query.spi.DomainQueryExecutionContext) and executeDelete(org.hibernate.query.sqm.tree.delete.SqmDeleteStatement<?>, org.hibernate.query.sqm.internal.DomainParameterXref, org.hibernate.query.spi.DomainQueryExecutionContext).

The methods prepare(org.hibernate.metamodel.mapping.internal.MappingModelCreationProcess, org.hibernate.engine.jdbc.connections.spi.JdbcConnectionAccess) and release(org.hibernate.engine.spi.SessionFactoryImplementor, org.hibernate.engine.jdbc.connections.spi.JdbcConnectionAccess) allow the strategy to perform any one time preparation and cleanup.

API Note:

See SqmMutationStrategyHelper#resolveStrategy for standard resolution of the strategy to use for each hierarchy.

Method Summary

Modifier and Type	Method	Description
int	executeDelete(SqmDeleteStatement<?> sqmDeleteStatement, org.hibernate.query.sqm.internal.DomainParameterXref domainParameterXref, DomainQueryExecutionContext context)	Execute the multi-table update indicated by the passed SqmUpdateStatement
int	executeUpdate(SqmUpdateStatement<?> sqmUpdateStatement, org.hibernate.query.sqm.internal.DomainParameterXref domainParameterXref, DomainQueryExecutionContext context)	Execute the multi-table update indicated by the passed SqmUpdateStatement
default void	prepare(org.hibernate.metamodel.mapping.internal.MappingModelCreationProcess mappingModelCreationProcess, JdbcConnectionAccess connectionAccess)	Prepare the strategy for use.
default void	release(SessionFactoryImplementor sessionFactory, JdbcConnectionAccess connectionAccess)	Release the strategy.

Method Detail

prepare

default void prepare(org.hibernate.metamodel.mapping.internal.MappingModelCreationProcess mappingModelCreationProcess,
                     JdbcConnectionAccess connectionAccess)

Prepare the strategy for use. Called one time as the SessionFactory is being built.

release

default void release(SessionFactoryImplementor sessionFactory,
                     JdbcConnectionAccess connectionAccess)

Release the strategy. Called one time as the SessionFactory is being shut down.

executeUpdate

int executeUpdate(SqmUpdateStatement<?> sqmUpdateStatement,
                  org.hibernate.query.sqm.internal.DomainParameterXref domainParameterXref,
                  DomainQueryExecutionContext context)

Execute the multi-table update indicated by the passed SqmUpdateStatement

Returns:

The number of rows affected

executeDelete

int executeDelete(SqmDeleteStatement<?> sqmDeleteStatement,
                  org.hibernate.query.sqm.internal.DomainParameterXref domainParameterXref,
                  DomainQueryExecutionContext context)

Execute the multi-table update indicated by the passed SqmUpdateStatement

Returns:

The number of rows affected