Application Server 3.5
Class AgpData

All Implemented Interfaces:
AgiPageControl, AgiRowCursor, AgiRowCursorSort, AgiRowCursorViewSupport, AgiRowSetEventProducer, AgiRowSetListener, AgiRowSetManager, Cloneable, Serializable
Direct Known Subclasses:

public class AgpData
extends AgoData
implements AgiPageControl, Serializable

This invisible control allows users access to a data set that is independent of the rest of the page.

By default, all SilverStream pages are bound to a primary dataset. The binding occurs through an instance variable on the page called agData.

To support access to multiple datasets on a single page, simply add as many AgpData controls to a page as there are datasets to access. Note that any operations that attempt to change the database contents (e.g., delete()) or the database structure (e.g., appendChild()) are not committed to the database until the updateRows() method is called. During the session, SilverStream saves all of these changes in a buffer, when updateRows() is called, all of the database requests are submitted to the database server.

All of the database requests must succeed, or they are all discarded and SilverStream throws an exception.

Automatic Query, Business Object Name, Column Expressions, Distinct, Limit Rows, Load Data, Maximum Rows, Name, Order By, Table, Where Clause
cursorChanged, cursorPreChange, dataReceivedAsync, dataReloaded, rowDataChanged, rowDeleted, rowInserted, rowPreDelete, rowPreInsert
See Also:
AgcData, Serialized Form

Fields inherited from class com.sssw.rt.util.AgoRowCursor
Constructor Summary
Method Summary
 Serializable invokeQuery(Serializable param)
          Invoke the business object for which this AgpData is the proxy.
Methods inherited from class com.sssw.rt.util.AgoData
close, setDataSource
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
generateHTML, getPrefix, notifyPageLoaded, notifyPageRequestBegin, notifyPageRequestEnd, notifyPostValue, notifyPostValues
Methods implemented from interface com.sssw.rt.util.AgiRowCursorSort
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


public AgpData()
Method Detail


public Serializable invokeQuery(Serializable param)
                         throws Exception
Invoke the business object for which this AgpData is the proxy.
param - an argument passed to the business object

If this call succeeds, initialize the AgcData object with the resulting data source.

See Also:
Business Object Name property, Load Data property

Application Server 3.5