java.lang.Object | ||
↳ | org.hibernate.dialect.Dialect | |
↳ | org.hibernate.dialect.Oracle8iDialect |
Known Direct Subclasses |
Known Indirect Subclasses |
A dialect for Oracle 8i.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | DEPRECATED_ORACLE_TYPES_CLASS_NAME | ||||||||||
int | INIT_ORACLETYPES_CURSOR_VALUE | ||||||||||
String | ORACLE_TYPES_CLASS_NAME |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.hibernate.dialect.Dialect
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
ANSI SQL defines the LIMIT clause to be in the form LIMIT offset, limit.
| |||||||||||
Map case support to the Oracle DECODE function.
| |||||||||||
Support for the oracle proprietary join syntax...
| |||||||||||
Do we need to drop constraints before dropping tables in this dialect?
| |||||||||||
Do we need to drop the temporary table after use?
| |||||||||||
Is FOR UPDATE OF syntax supported?
| |||||||||||
Generate a temporary table name given the base table.
| |||||||||||
The syntax used to add a column to a table (optional).
| |||||||||||
Allows access to the basic
getSelectClauseNullString(int)
implementation... | |||||||||||
Completely optional cascading drop clause
| |||||||||||
Typically dialects which support sequences can create a sequence
with a single command.
| |||||||||||
Get any fragments needing to be postfixed to the command for
temporary table creation.
| |||||||||||
Command used to create a temporary table.
| |||||||||||
Get the separator to use for defining cross joins when translating HQL queries.
| |||||||||||
The name of the database-specific SQL function for retrieving the
current timestamp.
| |||||||||||
Retrieve the command used to retrieve the current timestamp from the
database.
| |||||||||||
Typically dialects which support sequences can drop a sequence
with a single command.
| |||||||||||
Retrieves the FOR UPDATE NOWAIT syntax specific to this dialect.
| |||||||||||
Get the FOR UPDATE OF column_list NOWAIT fragment appropriate
for this dialect given the aliases of the columns to be write locked.
| |||||||||||
Get the FOR UPDATE OF column_list fragment appropriate for this
dialect given the aliases of the columns to be write locked.
| |||||||||||
Apply s limit clause to the query.
| |||||||||||
Get the select command used retrieve the names of all sequences.
| |||||||||||
Given a callable statement previously processed by
registerResultSetOutParameter(CallableStatement, int) ,
extract the ResultSet from the OUT parameter. | |||||||||||
Given a java.sql.Types type code, determine an appropriate
null value to use in a select clause.
| |||||||||||
Get the command used to select a GUID from the underlying database.
| |||||||||||
Generate the select expression fragment that will retrieve the next
value of a sequence as part of another (typically DML) statement.
| |||||||||||
Generate the appropriate select statement to to retrieve the next value
of a sequence.
| |||||||||||
Should the value returned by
getCurrentTimestampSelectString()
be treated as callable. | |||||||||||
Registers an OUT parameter which will be returning a
ResultSet . | |||||||||||
Does this dialect support a way to retrieve the database's current
timestamp value?
| |||||||||||
Does this dialect support empty IN lists?
For example, is [where XYZ in ()] a supported construct?
| |||||||||||
Does the dialect support an exists statement in the select clause?
| |||||||||||
Does this dialect support some form of limiting query results
via a SQL clause?
| |||||||||||
Does this dialect support "pooled" sequences.
| |||||||||||
Does this dialect support sequences?
| |||||||||||
Does this dialect support temporary tables?
| |||||||||||
Does this dialect support UNION ALL, which is generally a faster
variant of UNION?
| |||||||||||
Does the LIMIT clause take a "maximum" row number instead
of a total number of returned rows?
This is easiest understood via an example.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.hibernate.dialect.Dialect
| |||||||||||
From class
java.lang.Object
|
ANSI SQL defines the LIMIT clause to be in the form LIMIT offset, limit. Does this dialect require us to bind the parameters in reverse order?
Map case support to the Oracle DECODE function. Oracle did not add support for CASE until 9i.
Support for the oracle proprietary join syntax...
Do we need to drop constraints before dropping tables in this dialect?
Do we need to drop the temporary table after use?
Is FOR UPDATE OF syntax supported?
Generate a temporary table name given the base table.
baseTableName | The table name from which to base the temp table name. |
---|
The syntax used to add a column to a table (optional).
Allows access to the basic getSelectClauseNullString(int)
implementation...
sqlType | The java.sql.Types mapping type code |
---|
Completely optional cascading drop clause
Typically dialects which support sequences can create a sequence
with a single command. This is convenience form of
getCreateSequenceStrings(String)
to help facilitate that.
getCreateSequenceStrings(String)
.sequenceName | The name of the sequence |
---|
Get any fragments needing to be postfixed to the command for temporary table creation.
Command used to create a temporary table.
Get the separator to use for defining cross joins when translating HQL queries.
Typically this will be either [ cross join ] or [, ] Note that the spaces are important!The name of the database-specific SQL function for retrieving the current timestamp.
Retrieve the command used to retrieve the current timestamp from the database.
Typically dialects which support sequences can drop a sequence
with a single command. This is convenience form of
getDropSequenceStrings(String)
to help facilitate that.
getDropSequenceStrings(String)
.sequenceName | The name of the sequence |
---|
Retrieves the FOR UPDATE NOWAIT syntax specific to this dialect.
Get the FOR UPDATE OF column_list NOWAIT fragment appropriate for this dialect given the aliases of the columns to be write locked.
aliases | The columns to be write locked. |
---|
Get the FOR UPDATE OF column_list fragment appropriate for this dialect given the aliases of the columns to be write locked.
aliases | The columns to be write locked. |
---|
Apply s limit clause to the query.
Typically dialects utilizevariable
limit clauses when they support limits. Thus, when building the
select command we do not actually need to know the limit or the offest
since we will just be using placeholders.
Here we do still pass along whether or not an offset was specified
so that dialects not supporting offsets can generate proper exceptions.
In general, dialects will override one or the other of this method and
getLimitString(String, int, int)
.sql | The query to which to apply the limit. |
---|---|
hasOffset | Is the query requesting an offset? |
Get the select command used retrieve the names of all sequences.
Given a callable statement previously processed by registerResultSetOutParameter(CallableStatement, int)
,
extract the ResultSet
from the OUT parameter.
ps | The callable statement. |
---|
SQLException |
---|
Given a java.sql.Types type code, determine an appropriate null value to use in a select clause.
One thing to consider here is that certain databases might require proper casting for the nulls here since the select here will be part of a UNION/UNION ALL.sqlType | The java.sql.Types type code. |
---|
Get the command used to select a GUID from the underlying database.
Optional operation.Generate the select expression fragment that will retrieve the next value of a sequence as part of another (typically DML) statement.
This differs fromgetSequenceNextValString(String)
in that this
should return an expression usable within another statement.sequenceName | the name of the sequence |
---|
Generate the appropriate select statement to to retrieve the next value of a sequence.
This should be a "stand alone" select statement.sequenceName | the name of the sequence |
---|
Should the value returned by getCurrentTimestampSelectString()
be treated as callable. Typically this indicates that JDBC escape
syntax is being used...
getCurrentTimestampSelectString()
return
is callable; false otherwise.
Registers an OUT parameter which will be returning a
ResultSet
. How this is accomplished varies greatly
from DB to DB, hence its inclusion (along with getResultSet(CallableStatement)
) here.
statement | The callable statement. |
---|---|
col | The bind position at which to register the OUT param. |
SQLException |
---|
Does this dialect support a way to retrieve the database's current timestamp value?
Does this dialect support empty IN lists?
For example, is [where XYZ in ()] a supported construct?Does the dialect support an exists statement in the select clause?
Does this dialect support some form of limiting query results via a SQL clause?
Does this dialect support "pooled" sequences. Not aware of a better name for this. Essentially can we specify the initial and increment values?
Does this dialect support sequences?
Does this dialect support temporary tables?
Does this dialect support UNION ALL, which is generally a faster variant of UNION?
Does the LIMIT clause take a "maximum" row number instead of a total number of returned rows?
This is easiest understood via an example. Consider you have a table with 20 rows, but you only want to retrieve rows number 11 through 20. Generally, a limit with offset would say that the offset = 11 and the limit = 10 (we only want 10 rows at a time); this is specifying the total number of returned rows. Some dialects require that we instead specify offset = 11 and limit = 20, where 20 is the "last" row we want relative to offset (i.e. total number of rows = 20 - 11 = 9) So essentially, is limit relative from offset? Or is limit absolute?