oracle.toplink.remote
Class RemoteSession

java.lang.Object
  |
  +--oracle.toplink.publicinterface.Session
        |
        +--oracle.toplink.remote.DistributedSession
              |
              +--oracle.toplink.remote.RemoteSession

All Implemented Interfaces:

java.lang.Cloneable, java.io.Serializable

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

Constructor Summary

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

Method Summary

Type	Method
UnitOfWork	acquireUnitOfWork() PUBLIC: Return a unit of work for this session.
java.lang.Object	executeQuery(DatabaseQuery query) PUBLIC: Execute the database query.
DatabaseLogin	getLogin() PUBLIC: Return the login.

Methods inherited from class oracle.toplink.remote.DistributedSession

beginTransaction, commitTransaction, executeQuery, executeQuery, executeQuery, executeQuery, initializeAllIdentityMaps, isConnected, rollbackTransaction, toString

Methods inherited from class oracle.toplink.publicinterface.Session

None

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)

PUBLIC: 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

acquireUnitOfWork

public UnitOfWork acquireUnitOfWork()

PUBLIC: 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.

Overrides:

acquireUnitOfWork in class DistributedSession

See Also:

executeQuery

public java.lang.Object executeQuery(DatabaseQuery query)

PUBLIC: Execute the database query.

Overrides:

executeQuery in class DistributedSession

Following copied from class: oracle.toplink.publicinterface.Session

See Also:

DatabaseQuery

getLogin

public DatabaseLogin getLogin()

PUBLIC: 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.

Overrides:

getLogin in class Session