oracle.toplink.remote
Class RemoteSession

java.lang.Object
  oracle.toplink.internal.sessions.AbstractSession
      oracle.toplink.remote.DistributedSession
          oracle.toplink.remote.RemoteSession

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, CommandProcessor, Session

public class RemoteSession
extends DistributedSession

Purpose: Provide transparent remote three-tiered replacation support. The remote session allows for complex three-tiered applications to be easily built. It gives the remote client the fully functionality of the TopLink api including,

• Client side caching and object-identity maintainence.
• Complex query support
• Unit of work support
• Indirection support through remote value holders.

This session is a primary interface which resides on the client side. Users would interact with session just the same way as if it was a normal session.

See Also:

Serialized Form

Field Summary

Fields inherited from interface oracle.toplink.remotecommand.CommandProcessor

LOG_DEBUG, LOG_ERROR, LOG_INFO, LOG_WARNING

Constructor Summary

RemoteSession(oracle.toplink.internal.remote.RemoteConnection remoteConnection)
Creates a RemoteSession.

Method Summary

oracle.toplink.internal.sessions.UnitOfWorkImpl	acquireUnitOfWork() Return a unit of work for this session.
java.lang.Object	executeQuery(DatabaseQuery query) Execute the database query.
Login	getDatasourceLogin() Return the login.
DatabaseLogin	getLogin() Deprecated. replaced by getDatasourceLogin()
void	initializeSequencing() ADVANCED: Creates sequencing object for the session.
void	setShouldEnableDistributedIndirectionGarbageCollection(boolean shouldEnableDistributedIndirectionGarbageCollection) ADVANCED: Allow the server-side value holders to be cleaned-up when the client-side value holder finalize.
boolean	shouldEnableDistributedIndirectionGarbageCollection() ADVANCED: Allow the server-side value holders to be cleaned-up when the client-side value holder finalize.

Methods inherited from class oracle.toplink.remote.DistributedSession

beginTransaction, commitTransaction, executeQuery, executeQuery, executeQuery, executeQuery, isConnected, release, rollbackTransaction, toString

Methods inherited from class oracle.toplink.internal.sessions.AbstractSession

addAlias, addQuery, clearIntegrityChecker, clearProfile, compareObjectsDontMatch, config, containsObjectInIdentityMap, containsObjectInIdentityMap, containsQuery, copyObject, copyObject, deleteAllObjects, deleteAllObjects, deleteObject, doesObjectExist, dontLogMessages, executeNonSelectingCall, executeNonSelectingSQL, executeQuery, executeQuery, executeQuery, executeQuery, executeQuery, executeQuery, executeQuery, executeSelectingCall, executeSQL, fine, finer, finest, getActiveSession, getActiveUnitOfWork, getAllFromIdentityMap, getAllFromIdentityMap, getAllFromIdentityMap, getAllQueries, getAsOfClause, getCacheSynchronizationManager, getClassDescriptor, getClassDescriptor, getClassDescriptorForAlias, getCommandManager, getDescriptor, getDescriptorForAlias, getDescriptors, getEjbqlPlaceHolderQueries, getEventManager, getExceptionHandler, getExternalTransactionController, getFromIdentityMap, getFromIdentityMap, getFromIdentityMap, getFromIdentityMap, getFromIdentityMap, getIdentityMapAccessor, getIntegrityChecker, getLog, getLogLevel, getLogLevel, getName, getNextSequenceNumberValue, getProfiler, getProject, getProperties, getProperty, getQueries, getQuery, getQuery, getSessionLog, getWriteLockValue, getWriteLockValue, handleException, handleSevere, hasCacheSynchronizationManager, hasDescriptor, hasExceptionHandler, hasExternalTransactionController, info, initializeAllIdentityMaps, initializeIdentityMap, initializeIdentityMaps, insertObject, isClassReadOnly, isClientSession, isDatabaseSession, isFinalizersEnabled, isInProfile, isInTransaction, isRemoteUnitOfWork, isServerSession, isSessionBroker, isUnitOfWork, keyFromObject, keyFromObject, log, log, log, log, log, log, log, log, log, log, log, logDebug, logDebug, logException, logMessage, logMessage, logMessages, logThrowable, printIdentityMap, printIdentityMaps, putInIdentityMap, putInIdentityMap, putInIdentityMap, putInIdentityMap, readAllObjects, readAllObjects, readAllObjects, readAllObjects, readObject, readObject, readObject, readObject, readObject, refreshAndLockObject, refreshAndLockObject, refreshObject, removeFromIdentityMap, removeFromIdentityMap, removeProperty, removeQuery, removeQuery, setCacheSynchronizationManager, setCommandManager, setDatasourceLogin, setExceptionHandler, setExternalTransactionController, setIntegrityChecker, setIsFinalizersEnabled, setIsInProfile, setLog, setLogin, setLogin, setLogLevel, setName, setProfiler, setProperty, setSessionLog, setSessionLog, setShouldLogMessages, setShouldPropagateChanges, setUseOldCommit, severe, shouldLog, shouldLogMessages, shouldPropagateChanges, updateObject, updateWriteLockValue, updateWriteLockValue, usesExternalTransactionController, usesOldCommit, validateCache, verifyDelete, warning, writeObject

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RemoteSession

public RemoteSession(oracle.toplink.internal.remote.RemoteConnection remoteConnection)

Creates a RemoteSession.

Parameters:

remoteConnection - remote session requires a remote connection. This must be accessed remotely from the client through RMI or CORBA.

Method Detail

setShouldEnableDistributedIndirectionGarbageCollection

public void setShouldEnableDistributedIndirectionGarbageCollection(boolean shouldEnableDistributedIndirectionGarbageCollection)

ADVANCED: Allow the server-side value holders to be cleaned-up when the client-side value holder finalize.

shouldEnableDistributedIndirectionGarbageCollection

public boolean shouldEnableDistributedIndirectionGarbageCollection()

ADVANCED: Allow the server-side value holders to be cleaned-up when the client-side value holder finalize.

acquireUnitOfWork

public oracle.toplink.internal.sessions.UnitOfWorkImpl acquireUnitOfWork()

Return a unit of work for this session. The unit of work is an object level transaction that allows a group of changes to be applied as a unit.

Specified by:

acquireUnitOfWork in interface Session

Specified by:

acquireUnitOfWork in class DistributedSession

See Also:

UnitOfWorkImpl

executeQuery

public java.lang.Object executeQuery(DatabaseQuery query)

Execute the database query.

Specified by:

executeQuery in interface Session

Specified by:

executeQuery in class DistributedSession

See Also:

DatabaseQuery

getLogin

public DatabaseLogin getLogin()

Deprecated. replaced by getDatasourceLogin()

OBSOLETE: Return the login, the login holds any database connection information given. This has been replaced by getDatasourceLogin to make use of the Login interface to support non-relational datasources, if DatabaseLogin API is required it will need to be cast.

Specified by:

getLogin in interface Session

Overrides:

getLogin in class oracle.toplink.internal.sessions.AbstractSession

getDatasourceLogin

public Login getDatasourceLogin()

Return the login. This must retreive the login information from the server this first time called. This is useful to be able to do things differently depending on the database platform.

Specified by:

getDatasourceLogin in interface Session

Overrides:

getDatasourceLogin in class oracle.toplink.internal.sessions.AbstractSession

initializeSequencing

public void initializeSequencing()

ADVANCED: Creates sequencing object for the session. Typically there is no need for the user to call this method - it is called from the constructor.