oracle.toplink.platform.database.oracle
Class Oracle9Platform

java.lang.Object
  oracle.toplink.internal.databaseaccess.DatasourcePlatform
      oracle.toplink.internal.databaseaccess.DatabasePlatform
          oracle.toplink.platform.database.DatabasePlatform
              oracle.toplink.platform.database.oracle.OraclePlatform
                  oracle.toplink.platform.database.oracle.Oracle8Platform
                      oracle.toplink.platform.database.oracle.Oracle9Platform

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, oracle.toplink.internal.databaseaccess.Platform

Direct Known Subclasses:

Oracle10Platform

public class Oracle9Platform
extends Oracle8Platform

Purpose: Supports usage of certain Oracle JDBC specific APIs.

Supports binding NCHAR, NVARCHAR, NCLOB types as required by Oracle JDBC drivers.

Supports Oracle JDBC TIMESTAMP, TIMESTAMPTZ, TIMESTAMPLTZ types.

See Also:

Serialized Form

Field Summary

static java.lang.Class	NCHAR
static java.lang.Class	NCLOB
static java.lang.Class	NSTRING
static java.lang.Class	XMLTYPE

Fields inherited from class oracle.toplink.internal.databaseaccess.DatabasePlatform

DEFAULT_MAX_BATCH_WRITING_SIZE, DEFAULT_PARAMETERIZED_MAX_BATCH_WRITING_SIZE

Constructor Summary

Oracle9Platform()

Method Summary

void	clearConnectionData()
java.lang.Object	clone()
void	copyInto(oracle.toplink.internal.databaseaccess.Platform platform) Copy the state into the new platform.
java.lang.Boolean	getCorrectTimeInTimestampTZ() ADVANCED: Answer the comparison and correction of time data passed into the creation of TIMESTAMPTZ instances (True), or disable the compare and correction algorithm (False).
int	getJDBCType(java.lang.Class javaType) Return the JDBC type for the Java type.
int	getJDBCType(DatabaseField field) Return the JDBC type for the given database field.
int	getLobValueLimits() Return the BLOB/CLOB value limits on thin driver.
java.lang.Boolean	getPrintCalendarIntoTimestampTZ() ADVANCED: Answer the passing of Calendar objects as a String into the creation of TIMESTAMPTZ instances (True) or pass the Calendar object directly into the TIMESTAMPTZ instance (False).
void	setCorrectTimeInTimestampTZ(java.lang.Boolean correctTimeInTimestampTZ) ADVANCED: Configure the comparison and correction of time data passed into the creation of TIMESTAMPTZ instances (True), or disable the compare and correction algorithm (False).
void	setLobValueLimits(int lobValueLimits) Set the BLOB/CLOB value limits on thin driver.
void	setPrintCalendarIntoTimestampTZ(java.lang.Boolean printCalendarIntoTimestampTZ) ADVANCED: Configure the passing of Calendar objects as a String into the creation of TIMESTAMPTZ instances (True) or pass the Calendar object directly into the TIMESTAMPTZ instance (False).
void	setShouldUseLocatorForLOBWrite(boolean usesLocatorForLOBWrite) Set if the locator is required for the LOB write.
boolean	shouldUseLocatorForLOBWrite() Return if the locator is required for the LOB write.

Methods inherited from class oracle.toplink.platform.database.oracle.OraclePlatform

allowsSizeInProcedureArguments, getBatchBeginString, getBatchEndString, getNativeTableInfo, getProcedureArgumentSetter, getProcedureCallHeader, getProcedureCallTail, getSelectForUpdateString, getStoredProcedureParameterPrefix, getStoredProcedureTerminationToken, getSystemChangeNumberQuery, isOracle, maximumNumericValues, minimumNumericValues, setShouldUseRownumFiltering, setSupportsIdentity, shouldPrintOuterJoinInWhereClause, shouldUseJDBCOuterJoinSyntax, shouldUseRownumFiltering, supportsSelectForUpdateNoWait

