org.apache.ojb.broker.platforms

Class PlatformOracleImpl

java.lang.Object

org.apache.ojb.broker.platforms.PlatformDefaultImpl

org.apache.ojb.broker.platforms.PlatformOracleImpl

All Implemented Interfaces:

JoinSyntaxTypes, Platform

Direct Known Subclasses:

PlatformOracle9iImpl, PlatformWLOracle9iImpl

public class PlatformOracleImpl
extends PlatformDefaultImpl

This class is a concrete implementation of Platform. Provides an implementation that works around some issues with Oracle in general and Oracle's Thin driver in particular.

Many of the database sequence specific properties can be specified using custom attributes within the sequence-manager element.
The database sequence specific properties are generally speaking, see database user guide for detailed description.

Implementation configuration properties:

Property Key	Property Values
sequenceStart	DEPRECATED. Database sequence specific property. Specifies the first sequence number to be generated. Allowed: 1 or greater.
seq.start	Database sequence specific property. Specifies the first sequence number to be generated. Allowed: 1 or greater.
seq.incrementBy	Database sequence specific property. Specifies the interval between sequence numbers. This value can be any positive or negative integer, but it cannot be 0.
seq.maxValue	Database sequence specific property. Set max value for sequence numbers.
seq.minValue	Database sequence specific property. Set min value for sequence numbers.
seq.cycle	Database sequence specific property. If true, specifies that the sequence continues to generate values after reaching either its maximum or minimum value. If false, specifies that the sequence cannot generate more values after reaching its maximum or minimum value.
seq.cache	Database sequence specific property. Specifies how many values of the sequence Oracle preallocates and keeps in memory for faster access. Allowed values: 2 or greater. If set 0, an explicite nocache expression will be set.
seq.order	Database sequence specific property. If set true, guarantees that sequence numbers are generated in order of request. If false, a no order expression will be set.

Version:

$Id: PlatformOracleImpl.java 364898 2005-08-16 20:11:19Z arminw $

Author:

Thomas Mahler

Field Summary

Fields inherited from interface org.apache.ojb.broker.accesslayer.JoinSyntaxTypes

ORACLE_JOIN_SYNTAX, SQL92_JOIN_SYNTAX, SQL92_NOPAREN_JOIN_SYNTAX, SYBASE_JOIN_SYNTAX

Constructor Summary

Constructors

Constructor and Description
PlatformOracleImpl() Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	afterStatementCreate(java.sql.Statement stmt) In Oracle we set escape processing explizit 'true' after a statement was created.
java.lang.String	createSequenceQuery(java.lang.String sequenceName) Override this method to enable database based sequence generation
java.lang.String	createSequenceQuery(java.lang.String sequenceName, java.util.Properties prop) Returns a query to create a sequence entry.
java.lang.String	dropSequenceQuery(java.lang.String sequenceName) Override this method to enable database based sequence generation
byte	getJoinSyntaxType() Get join syntax type for this RDBMS - one on of the constants from JoinSyntaxType interface
java.lang.String	nextSequenceQuery(java.lang.String sequenceName) Override this method to enable database based sequence generation
java.sql.CallableStatement	prepareNextValProcedureStatement(java.sql.Connection con, java.lang.String procedureName, java.lang.String sequenceName) Method prepareNextValProcedureStatement implementation is simply copied over from PlatformMsSQLServerImpl class.
void	registerOutResultSet(java.sql.CallableStatement stmt, int position) Registers call argument at position as returning a ResultSet value.
void	setObjectForStatement(java.sql.PreparedStatement ps, int index, java.lang.Object value, int sqlType) For objects beyond 4k, weird things happen in Oracle if you try to use "setBytes", so for all cases it's better to use setBinaryStream.

Methods inherited from class org.apache.ojb.broker.platforms.PlatformDefaultImpl

addBatch, addPagingSql, afterStatementClose, beforeBatch, beforeStatementClose, bindPagingParameters, bindPagingParametersFirst, changeAutoCommitState, concatenate, executeBatch, getEscapeClause, getLastInsertIdentityQuery, initializeJdbcConnection, setNullForStatement, supportsBatchOperations, supportsMultiColumnCountDistinct, supportsPaging, useCountForResultsetSize

Methods inherited from class java.lang.Object

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

