oracle.toplink.remote.rmi.iiop
Class RMIRemoteSessionControllerDispatcher

java.lang.Object
javax.rmi.PortableRemoteObject
oracle.toplink.remote.rmi.iiop.RMIRemoteSessionControllerDispatcher

All Implemented Interfaces:

java.rmi.Remote, RMIRemoteSessionController

public class RMIRemoteSessionControllerDispatcher

extends javax.rmi.PortableRemoteObject

implements RMIRemoteSessionController

RemoteSessionController sits between the remote session and the session. Any interaction between these two classes takes place through this object. As the object extends unicast remote object it listens to only single remote session during runtime.

Constructor Summary

RMIRemoteSessionControllerDispatcher(oracle.toplink.publicinterface.Session session)

RMIRemoteSessionControllerDispatcher(Session session)

Method Summary

oracle.toplink.internal.remote.Transporter	beginTransaction() Begin a transaction on the database.
oracle.toplink.internal.remote.Transporter	commitRootUnitOfWork(oracle.toplink.internal.remote.Transporter remoteUnitOfWork) Remote unit of work after serialization is commited locally.
oracle.toplink.internal.remote.Transporter	commitTransaction() Commit a transaction on the database.
oracle.toplink.internal.remote.Transporter	compareObjects(oracle.toplink.internal.remote.Transporter firstObject, oracle.toplink.internal.remote.Transporter secondObject) TESTING: Return if the two object match completely.
oracle.toplink.internal.remote.Transporter	compareObjectsDontMatch(oracle.toplink.internal.remote.Transporter firstObject, oracle.toplink.internal.remote.Transporter secondObject) TESTING: Return true if the object do not match.
oracle.toplink.internal.remote.Transporter	containsObjectInIdentityMap(oracle.toplink.internal.remote.Transporter domainObject) ADVANCED: Return if their is an object for the primary key.
oracle.toplink.internal.remote.Transporter	containsObjectInIdentityMap(oracle.toplink.internal.remote.Transporter primaryKey, oracle.toplink.internal.remote.Transporter theClass) ADVANCED: Return if their is an object for the primary key.
oracle.toplink.internal.remote.Transporter	cursoredStreamClose(oracle.toplink.internal.remote.Transporter remoteCursoredStreamID) Used for closing cursored streams across RMI.
oracle.toplink.internal.remote.Transporter	cursoredStreamNextPage(oracle.toplink.internal.remote.Transporter remoteCursoredStream, int pageSize) Retrieve next page size of objects from the remote cursored stream
oracle.toplink.internal.remote.Transporter	cursoredStreamSize(oracle.toplink.internal.remote.Transporter remoteCursoredStreamOid) Return the cursored stream size
oracle.toplink.internal.remote.Transporter	cursorSelectObjects(oracle.toplink.internal.remote.Transporter remoteTransporter) Returns a remote cursor stub in a transporter
oracle.toplink.internal.remote.Transporter	executeNamedQuery(oracle.toplink.internal.remote.Transporter nameTransporter, oracle.toplink.internal.remote.Transporter classTransporter, oracle.toplink.internal.remote.Transporter argumentsTransporter) A remote query after serialization is executed locally.
oracle.toplink.internal.remote.Transporter	executeQuery(oracle.toplink.internal.remote.Transporter query) A remote query after serialization is executed locally.
oracle.toplink.internal.remote.Transporter	getDefaultReadOnlyClasses() Get the default read-only classes
oracle.toplink.internal.remote.Transporter	getDescriptor(oracle.toplink.internal.remote.Transporter theClass) Extract descriptor from the session
oracle.toplink.internal.remote.Transporter	getExceptionHandler() PUBLIC: Return the ExceptionHandler.Exception handler can catch errors that occur on queries or during database access.
oracle.toplink.internal.remote.Transporter	getFromIdentityMap(oracle.toplink.internal.remote.Transporter domainObject) ADVANCED: Return the object from the identity with primary and class of the given object.
oracle.toplink.internal.remote.Transporter	getFromIdentityMap(oracle.toplink.internal.remote.Transporter primaryKey, oracle.toplink.internal.remote.Transporter theClass) ADVANCED: Return the object from the identity with the primary and class.
oracle.toplink.internal.remote.Transporter	getLogin() Get the associated session login.
oracle.toplink.internal.remote.Transporter	getProfiler() PUBLIC: Return the profiler.
oracle.toplink.internal.remote.Transporter	getRemoteLog() PUBLIC: Return the writer to which an accessor writes logged messages and SQL.
oracle.toplink.internal.remote.Transporter	getSessionLog() PUBLIC: Return the session log to which an accessor logs messages and SQL.
oracle.toplink.internal.remote.Transporter	initializeIdentityMap(oracle.toplink.internal.remote.Transporter theClass) PUBLIC: Reset the identity map for only the instances of the class.
oracle.toplink.internal.remote.Transporter	initializeIdentityMapsOnServerSession()
oracle.toplink.internal.remote.Transporter	instantiateRemoteValueHolderOnServer(oracle.toplink.internal.remote.Transporter remoteValueHolder) The corresponding original value holder is instantiated.
oracle.toplink.internal.remote.Transporter	isConnected() Return if this session is connected.
oracle.toplink.internal.remote.Transporter	log(oracle.toplink.internal.remote.Transporter entry) Log the log entry.
oracle.toplink.internal.remote.Transporter	printIdentityMap(oracle.toplink.internal.remote.Transporter theClass) PUBLIC: Used to print all the objects in the identity map of the passed in class.
oracle.toplink.internal.remote.Transporter	printIdentityMaps() PUBLIC: Used to print all the objects in every identity map in this session.
oracle.toplink.internal.remote.Transporter	removeFromIdentityMap(oracle.toplink.internal.remote.Transporter domainObject) ADVANCED: Remove the object from the object cache.
oracle.toplink.internal.remote.Transporter	removeFromIdentityMap(oracle.toplink.internal.remote.Transporter key, oracle.toplink.internal.remote.Transporter theClass) ADVANCED: Remove the object from the object cache.
oracle.toplink.internal.remote.Transporter	rollbackTransaction() Rollback a transaction on the database.
oracle.toplink.internal.remote.Transporter	scrollableCursorAbsolute(oracle.toplink.internal.remote.Transporter remoteScrollableCursorOid, int rows) Moves the cursor to the given row number in the result set
oracle.toplink.internal.remote.Transporter	scrollableCursorAfterLast(oracle.toplink.internal.remote.Transporter remoteScrollableCursorOid) Moves the cursor to the end of the result set, just after the last row.
oracle.toplink.internal.remote.Transporter	scrollableCursorBeforeFirst(oracle.toplink.internal.remote.Transporter remoteScrollableCursor) Moves the cursor to the front of the result set, just before the first row
oracle.toplink.internal.remote.Transporter	scrollableCursorClose(oracle.toplink.internal.remote.Transporter remoteScrollableCursorOid) Used for closing scrollable cursor across RMI.
oracle.toplink.internal.remote.Transporter	scrollableCursorCurrentIndex(oracle.toplink.internal.remote.Transporter remoteScrollableCursor) Retrieves the current row index number
oracle.toplink.internal.remote.Transporter	scrollableCursorFirst(oracle.toplink.internal.remote.Transporter remoteScrollableCursor) Moves the cursor to the first row in the result set
oracle.toplink.internal.remote.Transporter	scrollableCursorIsAfterLast(oracle.toplink.internal.remote.Transporter remoteScrollableCursor) Indicates whether the cursor is after the last row in the result set.
oracle.toplink.internal.remote.Transporter	scrollableCursorIsBeforeFirst(oracle.toplink.internal.remote.Transporter remoteScrollableCursor) Indicates whether the cursor is before the first row in the result set.
oracle.toplink.internal.remote.Transporter	scrollableCursorIsFirst(oracle.toplink.internal.remote.Transporter remoteScrollableCursor) Indicates whether the cursor is on the first row of the result set.
oracle.toplink.internal.remote.Transporter	scrollableCursorIsLast(oracle.toplink.internal.remote.Transporter remoteScrollableCursor) Indicates whether the cursor is on the last row of the result set.
oracle.toplink.internal.remote.Transporter	scrollableCursorLast(oracle.toplink.internal.remote.Transporter remoteScrollableCursor) Moves the cursor to the last row in the result set
oracle.toplink.internal.remote.Transporter	scrollableCursorNextObject(oracle.toplink.internal.remote.Transporter scrollableCursorOid) Retrieve next object from the scrollable cursor
oracle.toplink.internal.remote.Transporter	scrollableCursorPreviousObject(oracle.toplink.internal.remote.Transporter scrollableCursorOid) Retrieve previous object from the scrollable cursor
oracle.toplink.internal.remote.Transporter	scrollableCursorRelative(oracle.toplink.internal.remote.Transporter remoteScrollableCursor, int rows) Moves the cursor to the given row number in the result set
oracle.toplink.internal.remote.Transporter	scrollableCursorSize(oracle.toplink.internal.remote.Transporter remoteCursorOid) Return the cursor size
oracle.toplink.internal.remote.Transporter	setExceptionHandler(oracle.toplink.internal.remote.Transporter exceptionHandler) PUBLIC: Set the exceptionHandler.
oracle.toplink.internal.remote.Transporter	setLog(oracle.toplink.internal.remote.Transporter log) PUBLIC: Set the writer to which an accessor writes logged messages and SQL.
oracle.toplink.internal.remote.Transporter	setProfiler(oracle.toplink.internal.remote.Transporter profiler) PUBLIC: Set the profiler for the session.
oracle.toplink.internal.remote.Transporter	setSessionLog(oracle.toplink.internal.remote.Transporter sessionLog) PUBLIC: Set the session log to which an accessor logs messages and SQL.
oracle.toplink.internal.remote.Transporter	setShouldLogMessages(oracle.toplink.internal.remote.Transporter shouldLogMessages) PUBLIC: Set messages logging.
oracle.toplink.internal.remote.Transporter	shouldLogMessages() Return if all messages such as executed SQL commands should be logged.
oracle.toplink.internal.remote.Transporter	validateCache() ADVANCED: This can be used to help debugging an object identity problem.

