- All Implemented Interfaces:
Dialect
- Direct Known Subclasses:
H214199Dialect
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classstatic classstatic classNested classes/interfaces inherited from class org.seasar.doma.jdbc.dialect.StandardDialect
StandardDialect.StandardCriteriaBuilder, StandardDialect.StandardExpressionFunctions, StandardDialect.StandardJdbcMappingVisitor, StandardDialect.StandardScriptBlockContext, StandardDialect.StandardSqlLogFormattingVisitor -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected static final intthe error code that represents unique violationFields inherited from class org.seasar.doma.jdbc.dialect.StandardDialect
CLOSE_QUOTE, expressionFunctions, jdbcMappingVisitor, OPEN_QUOTE, sqlLogFormattingVisitor, UNIQUE_CONSTRAINT_VIOLATION_STATE_CODES -
Constructor Summary
ConstructorsConstructorDescriptionH212126Dialect(ExpressionFunctions expressionFunctions) H212126Dialect(JdbcMappingVisitor jdbcMappingVisitor) H212126Dialect(JdbcMappingVisitor jdbcMappingVisitor, SqlLogFormattingVisitor sqlLogFormattingVisitor) H212126Dialect(JdbcMappingVisitor jdbcMappingVisitor, SqlLogFormattingVisitor sqlLogFormattingVisitor, ExpressionFunctions expressionFunctions) H212126Dialect(SqlLogFormattingVisitor sqlLogFormattingVisitor) -
Method Summary
Modifier and TypeMethodDescriptiongetIdentitySelectSql(String catalogName, String schemaName, String tableName, String columnName, boolean isQuoteRequired, boolean isIdColumnQuoteRequired) Returns an SQL object to retrieve IDENTITY values that were generated during an insert operation.getName()Returns the name of this dialect.getSequenceNextValSql(String qualifiedSequenceName, long allocationSize) Returns an SQL object to retrieve the next value from a database sequence.booleanDetermines whether this dialect includes IDENTITY columns in SQL INSERT statements.booleanisUniqueConstraintViolated(SQLException sqlException) Determines whether the given SQLException represents a unique constraint violation.booleanDetermines whether this dialect supports retrieving auto-generated keys viaStatement.getGeneratedKeys().booleanDetermines whether this dialect supports the IDENTITY column.booleansupportsSelectForUpdate(SelectForUpdateType type, boolean withTargets) Determines whether this dialect supports pessimistic locking with the specified options.booleanDetermines whether this dialect supports database sequences.protected SqlNodetoForUpdateSqlNode(SqlNode sqlNode, SelectForUpdateType forUpdateType, int waitSeconds, String... aliases) protected SqlNodetoPagingSqlNode(SqlNode sqlNode, long offset, long limit) Methods inherited from class org.seasar.doma.jdbc.dialect.StandardDialect
applyQuote, createScriptBlockContext, getAutoGeneratedKeysType, getCauseSQLException, getCriteriaBuilder, getDeleteAssembler, getErrorCode, getExpressionFunctions, getIdentityReservationSql, getInsertAssembler, getJdbcMappingVisitor, getMultiInsertAssembler, getResultSetType, getRootCause, getScriptBlockDelimiter, getSqlLogFormattingVisitor, getSQLState, getUpdateAssembler, getUpsertAssembler, removeQuote, supportsBatchUpdateResults, supportsIdentityReservation, supportsResultSetReturningAsOutParameter, toCountCalculatingSqlNode, toCountGettingSqlNode, transformSelectSqlNode, transformSelectSqlNodeForGettingCountMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.seasar.doma.jdbc.dialect.Dialect
includesIdentityColumn, supportsAliasInDeleteClause, supportsAliasInDeleteStatement, supportsAliasInUpdateClause, supportsAliasInUpdateStatement, supportsAutoIncrementWhenInsertingMultipleRows, supportsBatchExecutionReturningGeneratedValues, supportsModOperator, supportsMultiRowInsertStatement, supportsParenthesesForSetOperands, supportsReturning, supportsUpsertEmulationWithMergeStatement
-
Field Details
-
UNIQUE_CONSTRAINT_VIOLATION_ERROR_CODE
protected static final int UNIQUE_CONSTRAINT_VIOLATION_ERROR_CODEthe error code that represents unique violation- See Also:
-
-
Constructor Details
-
H212126Dialect
public H212126Dialect() -
H212126Dialect
-
H212126Dialect
-
H212126Dialect
-
H212126Dialect
public H212126Dialect(JdbcMappingVisitor jdbcMappingVisitor, SqlLogFormattingVisitor sqlLogFormattingVisitor) -
H212126Dialect
public H212126Dialect(JdbcMappingVisitor jdbcMappingVisitor, SqlLogFormattingVisitor sqlLogFormattingVisitor, ExpressionFunctions expressionFunctions)
-
-
Method Details
-
getName
Description copied from interface:DialectReturns the name of this dialect.The dialect name typically identifies the database system that this dialect supports. This name can be used for logging, debugging, or to make decisions based on the specific database being used.
Each dialect implementation should return a unique and descriptive name.
- Specified by:
getNamein interfaceDialect- Overrides:
getNamein classStandardDialect- Returns:
- the name of this dialect
-
includesIdentityColumn
public boolean includesIdentityColumn()Description copied from interface:DialectDetermines whether this dialect includes IDENTITY columns in SQL INSERT statements.Some database systems require that IDENTITY columns be excluded from INSERT statements, while others allow or require them to be included.
- Specified by:
includesIdentityColumnin interfaceDialect- Overrides:
includesIdentityColumnin classStandardDialect- Returns:
trueif this dialect includes IDENTITY columns in INSERT statements,falseotherwise
-
getIdentitySelectSql
public PreparedSql getIdentitySelectSql(String catalogName, String schemaName, String tableName, String columnName, boolean isQuoteRequired, boolean isIdColumnQuoteRequired) Description copied from interface:DialectReturns an SQL object to retrieve IDENTITY values that were generated during an insert operation.This method is used to create the SQL statement that retrieves the last generated identity value for a specific table and column.
This method is available only if
Dialect.supportsIdentity()returnstrue.- Specified by:
getIdentitySelectSqlin interfaceDialect- Overrides:
getIdentitySelectSqlin classStandardDialect- Parameters:
catalogName- the catalog name of the table (may benullif not applicable)schemaName- the schema name of the table (may benullif not applicable)tableName- the name of the table containing the identity columncolumnName- the name of the identity columnisQuoteRequired- whether the table name should be quoted in the SQL statementisIdColumnQuoteRequired- whether the identity column name should be quoted in the SQL statement- Returns:
- the SQL object that can be executed to retrieve the generated identity value
-
getSequenceNextValSql
Description copied from interface:DialectReturns an SQL object to retrieve the next value from a database sequence.This method creates the SQL statement needed to get the next value from a sequence.
The allocation size parameter can be used to optimize sequence access by retrieving multiple values at once in database systems that support this feature.
This method is available only if
Dialect.supportsSequence()returnstrue.- Specified by:
getSequenceNextValSqlin interfaceDialect- Overrides:
getSequenceNextValSqlin classStandardDialect- Parameters:
qualifiedSequenceName- the fully qualified name of the sequence, which may include catalog and schema information depending on the database systemallocationSize- the number of sequence values to allocate at once for optimization; a value greater than 1 may improve performance by reducing database calls- Returns:
- the SQL object that can be executed to retrieve the next sequence value(s)
-
isUniqueConstraintViolated
Description copied from interface:DialectDetermines whether the given SQLException represents a unique constraint violation.Different database systems use different error codes and states to indicate unique constraint violations. This method abstracts these differences.
- Specified by:
isUniqueConstraintViolatedin interfaceDialect- Overrides:
isUniqueConstraintViolatedin classStandardDialect- Parameters:
sqlException- the SQL exception to analyze- Returns:
trueif the exception represents a unique constraint violation,falseotherwise
-
toPagingSqlNode
- Overrides:
toPagingSqlNodein classStandardDialect
-
toForUpdateSqlNode
protected SqlNode toForUpdateSqlNode(SqlNode sqlNode, SelectForUpdateType forUpdateType, int waitSeconds, String... aliases) - Overrides:
toForUpdateSqlNodein classStandardDialect
-
supportsIdentity
public boolean supportsIdentity()Description copied from interface:DialectDetermines whether this dialect supports the IDENTITY column.An IDENTITY column is a column that automatically generates a unique value for each row when data is inserted. The exact implementation varies by database system.
- Specified by:
supportsIdentityin interfaceDialect- Overrides:
supportsIdentityin classStandardDialect- Returns:
trueif this dialect supports IDENTITY columns,falseotherwise
-
supportsSequence
public boolean supportsSequence()Description copied from interface:DialectDetermines whether this dialect supports database sequences.A sequence is a database object that generates a sequence of unique numbers. Sequences are commonly used to generate primary key values.
- Specified by:
supportsSequencein interfaceDialect- Overrides:
supportsSequencein classStandardDialect- Returns:
trueif this dialect supports sequences,falseotherwise
-
supportsAutoGeneratedKeys
public boolean supportsAutoGeneratedKeys()Description copied from interface:DialectDetermines whether this dialect supports retrieving auto-generated keys viaStatement.getGeneratedKeys().This feature allows retrieving values that were automatically generated during an insert operation, such as identity column values, without executing a separate query.
- Specified by:
supportsAutoGeneratedKeysin interfaceDialect- Overrides:
supportsAutoGeneratedKeysin classStandardDialect- Returns:
trueif this dialect supports retrieving auto-generated keys,falseotherwise
-
supportsSelectForUpdate
Description copied from interface:DialectDetermines whether this dialect supports pessimistic locking with the specified options.Pessimistic locking (SELECT FOR UPDATE) prevents other transactions from modifying selected rows. Different database systems support different variations of this feature.
- Specified by:
supportsSelectForUpdatein interfaceDialect- Overrides:
supportsSelectForUpdatein classStandardDialect- Parameters:
type- the type of pessimistic locking (e.g., standard FOR UPDATE, NOWAIT, WAIT)withTargets-trueif specific columns are targeted for locking,falsefor row-level locking- Returns:
trueif this dialect supports the specified locking options,falseotherwise
-