org.exolab.castor.jdo.drivers
Class OracleFactory

java.lang.Object
  org.exolab.castor.jdo.engine.BaseFactory
      org.exolab.castor.jdo.drivers.GenericFactory
          org.exolab.castor.jdo.drivers.OracleFactory

All Implemented Interfaces:

PersistenceFactory

Direct Known Subclasses:

SapDbFactory

public class OracleFactory

extends GenericFactory

PersistenceFactory for Oracle 7/8 driver.

Version:

$Revision: 5951 $ $Date: 2006-04-25 15:08:23 -0600 (Tue, 25 Apr 2006) $

Author:

Assaf Arkin

Field Summary

static java.lang.String

FACTORY_NAME

Constructor Summary

OracleFactory()

Method Summary

java.lang.Class	adjustSqlType(java.lang.Class sqlType) For INTEGER type ResultSet.getObject() returns BigDecimal: dependent objects with integer identity cause type conversion error (need to fix SimpleQueryExecutor).
PersistenceQuery	getCallQuery(java.lang.String call, java.lang.Class[] paramTypes, java.lang.Class javaClass, java.lang.String[] fields, int[] sqlTypes) Needed to process OQL queries of "CALL" type (using stored procedure call).
java.lang.String	getFactoryName() Returns the name of this factory.
QueryExpression	getQueryExpression() Returns a new empty query expression suitable for the underlying SQL engine.
java.lang.Boolean	isDuplicateKeyException(java.lang.Exception except) Determine if the given SQLException is DuplicateKeyException
java.lang.String	quoteName(java.lang.String name) Returns the quoted identifier suitable for preventing conflicts between database identifiers and reserved keywords.

Methods inherited from class org.exolab.castor.jdo.drivers.GenericFactory

doubleQuoteName

Methods inherited from class org.exolab.castor.jdo.engine.BaseFactory

getPersistence, supportsSetNullInWhere

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FACTORY_NAME

public static final java.lang.String FACTORY_NAME

See Also:

Constant Field Values

Constructor Detail

OracleFactory

public OracleFactory()

Method Detail

getFactoryName

public java.lang.String getFactoryName()

Description copied from interface: PersistenceFactory

Returns the name of this factory. A descriptive name that indicates the type of supported database server or SQL syntax.

Specified by:

getFactoryName in interface PersistenceFactory

Overrides:

getFactoryName in class GenericFactory

See Also:

PersistenceFactory.getFactoryName()

getQueryExpression

public QueryExpression getQueryExpression()

Description copied from interface: PersistenceFactory

Returns a new empty query expression suitable for the underlying SQL engine. The implementation will construct SQL query statements in the preferred syntax.

Specified by:

getQueryExpression in interface PersistenceFactory

Overrides:

getQueryExpression in class GenericFactory

See Also:

PersistenceFactory.getQueryExpression()

isDuplicateKeyException

public java.lang.Boolean isDuplicateKeyException(java.lang.Exception except)

Description copied from class: GenericFactory

Determine if the given SQLException is DuplicateKeyException

Specified by:

isDuplicateKeyException in interface PersistenceFactory

Overrides:

isDuplicateKeyException in class GenericFactory

Returns:

Boolean.TRUE means "yes", Boolean.FALSE means "no", null means "cannot determine"

See Also:

PersistenceFactory.isDuplicateKeyException(java.lang.Exception)

quoteName

public java.lang.String quoteName(java.lang.String name)

Description copied from interface: PersistenceFactory

Returns the quoted identifier suitable for preventing conflicts between database identifiers and reserved keywords.

Specified by:

quoteName in interface PersistenceFactory

Overrides:

quoteName in class GenericFactory

See Also:

PersistenceFactory.quoteName(java.lang.String)

getCallQuery

public PersistenceQuery getCallQuery(java.lang.String call,
                                     java.lang.Class[] paramTypes,
                                     java.lang.Class javaClass,
                                     java.lang.String[] fields,
                                     int[] sqlTypes)

Needed to process OQL queries of "CALL" type (using stored procedure call). This feature is specific for JDO.

Overrides:

getCallQuery in class BaseFactory

Parameters:

call - Stored procedure call (without "{call")

paramTypes - The types of the query parameters

javaClass - The Java class of the query results

fields - The field names

sqlTypes - The field SQL types

Returns:

null if this feature is not supported.

adjustSqlType

public java.lang.Class adjustSqlType(java.lang.Class sqlType)

For INTEGER type ResultSet.getObject() returns BigDecimal: dependent objects with integer identity cause type conversion error (need to fix SimpleQueryExecutor).

Overrides:

adjustSqlType in class BaseFactory

Parameters:

sqlType - The correspondent Java class for the SQL type in mapping.xml

Returns:

The correspondent Java class for the SQL type that should be used instead.

See Also:

BaseFactory.adjustSqlType(java.lang.Class)