Methods inherited from class javax.rmi.PortableRemoteObject

connect, exportObject, narrow, toStub, unexportObject

Methods inherited from class java.lang.Object

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

Constructor Detail

RMIRemoteSessionControllerDispatcher

public RMIRemoteSessionControllerDispatcher(oracle.toplink.publicinterface.Session session)
                                     throws java.rmi.RemoteException

RMIRemoteSessionControllerDispatcher

public RMIRemoteSessionControllerDispatcher(Session session)
                                     throws java.rmi.RemoteException

Method Detail

beginTransaction

public oracle.toplink.internal.remote.Transporter beginTransaction()

Begin a transaction on the database.

Specified by:

beginTransaction in interface RMIRemoteSessionController

commitRootUnitOfWork

public oracle.toplink.internal.remote.Transporter commitRootUnitOfWork(oracle.toplink.internal.remote.Transporter remoteUnitOfWork)

Remote unit of work after serialization is commited locally.

Specified by:

commitRootUnitOfWork in interface RMIRemoteSessionController

commitTransaction

public oracle.toplink.internal.remote.Transporter commitTransaction()

Commit a transaction on the database.

Specified by:

commitTransaction in interface RMIRemoteSessionController

compareObjects

public oracle.toplink.internal.remote.Transporter compareObjects(oracle.toplink.internal.remote.Transporter firstObject,
                                                                 oracle.toplink.internal.remote.Transporter secondObject)

