atg.rview
Class RelationalViewManager

java.lang.Object
  atg.rview.RelationalViewManager

All Implemented Interfaces:

CacheInvalidationListener, java.util.EventListener

Direct Known Subclasses:

RelationalViewManagerImpl

public abstract class RelationalViewManager
extends java.lang.Object
implements CacheInvalidationListener

This represents the central service that controls all of the RelationalViews for an application. It provides access to the "top-level" RelationalViews in the system, and also provides transaction support.

Field Summary

static java.lang.String

CLASS_VERSION

Constructor Summary

RelationalViewManager()

Method Summary

abstract void	commit() Commits any operations performed by this Thread since the last commit or rollback, releasing any Connection resources, and committing any cache invalidations that have occurred as a result of the committed operations.
abstract CacheInfo	getCacheInfo() Returns a CacheInfo describing the runtime state of the internal caches.
abstract java.sql.Connection	getConnection() Obtains the JDBC connection that is being used by the current Thread.
abstract DefinitionFile	getDefinitionFile() Returns the DefinitionFile that defines all of the RelationalViews and ResultSetProcessors used by the RelationalViewManager.
abstract RelationalView	getRelationalView(java.lang.String pRelationalViewName) Returns the RelationalView with the given name, or null if there is no such RelationalView.
abstract ResultSetProcessor	getResultSetProcessor(java.lang.String pResultSetProcessorName) Returns the ResultSetProcessor with the given name, or null if there is no such ResultSetProcessor.
abstract void	rollback() Cancels any operations performed by this Thread since the last commit or rollback, releasing any Connection resources.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface atg.rview.CacheInvalidationListener

invalidateAllCaches, invalidateCache, invalidateCacheEntries, invalidateCacheEntry, invalidateCachesByTableName

Field Detail

CLASS_VERSION

public static java.lang.String CLASS_VERSION

Constructor Detail

RelationalViewManager

public RelationalViewManager()

Method Detail

getDefinitionFile

public abstract DefinitionFile getDefinitionFile()

Returns the DefinitionFile that defines all of the RelationalViews and ResultSetProcessors used by the RelationalViewManager.

getRelationalView

public abstract RelationalView getRelationalView(java.lang.String pRelationalViewName)

Returns the RelationalView with the given name, or null if there is no such RelationalView.

getResultSetProcessor

public abstract ResultSetProcessor getResultSetProcessor(java.lang.String pResultSetProcessorName)

Returns the ResultSetProcessor with the given name, or null if there is no such ResultSetProcessor.

commit

public abstract void commit()
                     throws java.sql.SQLException

Commits any operations performed by this Thread since the last commit or rollback, releasing any Connection resources, and committing any cache invalidations that have occurred as a result of the committed operations.

Throws:

java.sql.SQLException

rollback

public abstract void rollback()
                       throws java.sql.SQLException

Cancels any operations performed by this Thread since the last commit or rollback, releasing any Connection resources.

Throws:

java.sql.SQLException

getConnection

public abstract java.sql.Connection getConnection()
                                           throws java.sql.SQLException

Obtains the JDBC connection that is being used by the current Thread. Applications may obtain this connection to perform any JDBC operations that are not covered by relational views (such as accessing the database metadata).

Applications should avoid calling commit, rollback, or close on the Connection. Instead, the application should call commit or rollback on the RelationalViewManager, which will automatically take care of the Connection.

Throws:

java.sql.SQLException

getCacheInfo

public abstract CacheInfo getCacheInfo()

Returns a CacheInfo describing the runtime state of the internal caches.