org.hibernate.dialect.identity

Interface IdentityColumnSupport

All Known Implementing Classes:

AbstractTransactSQLIdentityColumnSupport, Chache71IdentityColumnSupport, CUBRIDIdentityColumnSupport, DB2390IdentityColumnSupport, DB2IdentityColumnSupport, H2IdentityColumnSupport, HANAIdentityColumnSupport, HSQLIdentityColumnSupport, IdentityColumnSupportImpl, InformixIdentityColumnSupport, Ingres10IdentityColumnSupport, Ingres9IdentityColumnSupport, JDataStoreIdentityColumnSupport, MimerSQLIdentityColumnSupport, MySQLIdentityColumnSupport, Oracle12cIdentityColumnSupport, PostgreSQL81IdentityColumnSupport, SQLServerIdentityColumnSupport, SybaseAnywhereIdentityColumnSupport, Teradata14IdentityColumnSupport

public interface IdentityColumnSupport

Represents a support for the Dialect identity key generation

Since:

5.1

Author:

Andrea Boriero

Method Summary

Modifier and Type	Method and Description
String	appendIdentitySelectToInsert(String insertString) Provided we supportsInsertSelectIdentity(), then attach the "select identity" clause to the insert statement.
GetGeneratedKeysDelegate	buildGetGeneratedKeysDelegate(PostInsertIdentityPersister persister, Dialect dialect) The Delegate for dealing with IDENTITY columns using JDBC3 getGeneratedKeys
String	getIdentityColumnString(int type) The syntax used during DDL to define a column as being an IDENTITY of a particular type.
String	getIdentityInsertString() The keyword used to insert a generated value into an identity column (or null).
String	getIdentitySelectString(String table, String column, int type) Get the select command to use to retrieve the last generated IDENTITY value for a particular table
boolean	hasDataTypeInIdentityColumn() Whether this dialect have an Identity clause added to the data type or a completely separate identity data type
boolean	supportsIdentityColumns() Does this dialect support identity column key generation?
boolean	supportsInsertSelectIdentity() Does the dialect support some form of inserting and selecting the generated IDENTITY value all in the same statement.

Method Detail

supportsIdentityColumns

boolean supportsIdentityColumns()

Does this dialect support identity column key generation?

Returns:

True if IDENTITY columns are supported; false otherwise.

supportsInsertSelectIdentity

boolean supportsInsertSelectIdentity()

Does the dialect support some form of inserting and selecting the generated IDENTITY value all in the same statement.

Returns:

True if the dialect supports selecting the just generated IDENTITY in the insert statement.

hasDataTypeInIdentityColumn

boolean hasDataTypeInIdentityColumn()

Whether this dialect have an Identity clause added to the data type or a completely separate identity data type

Returns:

boolean

appendIdentitySelectToInsert

String appendIdentitySelectToInsert(String insertString)

Provided we supportsInsertSelectIdentity(), then attach the "select identity" clause to the insert statement.

Note, if supportsInsertSelectIdentity() == false then the insert-string should be returned without modification.

Parameters:

insertString - The insert command

Returns:

The insert command with any necessary identity select clause attached.

getIdentitySelectString

String getIdentitySelectString(String table,
                               String column,
                               int type)
                        throws MappingException

Get the select command to use to retrieve the last generated IDENTITY value for a particular table

Parameters:

table - The table into which the insert was done

column - The PK column.

type - The Types type code.

Returns:

The appropriate select command

Throws:

MappingException - If IDENTITY generation is not supported.

getIdentityColumnString

String getIdentityColumnString(int type)
                        throws MappingException

The syntax used during DDL to define a column as being an IDENTITY of a particular type.

Parameters:

type - The Types type code.

Returns:

The appropriate DDL fragment.

Throws:

MappingException - If IDENTITY generation is not supported.

getIdentityInsertString

String getIdentityInsertString()

The keyword used to insert a generated value into an identity column (or null). Need if the dialect does not support inserts that specify no column values.

Returns:

The appropriate keyword.

buildGetGeneratedKeysDelegate

GetGeneratedKeysDelegate buildGetGeneratedKeysDelegate(PostInsertIdentityPersister persister,
                                                       Dialect dialect)

The Delegate for dealing with IDENTITY columns using JDBC3 getGeneratedKeys

Parameters:

persister - The persister

dialect - The dialect against which to generate the delegate

Returns:

the dialect specific GetGeneratedKeys delegate