Constructor Detail

PlatformOracleImpl

public PlatformOracleImpl()

Default constructor.

Method Detail

prepareNextValProcedureStatement

public java.sql.CallableStatement prepareNextValProcedureStatement(java.sql.Connection con,
                                                          java.lang.String procedureName,
                                                          java.lang.String sequenceName)
                                                            throws PlatformException

Method prepareNextValProcedureStatement implementation is simply copied over from PlatformMsSQLServerImpl class.

Specified by:

prepareNextValProcedureStatement in interface Platform

Overrides:

prepareNextValProcedureStatement in class PlatformDefaultImpl

Throws:

PlatformException

See Also:

Platform.prepareNextValProcedureStatement(java.sql.Connection, java.lang.String, java.lang.String)

afterStatementCreate

public void afterStatementCreate(java.sql.Statement stmt)
                          throws PlatformException

In Oracle we set escape processing explizit 'true' after a statement was created.

Specified by:

afterStatementCreate in interface Platform

Overrides:

afterStatementCreate in class PlatformDefaultImpl

Throws:

PlatformException

setObjectForStatement

public void setObjectForStatement(java.sql.PreparedStatement ps,
                         int index,
                         java.lang.Object value,
                         int sqlType)
                           throws java.sql.SQLException

For objects beyond 4k, weird things happen in Oracle if you try to use "setBytes", so for all cases it's better to use setBinaryStream. Oracle also requires a change in the resultset type of the prepared statement. MBAIRD NOTE: BLOBS may not work with Oracle database/thin driver versions prior to 8.1.6.

Specified by:

setObjectForStatement in interface Platform

Overrides:

setObjectForStatement in class PlatformDefaultImpl

Throws:

java.sql.SQLException

See Also:

Platform.setObjectForStatement(java.sql.PreparedStatement, int, java.lang.Object, int)

getJoinSyntaxType

public byte getJoinSyntaxType()

Get join syntax type for this RDBMS - one on of the constants from JoinSyntaxType interface

Specified by:

getJoinSyntaxType in interface Platform

Overrides:

getJoinSyntaxType in class PlatformDefaultImpl

See Also:

Platform.getJoinSyntaxType()

createSequenceQuery

public java.lang.String createSequenceQuery(java.lang.String sequenceName)

Description copied from class: PlatformDefaultImpl

Override this method to enable database based sequence generation

Specified by:

createSequenceQuery in interface Platform

Overrides:

createSequenceQuery in class PlatformDefaultImpl

Parameters:

sequenceName - The name of the sequence to create.

Returns:

a sql string to create a sequence

createSequenceQuery

public java.lang.String createSequenceQuery(java.lang.String sequenceName,
                                   java.util.Properties prop)

Description copied from interface: Platform

Returns a query to create a sequence entry.

Specified by:

createSequenceQuery in interface Platform

Overrides:

createSequenceQuery in class PlatformDefaultImpl

Parameters:

sequenceName - The name of the sequence to create.

prop - The database specific sequence properties.

Returns:

a sql string to create a sequence

nextSequenceQuery

public java.lang.String nextSequenceQuery(java.lang.String sequenceName)

Description copied from class: PlatformDefaultImpl

Override this method to enable database based sequence generation

Specified by:

nextSequenceQuery in interface Platform

Overrides:

nextSequenceQuery in class PlatformDefaultImpl

Returns:

a sql string to get next sequence value

dropSequenceQuery

public java.lang.String dropSequenceQuery(java.lang.String sequenceName)

Description copied from class: PlatformDefaultImpl

Override this method to enable database based sequence generation

Specified by:

dropSequenceQuery in interface Platform

Overrides:

dropSequenceQuery in class PlatformDefaultImpl

Returns:

a sql string to drop a sequence

registerOutResultSet

public void registerOutResultSet(java.sql.CallableStatement stmt,
                        int position)
                          throws java.sql.SQLException

Description copied from interface: Platform

Registers call argument at position as returning a ResultSet value.

Specified by:

registerOutResultSet in interface Platform

Overrides:

registerOutResultSet in class PlatformDefaultImpl

Parameters:

stmt - the statement

position - argument position

Throws:

java.sql.SQLException

See Also:

Platform.registerOutResultSet(java.sql.CallableStatement, int)