Hibernate ORM - hibernate-core 6.4.4.Final · org.hibernate.id.insert.InsertGeneratedIdentifierDelegate

Each implementation defines a strategy for retrieving a primary key generated by the database from the database after execution of an insert statement. The generated primary key is usually an IDENTITY column, but in principle it might be something else, for example, a value generated by a trigger.

An implementation controls:

building the SQL insert statement, and
retrieving the generated identifier value using JDBC.

The implementation should be written to handle any instance of org.hibernate.generator.OnExecutionGenerator.

Method Summary

Modifier and Type	Method and Description
public TableInsertBuilder	createTableInsertBuilder(BasicEntityIdentifierMapping identifierMapping, Expectation expectation, SessionFactoryImplementor sessionFactory) Deprecated as a consequence of `SessionFactoryImplementor` being deprecated. Create a `TableInsertBuilder` with any specific identity handling already built in.
public Object	performInsert(PreparedStatementDetails insertStatementDetails, JdbcValueBindings valueBindings, Object entity, SharedSessionContractImplementor session) Perform the `insert` and extract the database-generated primary key value.
public Object	Returns: The generated identifier value performInsert(String The `insert` statement string insertSQL, SharedSessionContractImplementor The session in which we are operating session, Binder The parameter binder binder) Execute the given `insert` statement and return the generated key value.
public IdentifierGeneratingInsert	Returns: An `IdentifierGeneratingInsert` prepareIdentifierGeneratingInsert(SqlStringGenerationContext A context to help generate SQL strings context) Deprecated since 6.2. this is no longer called Build an insert statement specific to the delegate's mode of handling generated key values.
public default String	Returns: The processed `insert` statement string prepareIdentifierGeneratingInsert(String insertSQL) Append SQL specific to this delegate's mode of handling generated primary key values to the given `insert` statement.
public PreparedStatement	prepareStatement(String insertSql, SharedSessionContractImplementor session)

Method Detail

createTableInsertBuilder	back to summary
public TableInsertBuilder createTableInsertBuilder(BasicEntityIdentifierMapping identifierMapping, Expectation expectation, SessionFactoryImplementor sessionFactory) Deprecated as a consequence of `SessionFactoryImplementor` being deprecated. See corresponding docs for further information. Create a `TableInsertBuilder` with any specific identity handling already built in.

performInsert back to summary

performInsert	back to summary
public Object performInsert(PreparedStatementDetails insertStatementDetails, JdbcValueBindings valueBindings, Object entity, SharedSessionContractImplementor session) Perform the `insert` and extract the database-generated primary key value. See Also `createTableInsertBuilder`

public Object performInsert(PreparedStatementDetails insertStatementDetails, JdbcValueBindings valueBindings, Object entity, SharedSessionContractImplementor session)

Perform the insert and extract the database-generated primary key value.

See Also: createTableInsertBuilder

performInsert back to summary

performInsert	back to summary
public Object performInsert(String insertSQL, SharedSessionContractImplementor session, Binder binder) Execute the given `insert` statement and return the generated key value. Parameters insertSQL:String The `insert` statement string session:SharedSessionContractImplementor The session in which we are operating binder:Binder The parameter binder Returns:Object The generated identifier value

public Object performInsert(String insertSQL, SharedSessionContractImplementor session, Binder binder)

Execute the given insert statement and return the generated key value.

Parameters

insertSQL:String: The insert statement string
session:SharedSessionContractImplementor: The session in which we are operating
binder:Binder: The parameter binder

Returns:Object

The generated identifier value

prepareIdentifierGeneratingInsert back to summary

prepareIdentifierGeneratingInsert	back to summary
public IdentifierGeneratingInsert prepareIdentifierGeneratingInsert(SqlStringGenerationContext context) Deprecated since 6.2. this is no longer called Build an insert statement specific to the delegate's mode of handling generated key values. Parameters context:SqlStringGenerationContext A context to help generate SQL strings Returns:IdentifierGeneratingInsert An `IdentifierGeneratingInsert` Annotations @Deprecated since:6.2

public IdentifierGeneratingInsert prepareIdentifierGeneratingInsert(SqlStringGenerationContext context)

Deprecated

since 6.2.

this is no longer called

Build an insert statement specific to the delegate's mode of handling generated key values.

Parameters

context:SqlStringGenerationContext: A context to help generate SQL strings

Returns:IdentifierGeneratingInsert

An IdentifierGeneratingInsert

Annotations

@Deprecated
since:6.2

prepareIdentifierGeneratingInsert back to summary

prepareIdentifierGeneratingInsert	back to summary
public default String prepareIdentifierGeneratingInsert(String insertSQL) Append SQL specific to this delegate's mode of handling generated primary key values to the given `insert` statement. Returns:String The processed `insert` statement string

public default String prepareIdentifierGeneratingInsert(String insertSQL)

Append SQL specific to this delegate's mode of handling generated primary key values to the given insert statement.

Returns:String: The processed insert statement string

prepareStatement	back to summary
public PreparedStatement prepareStatement(String insertSql, SharedSessionContractImplementor session)

public Interface InsertGeneratedIdentifierDelegate

Method Summary

Method Detail