oracle.dacf.dataset
Class RowSetInfo

java.lang.Object
  oracle.dacf.dataset.DacObject
      oracle.dacf.dataset.ProducerObject
          oracle.dacf.dataset.InfoObject
              oracle.dacf.dataset.ResultSetInfo
                  oracle.dacf.dataset.RowSetInfo

All Implemented Interfaces:

java.lang.Cloneable, oracle.dacf.dataset.QueryCriteriaStoreListener

public class RowSetInfo

extends ResultSetInfo

This class contains all of the dataset specific properties and validators. It also collects and establishes all master-detail relationships.

Version:

SDK

Field Summary

Fields inherited from class oracle.dacf.dataset.ResultSetInfo

_SPECIAL_ATTR_CNT, _viewObj, CURMSG_ATTR_NAME, CURROW_ATTR_NAME, DEFAULT_BUFFER_SIZE, DEFAULT_QUERYCRITERIA_ATTR_NAME, ERR_PROD_CODE, HIGH_ATTR_NAME, MODIFIED_ATTR_NAME, QUERYCRITERIA_ATTR_NAME, ROWCNT_ATTR_NAME

Fields inherited from class oracle.dacf.dataset.InfoObject

_updateMode, LEVEL_APPLICATION, LEVEL_ATTRIBUTE, LEVEL_COLUMN, LEVEL_QUERY_VIEW, LEVEL_ROOT, LEVEL_ROW, LEVEL_ROWSET, LEVEL_SESSION, PROPERTIES_COLUMN_NAME, UPDATEABLE_FALSE, UPDATEABLE_MAX_VAL, UPDATEABLE_TRUE, UPDATEABLE_UNDEFINED

Fields inherited from class oracle.dacf.dataset.ProducerObject

_openLock

Fields inherited from class oracle.dacf.dataset.DacObject

EMPTY_PREFIX, INITIAL_CAPACITY, ITEMNAME_DELIMITER

Constructor Summary

	RowSetInfo()
protected	RowSetInfo(java.lang.String name, oracle.jbo.ViewObject vuObj)
protected	RowSetInfo(oracle.jbo.ViewObject vuObj)

Method Summary

void	addAttribute(AttributeInfo attr) Add a column to the RowSetInfo so that it can be used.
void	addMasterLink(MasterLink link) Adds a master RowSetInfo for this RowSetInfo.
java.lang.Object	clone() Creates a deep copy of the ResultSetInfo, including the children.
protected void	createAssociation() Establish the master-detail associations.
protected void	destroyAssociation() Remove the master-detail associations.
MasterLink	getMasterLinkInfo() Return the first master associated with this rowset.
MasterLink[]	getMasterLinkList() Return a list of all masters for the Rowset.
java.lang.String	getName() Returns the name of the DacObject.
protected void	internalValidation(int eventLevel) Internal: Applications should not use this method.
void	openRowSet(boolean openChildren) Sets up the RowSetInfo for use by: connect to the server-side ApplicationModule if defined connect to the server-side RowSet executes open() on all child ColumnInfo It throws an IllegalStateException exception if required properties aren't set.
void	publishRowSet() Publishes the RowSet and its child items on the InfoBus.
void	publishRowSet(boolean activate) Deprecated. Use publishRowSet()
void	removeMasterLink(MasterLink link) Removes a RowSetInfo as a master of RowSetInfo.
void	revokeRowSet() Revokes the RowSet and its child items on the InfoBus.
void	setMasterLinkInfo(MasterLink info) Set the Master RowSetInfo for this RowSetInfo.
void	setMasterLinkList(MasterLink[] list) Sets all of the masters for the Rowset
void	setName(java.lang.String st) Sets the InfoBus bind name of the object.
void	validate() Internal: Applications should not use this method.

Methods inherited from class oracle.dacf.dataset.ResultSetInfo

addAttribute, addQueryListener, attributeChanged, closeCheck, closeChildren, closeDataItems, closeProducerObject, createChild, createDynamicAttribute, createDynamicAttributeInternal, executeQuery, findViewLinks, getAttribute, getAttribute, getAttributeCount, getAttributeInfo, getChildIndex, getDataItem, getQueryCondition, getQueryConditionParams, getQueryCriteria, getQueryInfo, getQueryListeners, getQueryOnOpen, getQueryOrderbyClause, getRangeSize, getRowsetAccess, getSession, getViewObject, isSpecialItemName, isUpdateable, mapRowsetAccess, navigated, open, openChildren, openDataItems, openProducerObject, openRowSet, removeAttribute, removeQueryListener, rowsAdded, rowsChanged, rowsDeleted, setAttributeInfo, setQueryCondition, setQueryConditionParams, setQueryCriteria, setQueryInfo, setQueryOnOpen, setQueryOrderbyClause, setRangeSize, setSession, setViewObject

Methods inherited from class oracle.dacf.dataset.InfoObject

addChangeListener, addValidationListener, areParentsValid, clearDirty, fireValidationEvent, forceValid, getChangeListeners, getLocale, getUpdateMode, getValidationListeners, isActive, isDirty, isValid, processValidationEvent, removeChangeListener, removeValidationListener, setActive, setDirty, setLocale, setUpdateable, setValid, toString, validate, validate

Methods inherited from class oracle.dacf.dataset.ProducerObject

addChild, addClonedDataItem, close, findDataItem, findProducerObject, findProducerObject, getClonedDataItems, getDataItemImpl, getDataProducer, getDataSourceName, getFullName, isAClonedDataItem, isOpen, publishDataItem, publishDataItem, removeChild, removeClonedDataItem, revokeDataItem, setClonedDataItems, setDataItem, setDataSourceName, setOpen

Methods inherited from class oracle.dacf.dataset.DacObject

addChild, findDescendant, genCloneName, getChild, getChildren, getNumOfChildren, getParent, getPrefix, insertChildAt, removeChild, removeChildren, setChildren, setParent, setPrefix

Methods inherited from class java.lang.Object

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

Constructor Detail

RowSetInfo

public RowSetInfo()

RowSetInfo

protected RowSetInfo(oracle.jbo.ViewObject vuObj)

Parameters:

vuObj - The server-side BC4J ViewObject used by the RowSetInfo

RowSetInfo

protected RowSetInfo(java.lang.String name,
                     oracle.jbo.ViewObject vuObj)

Parameters:

name - The InfoBus bind name for the RowSetInfo

vuObj - The server-side BC4J ViewObject used by the RowSetInfo

Method Detail

clone

public java.lang.Object clone()

Description copied from class: ResultSetInfo

Creates a deep copy of the ResultSetInfo, including the children. It also clones the QueryInfo/QueryViewInfo and causes JBO to create a new ViewObject using the cloned QueryInfo/QueryViewInfo.

Overrides:

clone in class ResultSetInfo

setName

public void setName(java.lang.String st)

Description copied from class: ProducerObject

Sets the InfoBus bind name of the object.

Overrides:

setName in class ProducerObject

Parameters:

st - the InfoBus bind name.

getName

public java.lang.String getName()

Description copied from class: DacObject

Returns the name of the DacObject.

Overrides:

getName in class DacObject

Returns:

the name of the DacObject.

setMasterLinkInfo

public void setMasterLinkInfo(MasterLink info)

Set the Master RowSetInfo for this RowSetInfo. Deprecated: please use addMasterLink(). Using this method has the side effect of clearing the existing list of MasterLink objects and initializing it to contain only the specified MastetLink object.

See Also:

addMasterLink(MasterLink info)

getMasterLinkInfo

public MasterLink getMasterLinkInfo()

Return the first master associated with this rowset. Deprecated: uses getMasterLinkList()

See Also:

getMasterLinkList()

addMasterLink

public void addMasterLink(MasterLink link)

Adds a master RowSetInfo for this RowSetInfo.

MasterLink can only be added to a RowsetInfo prior to it being opened. If one attempts to add a MasterLink to a RowsetInfo after it is opened then a DataSourceOperationException is thrown.

Parameters:

link - The MasterLink describing a master for the RowsetInfo

removeMasterLink

public void removeMasterLink(MasterLink link)

Removes a RowSetInfo as a master of RowSetInfo.

MasterLink can only be removed from a RowsetInfo prior to it being opened. If one attempts to remove a MasterLink from a RowsetInfo after it is opened then a DataSourceOperationException is thrown.

Parameters:

link - The MasterLink describing a master for the RowsetInfo

getMasterLinkList

public MasterLink[] getMasterLinkList()

Return a list of all masters for the Rowset. Allows one to retrieve all of the master RowsetInfos for a RowsetInfo. The returned array will contain the appropriate subclass of MasterLink objects.

Returns:

the list of MasterLink objects specifying the masters

setMasterLinkList

public void setMasterLinkList(MasterLink[] list)

Sets all of the masters for the Rowset

Allows one to setup all of the master RowsetInfos for a RowsetInfo by specifying an array of the appropriate subclass of MasterLink objects.

Parameters:

list - the list of MasterLink objects specifying the masters

addAttribute

public void addAttribute(AttributeInfo attr)

Add a column to the RowSetInfo so that it can be used.

openRowSet

public void openRowSet(boolean openChildren)

Sets up the RowSetInfo for use by:

• connect to the server-side ApplicationModule if defined
• connect to the server-side RowSet
• executes open() on all child ColumnInfo

It throws an IllegalStateException exception if required properties aren't set.

Throws:

java.lang.IllegalStateException - Thrown if open called when required properties are missing.

publishRowSet

public void publishRowSet()

Publishes the RowSet and its child items on the InfoBus. This method will cause the RowSet to be opened if it hasn't been previously opened.

publishRowSet

public void publishRowSet(boolean activate)

Deprecated. Use publishRowSet()

revokeRowSet

public void revokeRowSet()

Revokes the RowSet and its child items on the InfoBus.

See Also:

publishRowSet()

validate

public void validate()
              throws ValidationException

Description copied from class: InfoObject

Internal: Applications should not use this method.

Overrides:

validate in class InfoObject

Throws:

ValidationException

internalValidation

protected void internalValidation(int eventLevel)
                           throws ValidationException

Internal: Applications should not use this method.

Overrides:

internalValidation in class InfoObject

Throws:

ValidationException

createAssociation

protected void createAssociation()

Establish the master-detail associations.

Overrides:

createAssociation in class ResultSetInfo

destroyAssociation

protected void destroyAssociation()

Remove the master-detail associations.

Overrides:

destroyAssociation in class ResultSetInfo