oracle.jbo.domain
Class Struct

java.lang.Object
oracle.jbo.domain.Struct

All Implemented Interfaces:

oracle.jbo.AttributeList, oracle.jbo.domain.BlobDomainInterface, oracle.sql.CustomDatum, oracle.jbo.domain.DomainInterface, oracle.jbo.domain.DomainOwnerInterface, oracle.jbo.domain.LobInterface, oracle.jbo.domain.MarshalledDomain, oracle.jbo.domain.MutableDomainInterface, oracle.jdbc.internal.ObjectData, java.io.Serializable, oracle.jbo.domain.XMLDomainInterface

public abstract class Struct

extends java.lang.Object

implements oracle.jbo.domain.LobInterface, oracle.jbo.domain.DomainOwnerInterface, oracle.jbo.domain.XMLDomainInterface, oracle.jbo.AttributeList, oracle.sql.CustomDatum, java.io.Serializable, oracle.jbo.domain.MarshalledDomain

This class provides a lightweight wrapper for oracle.sql.STRUCT, the Java representation of the Struct database type. This wrapper allows an instance of the oracle.sql.STRUCT to be used as a domain object.

The oracle.jbo.domain.StructDomain 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

Field Summary

protected oracle.jbo.domain.XMLDomainFactory[]	mAttrXmlFac Factories for each of the attibutes if they have one.
protected java.lang.Object	mConnection Internal: Applications should not use this field.
protected com.sun.java.util.collections.HashMap	mContext Internal: Applications should not use this field.
protected java.lang.Object	mData Internal: Applications should not use this field.
protected int	mOwnerAttrIndex Index of the attribute in the domain owner's container.
protected oracle.jbo.Transaction	mTxn Internal: Applications should not use this field.
protected oracle.jbo.domain.XMLDomainFactory	mXmlFac The factory object that creates an instance of this STRUCT given an XML element.

Constructor Summary

protected	Struct() Constructs an instance of this class.
protected	Struct(oracle.sql.Datum d) Internal: Applications should not use this constructor.

Method Summary

int[]	buildAttrSQLTypes() Returns an array of the SQL datatypes of the attributes in this StructDomain object.
void	domainToBeModified(oracle.jbo.domain.DomainInterface d) Notification method that this domain calls whenever any of its attribute values are about to be modified.
boolean	equals(java.lang.Object obj) Tests this for equality with another object.
static void	fillObjectAttributeDefs(oracle.jbo.AttributeList al, oracle.jbo.StructureDef def, java.lang.String[] attrNames, oracle.jbo.AttributeDef[] ads)
abstract oracle.sql.CustomDatumFactory[]	getAttrCustomDatumFactories() Returns factories that oracle.sql requires to create the attributes of this structure.
java.lang.Object	getAttribute(int index) Returns the attribute from this StructDomain object, given its index.
java.lang.Object	getAttribute(java.lang.String name) Returns the attribute from this StructDomain object, given its name.
int	getAttributeCount() Returns the number of attributes in this StructDomain object.
int	getAttributeIndexOf(java.lang.String name) Returns the index of a named attribute in this StructDomain object.
java.lang.String[]	getAttributeNames()
java.lang.Object[]	getAttributeValues()
abstract int[]	getAttrSQLTypes() Returns the SQL types for the attributes of the structure.
protected java.lang.String	getAttrXMLElementTag(oracle.jbo.AttributeDef ad) Returns the class name of this domain, appended with the name of the attribute as xml-element tag for this domain-attribute.
abstract java.lang.String	getColumnType() Returns the column type of the database column that corresponds to this STRUCT.
java.lang.Object	getData() Internal: Applications should not use this method.
oracle.jbo.domain.DomainOwnerInterface	getOwner()
int	getOwnerAttributeIndex()
protected oracle.jbo.domain.DomainOwnerInterface	getOwnerRow()
java.lang.String	getRemoteIdString()
long	getSize()
static java.lang.Object	getStructAttribute(oracle.jbo.AttributeList inAttrList, oracle.jbo.StructureDef inStructDef, java.lang.String fullAttrName)
abstract oracle.jbo.StructureDef	getStructureDef() Returns the structure definition, that describes the details of the attributes, of this domain.
org.w3c.dom.Node	getXMLContentNode(org.w3c.dom.Document xmlDoc) Creates the xml node in the given xml document for this domain's data.
static oracle.jbo.domain.XMLDomainFactory	getXMLDomainFactory(java.lang.Class attrClass) Internal: Applications should not use this method.
protected java.lang.String	getXMLElementTag() Returns this class name as xml-element tag for this Struct domain object.
int	hashCode() Computes a hash code for this StructDomain object.
protected void	initAttrXMLDomainFactories(oracle.jbo.AttributeDef[] attrs) Internal: Applications should not use this method.
protected abstract void	initStructureDef() Initializes the structure definition of this object and its attribute definitions.
protected boolean	isAttrXMLCData(oracle.jbo.AttributeDef ad) Returns false always.
void	loadFromDatabase(oracle.jbo.Transaction transaction) Internal: Applications should not use this method.
oracle.svcmsg.ResponseValues	marshal()
void	prepareForDML(java.lang.Object context)
java.lang.String	printXMLDefinition(java.util.Hashtable allDefs, java.io.PrintWriter pw, boolean bContainees) Prints the DTD info for this domain in the given print writer.
protected void	readAttrsFromXML(org.w3c.dom.Element rowElt) Reads all the attribute values from the xml-element and sets them into this row.
static oracle.jbo.StructureDef	resolveAndGetStructureDef(java.lang.Class objectDomainClz)
void	saveToDatabase(oracle.jbo.Transaction transaction) Internal: Applications should not use this method.
void	saveToDatabase(oracle.jbo.Transaction transaction, java.lang.Object postedSQLObject) Internal: Applications should not use this method.
void	setAttribute(int index, java.lang.Object value) Sets the value of an attribute in this StructDomain, at the given index position.
void	setAttribute(java.lang.String name, java.lang.Object value) Sets the value of an attribute in this StructDomain object, given the attributes's name.
void	setAttributeNoCheck(int index, java.lang.Object value) Sets the value of an attribute in this StructDomain object, at the given index position.
void	setContext(oracle.jbo.domain.DomainOwnerInterface owner, oracle.jbo.Transaction trans, java.lang.Object ctx) Internal: Applications should not use this method.
static void	setStructAttribute(oracle.jbo.AttributeList inAttrList, oracle.jbo.StructureDef inStructDef, java.lang.String fullAttrName, java.lang.Object value)
void	syncClientLob(oracle.jbo.domain.LobInterface old)
void	syncServerLob(oracle.jbo.domain.LobInterface old)
oracle.sql.Datum	toDatum(oracle.jdbc.driver.OracleConnection conn) Internal: Applications should not use this method.
oracle.sql.Datum	toDatum(oracle.jdbc.OracleConnection conn) Internal: Applications should not use this method.
java.lang.String	toString() Internal: Applications should not use this method.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

