|
SilverStream Application Server 3.5 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Abstraction of an in-progress update request on one or more data sources. The update request gathers inserted/modified/deleted rows, and then atomically (or as atomically as possible, if the rows span multiple databases), executes the updates against the database. It's legal to close the update request with outstanding updates, in which case the pending updates are discarded. This is a part of the low-level API for accessing and updating row-based data sources; see AgiDataSource for more information.
Ordinarily, most data source implementors will not provide their own implementation "from scratch" of the AgiDataUpdateRequest interface; instead, they will provide a class that extends the abstract class AgoDataUpdateRequest, which performs the mechanics of handling the update rows.
AgiDataSource
,
AgiDataRow
,
AgoDataUpdateRequest
Method Summary | |
void |
close()
Close the update request, discarding any pending changes. |
void |
deleteRow(AgiDataSource dataSource,
AgiDataRow row)
Delete the specified data row for the specified data source. |
Enumeration |
executeAllUpdates()
Execute the updates as atomically as possible. |
void |
insertRow(AgiDataSource dataSource,
AgiDataRow row)
Insert the specified data row for the specified data source. |
void |
makePrimaryRow(AgiDataSource dataSource,
AgiDataRow row)
Make the specified data row the primary version for the specified data source. |
void |
updateRow(AgiDataSource dataSource,
AgiDataRow oldRow,
AgiDataRow newRow)
Update the specified data row for the specified data source. |
Method Detail |
public void insertRow(AgiDataSource dataSource, AgiDataRow row) throws AgoApiException
dataSource
- The data source for the rowrow
- The data row to be insertedpublic void deleteRow(AgiDataSource dataSource, AgiDataRow row) throws AgoApiException
dataSource
- The data source for the rowrow
- The data row to be insertedpublic void updateRow(AgiDataSource dataSource, AgiDataRow oldRow, AgiDataRow newRow) throws AgoApiException
Note that the newRow will be sparse -- that is, only columns that were modified by the client are present.
dataSource
- The data source for the rowoldRow
- The old values of the data row to be updatednewRow
- The new values of the data row to be updatedpublic void makePrimaryRow(AgiDataSource dataSource, AgiDataRow row) throws AgoApiException
dataSource
- The data source for the rowrow
- The data row to be made primarypublic void close()
public Enumeration executeAllUpdates() throws AgoApiException
|
SilverStream Application Server 3.5 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |