com.sssw.rt.util
Class AgoData

java.lang.Object
 |
 +--com.sssw.rt.util.AgoRowCursor
       |
       +--com.sssw.rt.util.AgoData

All Implemented Interfaces:

AgiRowCursor, AgiRowCursorSort, AgiRowCursorViewSupport, AgiRowSetEventProducer, AgiRowSetListener, AgiRowSetManager, Cloneable

Direct Known Subclasses:

AgaData, AgpData, AgrData

public class AgoData

extends com.sssw.rt.util.AgoRowCursor

implements AgiRowSetManager, AgiRowCursorSort, AgiRowSetListener, AgiRowCursor

Internal SilverStream class.

AgoData is the base class for data objects for forms, pages, business objects, etc. It is an AgoRowCursor (implements AgiRowCursor) with the following extensions:

• It knows about its own datastore. By implementing TableDataStoreUser it can initialize its own datastore. It also implements AgiRowSetManager for manipulating the rows of the datastore.
• It fires events when it moves to a new row or when a property is changed.
• Optionally, instead of providing direct access to the properties of the underlying cursor, it provides properties whose values are expressions on the underlying data cursor. For this it is initialized with an AgiGetValue and a set of expression IDs.
• Alternately, it can provide direct access to the properties of the underlying cursor, but with specified names for each column.

Fields inherited from class com.sssw.rt.util.AgoRowCursor

m_cursor

Fields inherited from interface com.sssw.rt.util.AgiRowCursor

BANDNAME, ORDINAL

Constructor Summary

AgoData()

Method Summary

void	close() Close the data cache object, discarding all rows.
void	setDataSource(String busObjSpec) Specify that instead of using a relational data table, this AgcData object should act as a proxy to a data-source business object (DSO).

Methods inherited from class com.sssw.rt.util.AgoRowCursor

addAgiRowCursorListener, addAgiRowSetListener, allowsChildren, appendChild, copy, cursorChanged, cursorPreChange, delete, equals, getChildEntryCount, getCursor, getDisplayEntryNumber, getProperty, getProperty, getPropertyCount, getPropertyIndex, getPropertyName, getRowSetEventProducer, gotoChild, gotoFirst, gotoLast, gotoNext, gotoParent, gotoPrevious, gotoRoot, hasChildren, insertAfter, insertBefore, makePrimaryVersion, removeAgiRowCursorListener, removeAgiRowSetListener, setCursor, setDisplayEntryNumber, setProperty, setProperty, setRowCursorSupport, setRowSetSupport, validateCursor

Methods inherited from class java.lang.Object

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

Methods implemented from interface com.sssw.rt.util.AgiRowCursorSort

rowCursorSort

Methods implemented from interface com.sssw.rt.event.AgiRowSetListener

dataReceivedAsync, dataReloaded, rowDataChanged, rowDeleted, rowInserted, rowPreDelete, rowPreInsert

Methods implemented from interface com.sssw.rt.util.AgiRowSetManager

clearRows, haveRowsChanged, query, query, refreshRows, updateRows

Constructor Detail

AgoData

public AgoData()

Method Detail

setDataSource

public void setDataSource(String busObjSpec)

Specify that instead of using a relational data table, this AgcData object should act as a proxy to a data-source business object (DSO). The DSO is invoked by a call to the invokeQuery() method.

close

public void close()
           throws AgoException

Close the data cache object, discarding all rows. Any changes that have not been commited will be lost. No future operations on the data cache object will be allowed.

Usage:

A data cache that is currently bound to a control on a form, view, or page should not be closed -- such a data cache will be closed automatically when its containing form, view, or page is closed.