TESTING: Return if the two object match completely. This checks the objects attributes and their private parts.

Specified by:

compareObjects in interface RMIRemoteSessionController

compareObjectsDontMatch

public oracle.toplink.internal.remote.Transporter compareObjectsDontMatch(oracle.toplink.internal.remote.Transporter firstObject,
                                                                          oracle.toplink.internal.remote.Transporter secondObject)

TESTING: Return true if the object do not match. This checks the objects attributes and their private parts.

Specified by:

compareObjectsDontMatch in interface RMIRemoteSessionController

containsObjectInIdentityMap

public oracle.toplink.internal.remote.Transporter containsObjectInIdentityMap(oracle.toplink.internal.remote.Transporter domainObject)

ADVANCED: Return if their is an object for the primary key.

Specified by:

containsObjectInIdentityMap in interface RMIRemoteSessionController

containsObjectInIdentityMap

public oracle.toplink.internal.remote.Transporter containsObjectInIdentityMap(oracle.toplink.internal.remote.Transporter primaryKey,
                                                                              oracle.toplink.internal.remote.Transporter theClass)

ADVANCED: Return if their is an object for the primary key.

Specified by:

containsObjectInIdentityMap in interface RMIRemoteSessionController

cursoredStreamClose

public oracle.toplink.internal.remote.Transporter cursoredStreamClose(oracle.toplink.internal.remote.Transporter remoteCursoredStreamID)

