com.sssw.shr.page
Class AgpData

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

All Implemented Interfaces:

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

Direct Known Subclasses:

AgpDataPrimary

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.

Properties:

Automatic Query, Business Object Name, Column Expressions, Distinct, Limit Rows, Load Data, Maximum Rows, Name, Order By, Table, Where Clause

Events:

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

See Also:

AgcData, Serialized Form

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

m_cursor

Constructor Summary

AgpData()

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 com.sssw.shr.page.AgiPageControl

generateHTML, getPrefix, notifyPageLoaded, notifyPageRequestBegin, notifyPageRequestEnd, notifyPostValue, notifyPostValues

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

AgpData

public AgpData()

Method Detail

invokeQuery

public Serializable invokeQuery(Serializable param)
                         throws Exception

Invoke the business object for which this AgpData is the proxy.

Parameters:

param - an argument passed to the business object

Usage:

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

Example:

 		agpData1.invokeQuery(custID.getText());
 

See Also:

Business Object Name property, Load Data property