mData

protected java.lang.Object mData

Internal: Applications should not use this field.

mConnection

protected java.lang.Object mConnection

Internal: Applications should not use this field.

mTxn

protected oracle.jbo.Transaction mTxn

Internal: Applications should not use this field.

mContext

protected com.sun.java.util.collections.HashMap mContext

Internal: Applications should not use this field.

mOwnerAttrIndex

protected int mOwnerAttrIndex

Index of the attribute in the domain owner's container.

mXmlFac

protected oracle.jbo.domain.XMLDomainFactory mXmlFac

The factory object that creates an instance of this STRUCT given an XML element.

mAttrXmlFac

protected oracle.jbo.domain.XMLDomainFactory[] mAttrXmlFac

Factories for each of the attibutes if they have one.

Constructor Detail

Struct

protected Struct()
          throws java.sql.SQLException

Constructs an instance of this class.

Struct

protected Struct(oracle.sql.Datum d)
          throws java.sql.SQLException

Internal: Applications should not use this constructor.

Parameters:

d - a datum object.

Throws:

java.lang.SQLException

java.sql.SQLException

Method Detail

getColumnType

public abstract java.lang.String getColumnType()

Returns the column type of the database column that corresponds to this STRUCT.

Returns:

the column type as a String.

getStructureDef

public abstract oracle.jbo.StructureDef getStructureDef()

Returns the structure definition, that describes the details of the attributes, of this domain.

Returns:

the structure definition as a StructureDef object.

getAttrSQLTypes

public abstract int[] getAttrSQLTypes()

Returns the SQL types for the attributes of the structure.

getAttrCustomDatumFactories

public abstract oracle.sql.CustomDatumFactory[] getAttrCustomDatumFactories()

Returns factories that oracle.sql requires to create the attributes of this structure.

initStructureDef

protected abstract void initStructureDef()

Initializes the structure definition of this object and its attribute definitions.

resolveAndGetStructureDef

public static oracle.jbo.StructureDef resolveAndGetStructureDef(java.lang.Class objectDomainClz)

getData

public java.lang.Object getData()

Internal: Applications should not use this method.

Converts this to a Struct JDBC object.

Specified by:

getData in interface oracle.jbo.domain.DomainInterface

Returns:

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

domainToBeModified

public void domainToBeModified(oracle.jbo.domain.DomainInterface d)

Notification method that this domain calls whenever any of its attribute values are about to be modified. This Domain should always notify its owner.

Specified by:

domainToBeModified in interface oracle.jbo.domain.DomainOwnerInterface

