|
SilverStream Application Server 3.5 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JPanel | +--com.sssw.rt.atlas.AtPanel | +--com.sssw.rt.atlas.AtCanvas | +--com.sssw.rt.form.PvBaseCanvas | +--com.sssw.rt.form.PvInvisibleControlBase | +--com.sssw.rt.form.AgcData
This invisible control allows users access to a data set that is independent of the rest of the form.
By default, all SilverStream forms are bound to a primary dataset. The binding occurs through an instance variable on the form called agData.
Multiple datasets are permitted on a single form by adding as many AgcData
controls to the form as there are datasets to be accessed. Note that any operations
that attempt to change the database contents
(such as delete()
) or the database structure (such as 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, and when
updateRows()
is called, all of the database requests are submitted to the
database server. All of the database requests must succeed; if any one fails
all requests will be discarded and an exception is thrown.
Note: The ancestor methods in this class, that is all methods inherited from the non-public PvInvisibleControlBase (including JComponent and Component) are not visible at run time, and are primarily for use by SilverStream. The useful methods are contained in the AgcData class itself.
Inner classes inherited from class javax.swing.JPanel |
JPanel.AccessibleJPanel |
Inner classes inherited from class javax.swing.JComponent |
JComponent.AccessibleJComponent |
Fields inherited from class com.sssw.rt.atlas.AtPanel |
BGIMAGE_DRAW_CENTERED,
BGIMAGE_DRAW_NORMAL,
BGIMAGE_DRAW_STRETCH,
BGIMAGE_DRAW_TILED |
Fields inherited from class javax.swing.JComponent |
accessibleContext,
listenerList,
TOOL_TIP_TEXT_KEY,
ui,
UNDEFINED_CONDITION,
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT,
WHEN_FOCUSED,
WHEN_IN_FOCUSED_WINDOW |
Fields inherited from class java.awt.Component |
BOTTOM_ALIGNMENT,
CENTER_ALIGNMENT,
LEFT_ALIGNMENT,
RIGHT_ALIGNMENT,
TOP_ALIGNMENT |
Fields inherited from interface com.sssw.rt.util.AgiRowCursor |
BANDNAME,
ORDINAL |
Constructor Summary | |
AgcData()
|
Method Summary | |
Object |
invokeQuery(Object param)
Invokes the business object for which this AgcData is the proxy. |
void |
setDataSource(String busObjSpec)
Lets you programmatically switch the source of data for the AgcData control at runtime. |
Methods inherited from class com.sssw.rt.form.PvInvisibleControlBase |
setBounds,
setLocation,
setSize |
Methods inherited from class com.sssw.rt.form.PvBaseCanvas |
getBackgroundColor,
getFontIdentifier,
setBackgroundColor,
setFontIdentifier |
Methods inherited from class com.sssw.rt.atlas.AtPanel |
addImpl,
addNotify,
clientPaint,
clientPaint,
deliverMouseEvent,
deliverMouseMoveEvent,
doAtCommand,
drawTiledImage,
enableAtCommands,
getBackgroundImage,
getBackgroundImageMode,
getHelper,
getTransparent,
hide,
hideToolTip,
imageUpdate,
isFocusTraversable,
isOptimizedDrawingEnabled,
ownedImage,
paintBorder,
paintComponent,
paintImmediately,
paintImmediately,
paintNow,
preprocessKeyEvent,
processEvent,
reshape,
setBackgroundImage,
setBackgroundImageMode,
setTransparent,
show,
showToolTip |
Methods inherited from class javax.swing.JPanel |
getAccessibleContext,
getUIClassID,
paramString,
updateUI |
Methods inherited from class java.awt.Container |
add,
add,
add,
add,
add,
addContainerListener,
countComponents,
deliverEvent,
doLayout,
findComponentAt,
findComponentAt,
getComponent,
getComponentAt,
getComponentAt,
getComponentCount,
getComponents,
getLayout,
insets,
invalidate,
isAncestorOf,
layout,
list,
list,
locate,
minimumSize,
paintComponents,
preferredSize,
printComponents,
processContainerEvent,
remove,
remove,
removeAll,
removeContainerListener,
setCursor,
setLayout,
validate,
validateTree |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
Methods implemented from interface com.sssw.rt.form.AgiControl |
getComponent,
getHelpInfo,
setHelpInfo |
Methods implemented from interface com.sssw.rt.util.AgiRowCursor |
addAgiRowCursorListener,
allowsChildren,
appendChild,
copy,
delete,
getProperty,
getProperty,
getPropertyCount,
getPropertyIndex,
getPropertyName,
getRowSetEventProducer,
gotoChild,
gotoFirst,
gotoLast,
gotoNext,
gotoParent,
gotoPrevious,
gotoRoot,
hasChildren,
insertAfter,
insertBefore,
makePrimaryVersion,
removeAgiRowCursorListener,
setProperty,
setProperty |
Methods implemented from interface com.sssw.rt.util.AgiRowCursorSort |
rowCursorSort |
Methods implemented from interface com.sssw.rt.util.AgiRowCursorViewSupport |
getChildEntryCount,
getDisplayEntryNumber,
setDisplayEntryNumber |
Methods implemented from interface com.sssw.rt.util.AgiRowSetEventProducer |
addAgiRowSetListener,
removeAgiRowSetListener |
Methods implemented from interface com.sssw.rt.util.AgiRowSetManager |
clearRows,
haveRowsChanged,
query,
query,
refreshRows,
updateRows |
Constructor Detail |
public AgcData()
Method Detail |
public void setDataSource(String busObjSpec)
busObjSpec
- the name of the data source object, including its package name.You might do some data binding to an AgcData and then switch from one data source to another one that has the same fields, but different selection criteria or a different actual source of data.
You invoke the data source object by calling AgcData.invokeQuery()
.
agcData1.setDataSource("com.myco.mydept.CustomerDataSource");
public Object invokeQuery(Object param) throws Exception
param
- an argument passed to the business object.If this call succeeds, initialize the AgcData object with the resulting data source.
If the business object throws an exception this method will throw it as well.
try { agcData1.invokeQuery(custID.getIntegerValue()); } catch (Exception e) { agDialog.displayError(e); }
|
SilverStream Application Server 3.5 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |