org.melati.poem.dbms

Class Oracle

java.lang.Object

org.melati.poem.dbms.AnsiStandard

org.melati.poem.dbms.Oracle

All Implemented Interfaces:

Dbms

public class Oracle
extends AnsiStandard

A Driver for Oracle (http://www.oracle.com/).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Oracle.OracleBooleanPoemType Translates an Oracle Boolean into a Poem BooleanPoemType.
static class	Oracle.OracleStringPoemType Translates a Oracle String into a Poem StringPoemType.

Field Summary

Fields

Modifier and Type	Field and Description
static int	oracleTextHack Oracle does not have a pleasant TEXT datatype, so we use an arbetary value in a VARCHAR.

Constructor Summary

Constructors

Constructor and Description
Oracle() Constructor.

Method Summary

Modifier and Type	Method and Description
String	booleanTrueExpression(Column<Boolean> booleanColumn) Accommodate lack of boolean types in underlying DBMS.
<S,O> PoemType<O>	canRepresent(PoemType<S> storage, PoemType<O> type) Enable one PoemType to represent another, for example a bit to represent a boolean.
SQLPoemType<?>	defaultPoemTypeOfColumnMetaData(ResultSet md) The simplest POEM type corresponding to a JDBC description from the database.
String	getBinarySqlDefinition(int size) Accommodate different treatment of different sized binary data.
String	getForeignKeyDefinition(String tableName, String fieldName, String targetTableName, String targetTableFieldName, String fixName) If Foreign key definitions are part of field definitions, otherwise blank (silently unsupported).
String	getLongSqlDefinition() Accommodate Long / Bigint deviants.
String	getPrimaryKeyDefinition(String fieldName) Return the PRIMARY KEY definition string for this dbms.
String	getSqlDefaultValue(SQLType<?> sqlType) Used to set a not null value when creating a non nullable column.
String	getSqlDefinition(String sqlTypeName) Retrieve a SQL type keyword used by the DBMS for the given Melati type name.
String	getStringSqlDefinition(int size) Accommodate String/CLOB distinction.
String	melatiName(String name) Reverse the mapping in unreservedName.
String	sqlBooleanValueOfRaw(Object raw) Accommodate different true and false values.
String	unreservedName(String name) A pair of functions for getting around keywords which make your JDBC driver barf, as 'group' does for MySQL.

Methods inherited from class org.melati.poem.dbms.AnsiStandard

alterColumnAddCommentSQL, alterColumnNotNullableSQL, alterTableAddCommentSQL, canBeIndexed, canDropColumns, canStoreBlobs, caseInsensitiveRegExpSQL, createTableOptionsSql, createTableSql, createTableTypeQualifierSql, exceptionForUpdate, exceptionForUpdate, getConnection, getFixedPtSqlDefinition, getIndexLength, getJdbcMetadataName, getQuotedName, getQuotedValue, getSchema, givesCapabilitySQL, preparedStatementPlaceholder, selectLimit, shutdown, tableInitialisationSql, toString, unloadDriver

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

oracleTextHack

public static int oracleTextHack

Oracle does not have a pleasant TEXT datatype, so we use an arbetary value in a VARCHAR.

Constructor Detail

Oracle

public Oracle()

Constructor.

Method Detail

getStringSqlDefinition

public String getStringSqlDefinition(int size)
                              throws SQLException

Accommodate String/CLOB distinction.

Specified by:

getStringSqlDefinition in interface Dbms

Overrides:

getStringSqlDefinition in class AnsiStandard

Parameters:

size - the string length (-1 means no limit)

Returns:

the SQL definition for a string of this size

Throws:

SQLException

See Also:

AnsiStandard.getStringSqlDefinition(int)

getLongSqlDefinition

public String getLongSqlDefinition()

Description copied from interface: Dbms

Accommodate Long / Bigint deviants.

Specified by:

getLongSqlDefinition in interface Dbms

Overrides:

getLongSqlDefinition in class AnsiStandard

Returns:

the keyword to use.

getSqlDefinition

public String getSqlDefinition(String sqlTypeName)

Description copied from interface: Dbms

Retrieve a SQL type keyword used by the DBMS for the given Melati type name. Override this in non-Ansi standard dbms to handle variants.

Specified by:

getSqlDefinition in interface Dbms

Overrides:

getSqlDefinition in class AnsiStandard

Parameters:

sqlTypeName - the Melati internal type name

Returns:

this dbms specific type keyword

sqlBooleanValueOfRaw

public String sqlBooleanValueOfRaw(Object raw)

Description copied from interface: Dbms

Accommodate different true and false values.

Specified by:

sqlBooleanValueOfRaw in interface Dbms

Overrides:

sqlBooleanValueOfRaw in class AnsiStandard

Returns:

the DBMS specific truth and false values

getBinarySqlDefinition

public String getBinarySqlDefinition(int size)
                              throws SQLException

Description copied from interface: Dbms

Accommodate different treatment of different sized binary data.

Specified by:

getBinarySqlDefinition in interface Dbms

Overrides:

getBinarySqlDefinition in class AnsiStandard

Parameters:

size - how big the field is

Returns:

the keyword to use

Throws:

SQLException

unreservedName

public String unreservedName(String name)

Description copied from class: AnsiStandard

A pair of functions for getting around keywords which make your JDBC driver barf, as 'group' does for MySQL. Translate special names to non special ones.

Specified by:

unreservedName in interface Dbms

Overrides:

unreservedName in class AnsiStandard

Parameters:

name - the field or table name

Returns:

the name translated if necessary

See Also:

Dbms.unreservedName(java.lang.String), MySQL.unreservedName(java.lang.String), MySQL.melatiName(java.lang.String)

melatiName

public String melatiName(String name)

Description copied from interface: Dbms

Reverse the mapping in unreservedName.

Specified by:

melatiName in interface Dbms

Overrides:

melatiName in class AnsiStandard

Parameters:

name - an SQL name

Returns:

the corresponding name to use within Melati

canRepresent

public <S,O> PoemType<O> canRepresent(PoemType<S> storage,
                                      PoemType<O> type)

Description copied from interface: Dbms

Enable one PoemType to represent another, for example a bit to represent a boolean.

Specified by:

canRepresent in interface Dbms

Overrides:

canRepresent in class AnsiStandard

Parameters:

storage - the container

type - the type to store

Returns:

the PoemType to use

defaultPoemTypeOfColumnMetaData

public SQLPoemType<?> defaultPoemTypeOfColumnMetaData(ResultSet md)
                                               throws SQLException

Description copied from interface: Dbms

The simplest POEM type corresponding to a JDBC description from the database.

Specified by:

defaultPoemTypeOfColumnMetaData in interface Dbms

Overrides:

defaultPoemTypeOfColumnMetaData in class AnsiStandard

Parameters:

md - the JDBC metadata

Returns:

the PoemType to use

Throws:

SQLException - potentially

getForeignKeyDefinition

public String getForeignKeyDefinition(String tableName,
                                      String fieldName,
                                      String targetTableName,
                                      String targetTableFieldName,
                                      String fixName)

Description copied from interface: Dbms

If Foreign key definitions are part of field definitions, otherwise blank (silently unsupported).

Specified by:

getForeignKeyDefinition in interface Dbms

Overrides:

getForeignKeyDefinition in class AnsiStandard

Parameters:

tableName - the table that this column is in, unquoted

fieldName - often the name of the foreign table, unquoted

targetTableName - the table that this is a foreign key into, unquoted

targetTableFieldName - name of the primary key field of the foreign table, often id, unquoted

fixName - name of the IntegrityFix

Returns:

The definition string

getPrimaryKeyDefinition

public String getPrimaryKeyDefinition(String fieldName)

Description copied from interface: Dbms

Return the PRIMARY KEY definition string for this dbms.

Specified by:

getPrimaryKeyDefinition in interface Dbms

Overrides:

getPrimaryKeyDefinition in class AnsiStandard

Parameters:

fieldName - the table Troid column, often id, unquoted

Returns:

The definition string

booleanTrueExpression

public String booleanTrueExpression(Column<Boolean> booleanColumn)

Description copied from interface: Dbms

Accommodate lack of boolean types in underlying DBMS.

Specified by:

booleanTrueExpression in interface Dbms

Overrides:

booleanTrueExpression in class AnsiStandard

Parameters:

booleanColumn - the column which should be a boolean

Returns:

an expression that evaluates to True ie the column name or column name = 1

getSqlDefaultValue

public String getSqlDefaultValue(SQLType<?> sqlType)

Description copied from interface: Dbms

Used to set a not null value when creating a non nullable column.

Specified by:

getSqlDefaultValue in interface Dbms

Overrides:

getSqlDefaultValue in class AnsiStandard

Parameters:

sqlType - the type name

Returns:

a String suitable for substitution in UPDATE table SET field = ?