Method index | Bottom


Class: symantec.itools.db.pro.MultiView

Purpose Represents a MultiView.
Hierarchy java.lang.Object
|
+----symantec.itools.db.pro.MultiView
Syntax public class MultiView
extends Object
Description MultiView is a container class for the dbANYWHERE database transaction object. A MultiView contains a transaction's RelationViews.

To interact with a dbANYWHERE Server, you do not have to interface directly with a MultiView object. However, a MultiView object can be useful to global transactions that have a handle to a MultiView object.

The RelationView class can encapsulate a MultiView object. For example, RelationView.saveMultiView( ) translates to MultiView.save( ) for the RelationView's parent MultiView.

See also RelationView


Method Index

Top | Bottom


close( )
oCloses a MultiView.
getRootRelView( )
oReturns a MultiView's root RelationView.
isDataChanged( )
oIndicates whether or not a MultiView's data changed.
restart( )
oRestarts a MultiView.
restart( String newWhereClause )
oRestarts a MultiView after modifying the root RelationView's SQL select statement with the newWhereClause.
save( )
oSaves a MultiView's data changes.
undoDataChanges( )
oUndoes a MultiView's data changes.


Methods

Method index | Top | Bottom


Method: close

Purpose Closes a MultiView.
Syntax public synchronized void close( ) throws SQLException
Parameters None.
Description Close down and release all resources associated with a runtime version of the MultiView object.


Method: getRootRelView

Purpose Returns a MultiView's root RelationView.
Syntax public RelationView getRootRelView( ) throws SQLException
Parameters None.
Description Returns a MultiView's root (ultimate parent) RelationView.
See also RelationView


Method: isDataChanged

Purpose Indicates whether or not a MultiView's data changed.
Syntax public boolean isDataChanged( ) throws SQLException
Parameters None.
Description Indicates whether or not a MultiView's data has changed. True = The MultiView's data has changed. False = The MultiView's data has not changed.


Method: restart

Purpose Restarts a MultiView.
Syntax public void restart( ) throws SQLException
Parameters None.
Description Restarts a MultiView by doing the following:
oIncorporating the last save's changes.
oIncorporating the database's external changes.
oRewinding all views (i.e., resetting each view's database cursor to the beginning of the view).
oReleasing all cached data.

The dbANYWHERE Server restarts a MultiView each time it has been successfully saved.

See also save


Method: restart

Purpose Restarts a MultiView.
Syntax public void restart( String newWhereClause ) throws SQLException
Parameters String newWhereClause = newWhereClause to be inserted in the root RelationView's SQL select statement.
Description Restarts a MultiView by doing the following:
oIncorporating the last save's changes.
oIncorporating the database's external changes.
oRewinding all views (i.e., resetting each view's database cursor to the beginning of the view).
oReleasing all cached data.
Modifying the rootRelationView's SQL select statement with the newWhereClause

The dbANYWHERE Server restarts a MultiView each time it has been successfully saved.

See also save


Method: save

Purpose Saves a MultiView's data changes.
Syntax public void save( ) throws SQLException
Parameters None.
Description Execute a transaction to store all of the data changes in the MultiView to the backend database. This method encapsulates all of the functionality associated with storing the data changes to the backend database. The developer does not need to concern themselves with Insert, Update, or Delete statement generation like in other APIs.
See also restart

restart( String newWhereClause )


Method: undoDataChanges

Purpose Undoes a MultiView's data changes.
Syntax public void undoDataChanges( ) throws SQLException
Parameters None.
Description Changes a MultiView's data back to the data that was loaded from the backend database(s) when the MultiView started.


Method index | Top

Copyright © 1996 Symantec Corporation. All rights reserved.