Used for closing cursored streams across RMI.

Specified by:

cursoredStreamClose in interface RMIRemoteSessionController

cursoredStreamNextPage

public oracle.toplink.internal.remote.Transporter cursoredStreamNextPage(oracle.toplink.internal.remote.Transporter remoteCursoredStream,
                                                                         int pageSize)

Retrieve next page size of objects from the remote cursored stream

Specified by:

cursoredStreamNextPage in interface RMIRemoteSessionController

cursoredStreamSize

public oracle.toplink.internal.remote.Transporter cursoredStreamSize(oracle.toplink.internal.remote.Transporter remoteCursoredStreamOid)

Return the cursored stream size

Specified by:

cursoredStreamSize in interface RMIRemoteSessionController

cursorSelectObjects

public oracle.toplink.internal.remote.Transporter cursorSelectObjects(oracle.toplink.internal.remote.Transporter remoteTransporter)

Returns a remote cursor stub in a transporter

Specified by:

cursorSelectObjects in interface RMIRemoteSessionController

executeNamedQuery

public oracle.toplink.internal.remote.Transporter executeNamedQuery(oracle.toplink.internal.remote.Transporter nameTransporter,
                                                                    oracle.toplink.internal.remote.Transporter classTransporter,
                                                                    oracle.toplink.internal.remote.Transporter argumentsTransporter)

A remote query after serialization is executed locally.

Specified by:

executeNamedQuery in interface RMIRemoteSessionController

executeQuery

public oracle.toplink.internal.remote.Transporter executeQuery(oracle.toplink.internal.remote.Transporter query)

A remote query after serialization is executed locally.

Specified by:

executeQuery in interface RMIRemoteSessionController

getDescriptor

public oracle.toplink.internal.remote.Transporter getDescriptor(oracle.toplink.internal.remote.Transporter theClass)

Extract descriptor from the session

Specified by:

getDescriptor in interface RMIRemoteSessionController

getDefaultReadOnlyClasses

public oracle.toplink.internal.remote.Transporter getDefaultReadOnlyClasses()

Get the default read-only classes

Specified by:

getDefaultReadOnlyClasses in interface RMIRemoteSessionController

getExceptionHandler

public oracle.toplink.internal.remote.Transporter getExceptionHandler()

PUBLIC: Return the ExceptionHandler.Exception handler can catch errors that occur on queries or during database access.

Specified by:

getExceptionHandler in interface RMIRemoteSessionController

getFromIdentityMap

public oracle.toplink.internal.remote.Transporter getFromIdentityMap(oracle.toplink.internal.remote.Transporter domainObject)

