oracle.jbo.domain
Class Ref

java.lang.Object
oracle.jbo.domain.Ref

All Implemented Interfaces:

oracle.sql.CustomDatum, oracle.jbo.domain.DomainInterface, oracle.jdbc.internal.ObjectData, java.io.Serializable

public class Ref

extends java.lang.Object

implements oracle.jbo.domain.DomainInterface, oracle.sql.CustomDatum, java.io.Serializable

This class provides a lightweight wrapper for oracle.sql.Ref, the Java representation of the REF database type. This wrapper allows an instance of the oracle.sql.Ref to be used as an immutable Domain object.

The oracle.jbo.domain.Ref class is the Java representation of the underlying database type that you must use if you want to exploit the domain feature of Business Components for Java.

Since:

JDeveloper 3.0

See Also:

Serialized Form

Constructor Summary

protected	Ref() Internal: Applications should not invoke this constructor.
	Ref(oracle.sql.Datum d) Internal: Applications should not invoke this constructor.
	Ref(java.lang.String structName, byte[] data) Internal: Applications should not invoke this constructor.

Method Summary

boolean	equals(java.lang.Object obj) Tests this for equality with another object.
byte[]	getBytes() Returns the contents of the Ref in byte format.
static oracle.sql.CustomDatumFactory	getCustomDatumFactory() Internal: Applications should not invoke this method.
java.lang.Object	getData() Internal: Applications should not invoke this method.
oracle.jbo.Row	getReferencedObject(oracle.jbo.domain.DomainAttributeDef ad) Returns an an instance of the refernced row, given the attribute definition object.
java.lang.String	getStructName() Returns the name of the struct associated with this RefDomain.
void	setContext(oracle.jbo.domain.DomainOwnerInterface owner, oracle.jbo.Transaction trans, java.lang.Object fac) Internal: Applications should not invoke this method.
oracle.sql.Datum	toDatum(oracle.jdbc.driver.OracleConnection conn) Internal: Applications should not invoke this method.

Methods inherited from class java.lang.Object

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

Constructor Detail

Ref

protected Ref()
       throws java.sql.SQLException

Internal: Applications should not invoke this constructor.

Ref

public Ref(java.lang.String structName,
           byte[] data)

Internal: Applications should not invoke this constructor.

Creates a Ref Domain object.

Ref

public Ref(oracle.sql.Datum d)
    throws java.sql.SQLException

Internal: Applications should not invoke this constructor.

Method Detail

getCustomDatumFactory

public static oracle.sql.CustomDatumFactory getCustomDatumFactory()

Internal: Applications should not invoke this method.

Initializes the Ref Domain. This method is invoked when Business Components for Java is initialized.

Returns:

the CustomDatumFactory for the Ref Domain.

toDatum

public oracle.sql.Datum toDatum(oracle.jdbc.driver.OracleConnection conn)
                         throws java.sql.SQLException

Internal: Applications should not invoke this method.

Converts this Ref Domain object back into a SQL REF object.

Specified by:

toDatum in interface oracle.sql.CustomDatum

Parameters:

conn - OracleConnection Not used.

Returns:

A Datum containing REF object.

Throws:

java.sql.SQLException - Never.

setContext

public void setContext(oracle.jbo.domain.DomainOwnerInterface owner,
                       oracle.jbo.Transaction trans,
                       java.lang.Object fac)

Internal: Applications should not invoke this method.

Specified by:

setContext in interface oracle.jbo.domain.DomainInterface

getData

public java.lang.Object getData()

Internal: Applications should not invoke this method.

Converts this to a JDBC object.

Specified by:

getData in interface oracle.jbo.domain.DomainInterface

Returns:

the JDBC representation of this, or null, if the conversion fails.

getStructName

public java.lang.String getStructName()

Returns the name of the struct associated with this RefDomain.

Returns:

the name of the struct.

getBytes

public byte[] getBytes()

Returns the contents of the Ref in byte format.

Returns:

a byte array containing the contents of the Ref.

getReferencedObject

public oracle.jbo.Row getReferencedObject(oracle.jbo.domain.DomainAttributeDef ad)

Returns an an instance of the refernced row, given the attribute definition object. The referenced row is returned as an Row object.

Parameters:

ad - the attribute's attribute definition object.

Returns:

the row corredsponding to the attribute definition object.

See Also:

Row

equals

public boolean equals(java.lang.Object obj)

Tests this for equality with another object.

The argument is converted to a Ref object, if necessary.

Parameters:

obj - an arbitrary Object.

Returns:

true if conversion was successful and the converted argument is identical to this.