Methods inherited from class oracle.toplink.internal.databaseaccess.DatabasePlatform

addStructConverter, appendParameter, appendParameterInternal, autoCommit, beginTransaction, buildProcedureCallString, commitTransaction, executeStoredProcedure, getBatchDelimiterString, getClassTypes, getConstraintDeletionString, getCreateViewString, getCreationInOutputProcedureToken, getCreationOutputProcedureToken, getCursorCode, getFieldTypeDefinition, getFieldTypes, getFunctionCallHeader, getInOutputProcedureToken, getJDBCOuterJoinString, getMaxBatchWritingSize, getNoWaitString, getOutputProcedureToken, getPingSQL, getProcedureArgumentString, getProcedureAsString, getProcedureBeginString, getProcedureEndString, getQualifiedSequenceTableName, getSelectForUpdateNoWaitString, getSelectForUpdateOfString, getSequenceCounterFieldName, getSequenceNameFieldName, getSequencePreallocationSize, getSequenceTableName, getStatementCacheSize, getStringBindingSize, getTransactionIsolation, isInformixOuterJoin, printFieldIdentityClause, printFieldNotNullClause, printFieldTypeSize, printFieldUnique, printValuelist, printValuelist, registerOutputParameter, requiresNamedPrimaryKeyConstraints, requiresProcedureCallBrackets, requiresProcedureCallOuputToken, rollbackTransaction, setCursorCode, setMaxBatchWritingSize, setPingSQL, setSequenceCounterFieldName, setSequenceNameFieldName, setSequenceTableName, setShouldBindAllParameters, setShouldCacheAllStatements, setShouldForceFieldNamesToUpperCase, setShouldIgnoreCaseOnFieldComparisons, setShouldOptimizeDataConversion, setShouldTrimStrings, setStatementCacheSize, setStringBindingSize, setSupportsAutoCommit, setTransactionIsolation, setUsesBatchWriting, setUsesByteArrayBinding, setUsesJDBCBatchWriting, setUsesNativeBatchWriting, setUsesNativeSQL, setUsesStreamsForBinding, setUsesStringBinding, shouldBindAllParameters, shouldCacheAllStatements, shouldForceFieldNamesToUpperCase, shouldIgnoreCaseOnFieldComparisons, shouldIgnoreException, shouldOptimizeDataConversion, shouldPrintConstraintNameAfter, shouldPrintFieldIdentityClause, shouldPrintInOutputTokenBeforeType, shouldPrintOutputTokenAtStart, shouldPrintOutputTokenBeforeType, shouldTrimStrings, supportsAutoCommit, supportsForeignKeyConstraints, supportsNativeSequenceNumbers, supportsPrimaryKeyConstraint, supportsUniqueKeyConstraints, usesBatchWriting, usesByteArrayBinding, usesJDBCBatchWriting, usesNativeBatchWriting, usesNativeSQL, usesSequenceTable, usesStreamsForBinding, usesStringBinding, writeParameterMarker

Methods inherited from class oracle.toplink.internal.databaseaccess.DatasourcePlatform

addSequence, getConversionManager, getDefaultSequence, getOperator, getPlatformOperators, getSelectSequenceQuery, getSequence, getTableQualifier, getUpdateSequenceQuery, hasDefaultSequence, isAccess, isAttunity, isCloudscape, isDB2, isDBase, isDerby, isHSQL, isInformix, isMySQL, isODBC, isPointBase, isPostgreSQL, isSQLAnywhere, isSQLServer, isSybase, isTimesTen, isTimesTen7, removeAllSequences, removeSequence, setConversionManager, setDefaultSequence, setSelectSequenceNumberQuery, setSequencePreallocationSize, setTableQualifier, setTimestampQuery, setUpdateSequenceQuery, toString

Methods inherited from class java.lang.Object

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

Field Detail

NCHAR

public static final java.lang.Class NCHAR

NSTRING

public static final java.lang.Class NSTRING

