oracle.sql
Class DatumWithConnection

java.lang.Object
  oracle.sql.Datum
      oracle.sql.DatumWithConnection

All Implemented Interfaces:

java.io.Serializable, oracle.jdbc.internal.OracleDatumWithConnection

Direct Known Subclasses:

ARRAY, BFILE, BLOB, CLOB, OPAQUE, REF, STRUCT

public abstract class DatumWithConnection
extends Datum
implements oracle.jdbc.internal.OracleDatumWithConnection

A supper class for some Oracle specific datatypes, such as BFILE, BLOB, etc.

See Also:

Serialized Form

Field Summary

static java.lang.String	BUILD_DATE
static boolean	TRACE

Constructor Summary

DatumWithConnection()

DatumWithConnection(byte[] elements)

Method Summary

static void	assertNotNull(java.sql.Connection conn)
static void	assertNotNull(TypeDescriptor desc)
oracle.jdbc.driver.OracleConnection	getConnection() Deprecated. since 9.0.0. Use getJavaSqlConnection() or getInternalConnection(), or Use getOracleConnection() instead.
java.sql.Connection	getJavaSqlConnection() Oracle extension Return the java.sql.Connection associated with the receiver.
OracleConnection	getOracleConnection() Oracle extension.

Methods inherited from class oracle.sql.Datum

asciiStreamValue, bigDecimalValue, binaryStreamValue, booleanValue, byteValue, characterStreamValue, dateValue, doubleValue, equals, floatValue, getBytes, getLength, getStream, intValue, isConvertibleTo, longValue, makeJdbcArray, setBytes, setShareBytes, shareBytes, stringValue, stringValue, timestampValue, timestampValue, timeValue, timeValue, toJdbc

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.jdbc.internal.OracleDatumWithConnection

asciiStreamValue, bigDecimalValue, binaryStreamValue, booleanValue, byteValue, characterStreamValue, dateValue, doubleValue, floatValue, getBytes, getInternalConnection, getLength, getStream, intValue, isConvertibleTo, longValue, makeJdbcArray, setBytes, setShareBytes, shareBytes, stringValue, stringValue, timestampValue, timestampValue, timeValue, timeValue, toJdbc

Field Detail

BUILD_DATE

public static final java.lang.String BUILD_DATE

See Also:

Constant Field Values

TRACE

public static final boolean TRACE

See Also:

Constant Field Values

Constructor Detail

DatumWithConnection

public DatumWithConnection(byte[] elements)
                    throws java.sql.SQLException

Throws:

java.sql.SQLException

DatumWithConnection

public DatumWithConnection()

Method Detail

assertNotNull

public static void assertNotNull(java.sql.Connection conn)
                          throws java.sql.SQLException

Throws:

java.sql.SQLException

assertNotNull

public static void assertNotNull(TypeDescriptor desc)
                          throws java.sql.SQLException

Throws:

java.sql.SQLException

getJavaSqlConnection

public java.sql.Connection getJavaSqlConnection()
                                         throws java.sql.SQLException

Oracle extension Return the java.sql.Connection associated with the receiver. Since 9.0.0 not all Oracle JDBC connection objects are assignment compatible with oracle.jdbc.driver.OracleConnection. If the connection is wrapped, return the outermost wrapper.

Specified by:

getJavaSqlConnection in interface oracle.jdbc.internal.OracleDatumWithConnection

Returns:

the connection

Throws:

java.sql.SQLException - if an error occurs

Since:

9iR2

getOracleConnection

public OracleConnection getOracleConnection()
                                     throws java.sql.SQLException

Oracle extension. The OracleConnection object associated with the object. If the internal connection is wrapped return the wrapping instance.

Specified by:

getOracleConnection in interface oracle.jdbc.internal.OracleDatumWithConnection

Returns:

the possibly wrapped connection for external use

Throws:

java.sql.SQLException - if an error occurs

Since:

9.2

getConnection

public oracle.jdbc.driver.OracleConnection getConnection()
                                                  throws java.sql.SQLException

Deprecated. since 9.0.0. Use getJavaSqlConnection() or getInternalConnection(), or Use getOracleConnection() instead.

Oracle extension. Returns the oracle.jdbc.driver.OracleConnection object associated with the receiver. This is always a physical connection. Any logical connection or connection wrapper associated with the physical connection is ignored by this mehtod

Specified by:

getConnection in interface oracle.jdbc.internal.OracleDatumWithConnection

Returns:

the connection if it is assignment compatible with oracle.jdbc.driver.OracleConnection

Throws:

java.sql.SQLException - if the connection is not assignment compatible