Parameters:

d - the domain being modified.

setContext

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

Internal: Applications should not use this method.

Specified by:

setContext in interface oracle.jbo.domain.DomainInterface

equals

public boolean equals(java.lang.Object obj)

Tests this for equality with another object.

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

Parameters:

obj - an arbitrary Object.

Returns:

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

hashCode

public int hashCode()

Computes a hash code for this StructDomain object.

Returns:

the hash code of this StructDomain object.

toString

public java.lang.String toString()

Internal: Applications should not use this method.

For testing purposes only. Converts this Struct object to a text representation.

Returns:

a String representation of this Struct object.

toDatum

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

Internal: Applications should not use this method.

Converts this Struct Domain object back into an SQL STRUCT object.

Specified by:

toDatum in interface oracle.sql.CustomDatum

Parameters:

conn - OracleConnection Not used.

Returns:

A Datum containing STRUCT object.

Throws:

java.sql.SQLException - Never.

toDatum

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

Internal: Applications should not use this method.

Converts this Struct Domain object back into an SQL STRUCT object.

Parameters:

conn - OracleConnection Not used.

Returns:

A Datum containing STRUCT object.

Throws:

java.sql.SQLException - Never.

getAttribute

public java.lang.Object getAttribute(int index)

Returns the attribute from this StructDomain object, given its index.

Specified by:

getAttribute in interface oracle.jbo.AttributeList

Parameters:

index - index for the attribute in the StructDomain object.

Returns:

an attribute as an Object type.

getAttribute

public java.lang.Object getAttribute(java.lang.String name)

Returns the attribute from this StructDomain object, given its name.

Specified by:

getAttribute in interface oracle.jbo.AttributeList

Parameters:

name - name for the attribute in the StructDomain object.

Returns:

an attribute as an Object type.

setAttribute

public void setAttribute(int index,
                         java.lang.Object value)

Sets the value of an attribute in this StructDomain, at the given index position.

Specified by:

setAttribute in interface oracle.jbo.AttributeList

Parameters:

index - index for the attribute in the StructDomain object.

value - value for the attribute.

getRemoteIdString

public java.lang.String getRemoteIdString()

Specified by:

getRemoteIdString in interface oracle.jbo.domain.LobInterface

setAttributeNoCheck

public void setAttributeNoCheck(int index,
                                java.lang.Object value)

Sets the value of an attribute in this StructDomain object, at the given index position.

Parameters:

index - index for the attribute in the StructDomain object.

value - value for the attribute.

setAttribute

public void setAttribute(java.lang.String name,
                         java.lang.Object value)

Sets the value of an attribute in this StructDomain object, given the attributes's name.

Specified by:

setAttribute in interface oracle.jbo.AttributeList

Parameters:

name - name of the attribute in the StructDomain object.

value - value for the attribute.

getAttributeCount

public int getAttributeCount()

Returns the number of attributes in this StructDomain object.

Specified by:

getAttributeCount in interface oracle.jbo.AttributeList

Returns:

the number of attributes as an int.

getAttributeIndexOf

public int getAttributeIndexOf(java.lang.String name)

Returns the index of a named attribute in this StructDomain object.

Specified by:

getAttributeIndexOf in interface oracle.jbo.AttributeList

Parameters:

name - name of an attribute in this StructDomain object.

Returns:

the index of the named attribute as an int.

buildAttrSQLTypes

public int[] buildAttrSQLTypes()

Returns an array of the SQL datatypes of the attributes in this StructDomain object.

Returns:

an array of SQL datatypes.

marshal

public oracle.svcmsg.ResponseValues marshal()

Specified by:

marshal in interface oracle.jbo.domain.MarshalledDomain

getXMLElementTag

protected java.lang.String getXMLElementTag()

Returns this class name as xml-element tag for this Struct domain object. Override this method to return a custom xml-element tag for this domain.

getAttrXMLElementTag

protected java.lang.String getAttrXMLElementTag(oracle.jbo.AttributeDef ad)

Returns the class name of this domain, appended with the name of the attribute as xml-element tag for this domain-attribute. Override this method to return a custom xml-element tag for the given attribute.

Parameters:

ad - the name of an AttributeDef.

isAttrXMLCData

protected boolean isAttrXMLCData(oracle.jbo.AttributeDef ad)

Returns false always. Override to determine whether the given domain-attribute is to be rendered in CDATA format in xml.

Parameters:

ad - name of an AttributeDef.

getXMLContentNode

public org.w3c.dom.Node getXMLContentNode(org.w3c.dom.Document xmlDoc)

Creates the xml node in the given xml document for this domain's data.

Specified by:

getXMLContentNode in interface oracle.jbo.domain.XMLDomainInterface

Parameters:

xmlDoc - name of the XML document in which the node should be created.