ADVANCED: Return the object from the identity with primary and class of the given object.

Specified by:

getFromIdentityMap in interface RMIRemoteSessionController

getFromIdentityMap

public oracle.toplink.internal.remote.Transporter getFromIdentityMap(oracle.toplink.internal.remote.Transporter primaryKey,
                                                                     oracle.toplink.internal.remote.Transporter theClass)

ADVANCED: Return the object from the identity with the primary and class.

Specified by:

getFromIdentityMap in interface RMIRemoteSessionController

getLogin

public oracle.toplink.internal.remote.Transporter getLogin()

Get the associated session login.

Specified by:

getLogin in interface RMIRemoteSessionController

getProfiler

public oracle.toplink.internal.remote.Transporter getProfiler()

PUBLIC: Return the profiler. The profiler is a tool that can be used to determine performance bottlenecks. The profiler can be queries to print summaries and configure for logging purposes.

Specified by:

getProfiler in interface RMIRemoteSessionController

getRemoteLog

public oracle.toplink.internal.remote.Transporter getRemoteLog()

PUBLIC: Return the writer to which an accessor writes logged messages and SQL. If not set, this reference defaults to a writer on System.out. To enable logging, logMessages must be turned on.

Specified by:

getRemoteLog in interface RMIRemoteSessionController

See Also:

#logMessages()

getSessionLog

public oracle.toplink.internal.remote.Transporter getSessionLog()

PUBLIC: Return the session log to which an accessor logs messages and SQL. If not set, this will default to a session log on a writer on System.out. To enable logging, logMessages must be turned on.

Specified by:

getSessionLog in interface RMIRemoteSessionController

See Also:

#logMessages()

initializeIdentityMap

public oracle.toplink.internal.remote.Transporter initializeIdentityMap(oracle.toplink.internal.remote.Transporter theClass)

PUBLIC: Reset the identity map for only the instances of the class. For inheritance the user must make sure that they only use the root class. Caution must be used in doing this to ensure that the objects within the identity map are not referenced from other objects of other classes or from the application.

Specified by:

initializeIdentityMap in interface RMIRemoteSessionController

initializeIdentityMapsOnServerSession

public oracle.toplink.internal.remote.Transporter initializeIdentityMapsOnServerSession()

Specified by:

initializeIdentityMapsOnServerSession in interface RMIRemoteSessionController

instantiateRemoteValueHolderOnServer

public oracle.toplink.internal.remote.Transporter instantiateRemoteValueHolderOnServer(oracle.toplink.internal.remote.Transporter remoteValueHolder)

The corresponding original value holder is instantiated.

Specified by:

instantiateRemoteValueHolderOnServer in interface RMIRemoteSessionController

isConnected

public oracle.toplink.internal.remote.Transporter isConnected()

Return if this session is connected.

Specified by:

isConnected in interface RMIRemoteSessionController

log

public oracle.toplink.internal.remote.Transporter log(oracle.toplink.internal.remote.Transporter entry)

Log the log entry.

Specified by:

log in interface RMIRemoteSessionController

printIdentityMap

public oracle.toplink.internal.remote.Transporter printIdentityMap(oracle.toplink.internal.remote.Transporter theClass)

PUBLIC: Used to print all the objects in the identity map of the passed in class. The output of this method will go the the Session's log.

Specified by:

printIdentityMap in interface RMIRemoteSessionController

printIdentityMaps

public oracle.toplink.internal.remote.Transporter printIdentityMaps()

PUBLIC: Used to print all the objects in every identity map in this session. The output of this method will go to the Session's log.

Specified by:

printIdentityMaps in interface RMIRemoteSessionController

removeFromIdentityMap

public oracle.toplink.internal.remote.Transporter removeFromIdentityMap(oracle.toplink.internal.remote.Transporter domainObject)

ADVANCED: Remove the object from the object cache. Caution should be used when calling to avoid violating object identity. The application should only call this is it knows that no references to the object exist.