NCLOB

public static final java.lang.Class NCLOB

XMLTYPE

public static final java.lang.Class XMLTYPE

Constructor Detail

Oracle9Platform

public Oracle9Platform()

Method Detail

clone

public java.lang.Object clone()

Specified by:

clone in interface oracle.toplink.internal.databaseaccess.Platform

Overrides:

clone in class oracle.toplink.internal.databaseaccess.DatasourcePlatform

copyInto

public void copyInto(oracle.toplink.internal.databaseaccess.Platform platform)

Copy the state into the new platform.

Specified by:

copyInto in interface oracle.toplink.internal.databaseaccess.Platform

Overrides:

copyInto in class Oracle8Platform

clearConnectionData

public void clearConnectionData()

setShouldUseLocatorForLOBWrite

public void setShouldUseLocatorForLOBWrite(boolean usesLocatorForLOBWrite)

Set if the locator is required for the LOB write. The default is true. For Oracle thin driver, the locator is recommended for large size ( >4k for Oracle8, >5.9K for Oracle9) BLOB/CLOB value write.

Overrides:

setShouldUseLocatorForLOBWrite in class Oracle8Platform

shouldUseLocatorForLOBWrite

public boolean shouldUseLocatorForLOBWrite()

Return if the locator is required for the LOB write. The default is true. For Oracle thin driver, the locator is recommended for large size ( >4k for Oracle8, >5.9K for Oracle9) BLOB/CLOB value write.

Overrides:

shouldUseLocatorForLOBWrite in class Oracle8Platform

setPrintCalendarIntoTimestampTZ

public void setPrintCalendarIntoTimestampTZ(java.lang.Boolean printCalendarIntoTimestampTZ)

ADVANCED: Configure the passing of Calendar objects as a String into the creation of TIMESTAMPTZ instances (True) or pass the Calendar object directly into the TIMESTAMPTZ instance (False).

getPrintCalendarIntoTimestampTZ

public java.lang.Boolean getPrintCalendarIntoTimestampTZ()

ADVANCED: Answer the passing of Calendar objects as a String into the creation of TIMESTAMPTZ instances (True) or pass the Calendar object directly into the TIMESTAMPTZ instance (False).

setCorrectTimeInTimestampTZ

public void setCorrectTimeInTimestampTZ(java.lang.Boolean correctTimeInTimestampTZ)

ADVANCED: Configure the comparison and correction of time data passed into the creation of TIMESTAMPTZ instances (True), or disable the compare and correction algorithm (False).

getCorrectTimeInTimestampTZ

public java.lang.Boolean getCorrectTimeInTimestampTZ()

ADVANCED: Answer the comparison and correction of time data passed into the creation of TIMESTAMPTZ instances (True), or disable the compare and correction algorithm (False).

getLobValueLimits

public int getLobValueLimits()

Return the BLOB/CLOB value limits on thin driver. The default value is 0. If usesLocatorForLOBWrite is true, locator will be used in case the lob's size is larger than lobValueLimit.

Overrides:

getLobValueLimits in class Oracle8Platform

setLobValueLimits

public void setLobValueLimits(int lobValueLimits)

Set the BLOB/CLOB value limits on thin driver. The default value is 0. If usesLocatorForLOBWrite is true, locator will be used in case the lob's size is larger than lobValueLimit.

Overrides:

setLobValueLimits in class Oracle8Platform

getJDBCType

public int getJDBCType(DatabaseField field)

Return the JDBC type for the given database field. The Oracle driver does not like the OPAQUE type so VARCHAR must be used.

Overrides:

getJDBCType in class oracle.toplink.internal.databaseaccess.DatabasePlatform

getJDBCType

public int getJDBCType(java.lang.Class javaType)

Return the JDBC type for the Java type. The Oracle driver does not like the OPAQUE type so VARCHAR must be used.

Overrides:

getJDBCType in class oracle.toplink.internal.databaseaccess.DatabasePlatform