readAttrsFromXML

protected void readAttrsFromXML(org.w3c.dom.Element rowElt)

Reads all the attribute values from the xml-element and sets them into this row. If the xml has a process instruction of the form: then, invokes remove() on this row.

printXMLDefinition

public java.lang.String printXMLDefinition(java.util.Hashtable allDefs,
                                           java.io.PrintWriter pw,
                                           boolean bContainees)

Prints the DTD info for this domain in the given print writer. Returns the DTD string to be added to this domain's container entity/domain.

The allDefs hashtable contains predefined XML definitions and is passed by whatever calls this method.

Specified by:

printXMLDefinition in interface oracle.jbo.domain.XMLDomainInterface

Parameters:

allDefs - a hashtable of predefined XML definitions passed from whatever calls this method.

pw - print writer into which the defnition is being printed.

bContainees - if true, prints definitions of contained objects.

getXMLDomainFactory

public static oracle.jbo.domain.XMLDomainFactory getXMLDomainFactory(java.lang.Class attrClass)

Internal: Applications should not use this method.

initAttrXMLDomainFactories

protected void initAttrXMLDomainFactories(oracle.jbo.AttributeDef[] attrs)

Internal: Applications should not use this method.

loadFromDatabase

public void loadFromDatabase(oracle.jbo.Transaction transaction)
                      throws java.lang.Exception

Internal: Applications should not use this method.

Loads the actual data of the LOB-type database attribute into memory.

The transaction argument is needed to perform an additional query into the database to extract the data.

This method does not need to be invoked for a new attribute.

Specified by:

loadFromDatabase in interface oracle.jbo.domain.BlobDomainInterface

Parameters:

transaction - the oracle.jbo.server.DBTransactionImpl of the current Application Module.

Throws:

java.lang.Exception

saveToDatabase

public void saveToDatabase(oracle.jbo.Transaction transaction)
                    throws java.lang.Exception

Internal: Applications should not use this method.

Saves data in memory to a database LOB-type attribute.

The transaction argument is is needed to perform an additional query into the database to write the data.

This method does not need to be invoked if this attribute's data has not changed.

Specified by:

saveToDatabase in interface oracle.jbo.domain.BlobDomainInterface

Parameters:

transaction - the oracle.jbo.server.DBTransactionImpl instance of the current Application Module.

Throws:

java.lang.Exception

saveToDatabase

public void saveToDatabase(oracle.jbo.Transaction transaction,
                           java.lang.Object postedSQLObject)
                    throws java.lang.Exception

Internal: Applications should not use this method.

Uses the given transaction context to store data back into the database using the LOB-locator which should be set before this method is invoked.

Specified by:

saveToDatabase in interface oracle.jbo.domain.BlobDomainInterface

Throws:

java.lang.Exception

prepareForDML

public void prepareForDML(java.lang.Object context)

Specified by:

prepareForDML in interface oracle.jbo.domain.BlobDomainInterface

syncClientLob

public void syncClientLob(oracle.jbo.domain.LobInterface old)

Specified by:

syncClientLob in interface oracle.jbo.domain.LobInterface

syncServerLob

public void syncServerLob(oracle.jbo.domain.LobInterface old)

Specified by:

syncServerLob in interface oracle.jbo.domain.LobInterface

getOwner

public oracle.jbo.domain.DomainOwnerInterface getOwner()

Specified by:

getOwner in interface oracle.jbo.domain.LobInterface

getOwnerAttributeIndex

public int getOwnerAttributeIndex()

Specified by:

getOwnerAttributeIndex in interface oracle.jbo.domain.LobInterface

getOwnerRow

protected oracle.jbo.domain.DomainOwnerInterface getOwnerRow()

getSize

public long getSize()

Specified by:

getSize in interface oracle.jbo.domain.LobInterface

setStructAttribute

public static void setStructAttribute(oracle.jbo.AttributeList inAttrList,
                                      oracle.jbo.StructureDef inStructDef,
                                      java.lang.String fullAttrName,
                                      java.lang.Object value)

getStructAttribute

public static java.lang.Object getStructAttribute(oracle.jbo.AttributeList inAttrList,
                                                  oracle.jbo.StructureDef inStructDef,
                                                  java.lang.String fullAttrName)

fillObjectAttributeDefs

public static void fillObjectAttributeDefs(oracle.jbo.AttributeList al,
                                           oracle.jbo.StructureDef def,
                                           java.lang.String[] attrNames,
                                           oracle.jbo.AttributeDef[] ads)

getAttributeNames

public java.lang.String[] getAttributeNames()

Specified by:

getAttributeNames in interface oracle.jbo.AttributeList

getAttributeValues

public java.lang.Object[] getAttributeValues()

Specified by:

getAttributeValues in interface oracle.jbo.AttributeList