Specified by:

removeFromIdentityMap in interface RMIRemoteSessionController

removeFromIdentityMap

public oracle.toplink.internal.remote.Transporter removeFromIdentityMap(oracle.toplink.internal.remote.Transporter key,
                                                                        oracle.toplink.internal.remote.Transporter theClass)

ADVANCED: Remove the object from the object cache. Caution should be used when calling to avoid violating object identity. The application should only call this is it knows that no references to the object exist.

Specified by:

removeFromIdentityMap in interface RMIRemoteSessionController

rollbackTransaction

public oracle.toplink.internal.remote.Transporter rollbackTransaction()

Rollback a transaction on the database.

Specified by:

rollbackTransaction in interface RMIRemoteSessionController

scrollableCursorAbsolute

public oracle.toplink.internal.remote.Transporter scrollableCursorAbsolute(oracle.toplink.internal.remote.Transporter remoteScrollableCursorOid,
                                                                           int rows)

Moves the cursor to the given row number in the result set

Specified by:

scrollableCursorAbsolute in interface RMIRemoteSessionController

scrollableCursorAfterLast

public oracle.toplink.internal.remote.Transporter scrollableCursorAfterLast(oracle.toplink.internal.remote.Transporter remoteScrollableCursorOid)

Moves the cursor to the end of the result set, just after the last row.

Specified by:

scrollableCursorAfterLast in interface RMIRemoteSessionController

scrollableCursorBeforeFirst

public oracle.toplink.internal.remote.Transporter scrollableCursorBeforeFirst(oracle.toplink.internal.remote.Transporter remoteScrollableCursor)

Moves the cursor to the front of the result set, just before the first row

Specified by:

scrollableCursorBeforeFirst in interface RMIRemoteSessionController

scrollableCursorClose

public oracle.toplink.internal.remote.Transporter scrollableCursorClose(oracle.toplink.internal.remote.Transporter remoteScrollableCursorOid)

Used for closing scrollable cursor across RMI.

Specified by:

scrollableCursorClose in interface RMIRemoteSessionController

scrollableCursorCurrentIndex

public oracle.toplink.internal.remote.Transporter scrollableCursorCurrentIndex(oracle.toplink.internal.remote.Transporter remoteScrollableCursor)

Retrieves the current row index number

Specified by:

scrollableCursorCurrentIndex in interface RMIRemoteSessionController

scrollableCursorFirst

public oracle.toplink.internal.remote.Transporter scrollableCursorFirst(oracle.toplink.internal.remote.Transporter remoteScrollableCursor)

Moves the cursor to the first row in the result set

Specified by:

scrollableCursorFirst in interface RMIRemoteSessionController

scrollableCursorIsAfterLast

public oracle.toplink.internal.remote.Transporter scrollableCursorIsAfterLast(oracle.toplink.internal.remote.Transporter remoteScrollableCursor)

Indicates whether the cursor is after the last row in the result set.

Specified by:

scrollableCursorIsAfterLast in interface RMIRemoteSessionController

scrollableCursorIsBeforeFirst

public oracle.toplink.internal.remote.Transporter scrollableCursorIsBeforeFirst(oracle.toplink.internal.remote.Transporter remoteScrollableCursor)

Indicates whether the cursor is before the first row in the result set.

Specified by:

scrollableCursorIsBeforeFirst in interface RMIRemoteSessionController

scrollableCursorIsFirst

public oracle.toplink.internal.remote.Transporter scrollableCursorIsFirst(oracle.toplink.internal.remote.Transporter remoteScrollableCursor)

Indicates whether the cursor is on the first row of the result set.

Specified by:

scrollableCursorIsFirst in interface RMIRemoteSessionController

scrollableCursorIsLast

public oracle.toplink.internal.remote.Transporter scrollableCursorIsLast(oracle.toplink.internal.remote.Transporter remoteScrollableCursor)

Indicates whether the cursor is on the last row of the result set.

Specified by:

scrollableCursorIsLast in interface RMIRemoteSessionController

scrollableCursorLast

public oracle.toplink.internal.remote.Transporter scrollableCursorLast(oracle.toplink.internal.remote.Transporter remoteScrollableCursor)

Moves the cursor to the last row in the result set

Specified by:

scrollableCursorLast in interface RMIRemoteSessionController

scrollableCursorNextObject

public oracle.toplink.internal.remote.Transporter scrollableCursorNextObject(oracle.toplink.internal.remote.Transporter scrollableCursorOid)

Retrieve next object from the scrollable cursor

Specified by:

scrollableCursorNextObject in interface RMIRemoteSessionController

scrollableCursorPreviousObject

public oracle.toplink.internal.remote.Transporter scrollableCursorPreviousObject(oracle.toplink.internal.remote.Transporter scrollableCursorOid)

Retrieve previous object from the scrollable cursor

Specified by:

scrollableCursorPreviousObject in interface RMIRemoteSessionController

scrollableCursorRelative

public oracle.toplink.internal.remote.Transporter scrollableCursorRelative(oracle.toplink.internal.remote.Transporter remoteScrollableCursor,
                                                                           int rows)

Moves the cursor to the given row number in the result set

Specified by:

scrollableCursorRelative in interface RMIRemoteSessionController

scrollableCursorSize

public oracle.toplink.internal.remote.Transporter scrollableCursorSize(oracle.toplink.internal.remote.Transporter remoteCursorOid)

Return the cursor size

Specified by:

scrollableCursorSize in interface RMIRemoteSessionController

setExceptionHandler

public oracle.toplink.internal.remote.Transporter setExceptionHandler(oracle.toplink.internal.remote.Transporter exceptionHandler)

PUBLIC: Set the exceptionHandler. Exception handler can catch errors that occur on queries or during database access.

Specified by:

setExceptionHandler in interface RMIRemoteSessionController

setLog

public oracle.toplink.internal.remote.Transporter setLog(oracle.toplink.internal.remote.Transporter log)

PUBLIC: Set the writer to which an accessor writes logged messages and SQL. If not set, this reference defaults to a writer on System.out. To enable logging logMessages() is used.

Specified by:

setLog in interface RMIRemoteSessionController

See Also:

#logMessages()

setProfiler

public oracle.toplink.internal.remote.Transporter setProfiler(oracle.toplink.internal.remote.Transporter profiler)

PUBLIC: Set the profiler for the session. This allows for performance operations to be profiled.

Specified by:

setProfiler in interface RMIRemoteSessionController

setSessionLog

public oracle.toplink.internal.remote.Transporter setSessionLog(oracle.toplink.internal.remote.Transporter sessionLog)

PUBLIC: Set the session log to which an accessor logs messages and SQL. If not set, this will default to a session log on a writer on System.out. To enable logging, logMessages must be turned on.

Specified by:

setSessionLog in interface RMIRemoteSessionController

See Also:

#logMessages()

setShouldLogMessages

public oracle.toplink.internal.remote.Transporter setShouldLogMessages(oracle.toplink.internal.remote.Transporter shouldLogMessages)

PUBLIC: Set messages logging. Message logging will dump all SQL executed through TopLink to the session's log. By default this is System.out, but can be set to any Writer.

Specified by:

setShouldLogMessages in interface RMIRemoteSessionController

See Also:

#setLog(Writer)

shouldLogMessages

public oracle.toplink.internal.remote.Transporter shouldLogMessages()

Return if all messages such as executed SQL commands should be logged.

Specified by:

shouldLogMessages in interface RMIRemoteSessionController

validateCache

public oracle.toplink.internal.remote.Transporter validateCache()

ADVANCED: This can be used to help debugging an object identity problem. An object identity problem is when an object in the cache references an object not in the cache. This method will validate that all cached objects are in a correct state.

Specified by:

validateCache in interface RMIRemoteSessionController