EclipseLink 1.0_1.0M2 API Reference - Incubation

org.eclipse.persistence.sessions.remote.rmi.iiop
Class RMIJNDIClusteringService

java.lang.Object
  extended by java.lang.Thread
      extended by org.eclipse.persistence.sessions.remote.AbstractClusteringService
          extended by org.eclipse.persistence.sessions.remote.AbstractJNDIClusteringService
              extended by org.eclipse.persistence.sessions.remote.rmi.iiop.RMIJNDIClusteringService
All Implemented Interfaces:
java.lang.Runnable

Deprecated. since OracleAS TopLink 10g (10.1.3). This class is replaced by RMITransportManager

public class RMIJNDIClusteringService
extends AbstractJNDIClusteringService

PURPOSE:To Provide a framework for offering customers the ability to automatically connect multiple sessions for synchrnization.

Descripton:This thread object will place a remote dispatcher in the specified JNDI space. it will also monitor the specified multicast socket to allow other sessions to connect. This Particular class has been configured to use the RMI transport protocols. This class also assumes that there is a JNDI service available. And is best used within an application server.

See Also:
CacheSynchronizationManager
Author:
Gordon Yorke

Nested Class Summary
 
Nested classes/interfaces inherited from class java.lang.Thread
java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler
 
Field Summary
 
Fields inherited from class org.eclipse.persistence.sessions.remote.AbstractJNDIClusteringService
contextProperties, localContext, password, userName
 
Fields inherited from class org.eclipse.persistence.sessions.remote.AbstractClusteringService
announcementDelay, applicationName, communicationSocket, DEFAULT_MULTICAST_GROUP, DEFAULT_MULTICAST_PORT, DEFAULT_RECV_BUFFER_SIZE, dispatcher, localHostURL, multicastGroupAddress, multicastPort, reconnectionPolicy, session, sessionId, stopListening, timeToLive
 
Fields inherited from class java.lang.Thread
MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY
 
Constructor Summary
RMIJNDIClusteringService(Session session)
          Deprecated. PUBLIC: Creates a RMIJNDIClusteringService
RMIJNDIClusteringService(java.lang.String multicastAddress, int multicastPort, Session session)
          Deprecated. ADVANCED: Creates a RMIJNDIClusteringService
 
Method Summary
 RemoteConnection createRemoteConnection(java.lang.String sessionId, java.lang.String jndiHostURL)
          Deprecated. ADVANCED: This method should return a remote connection of the appropraite type for use in the synchronizatio
 void deregisterDispatcher()
          Deprecated. ADVANCED: This method will deregister the dispatcher for this session from JNDI on the specified host.
 java.net.MulticastSocket getCommunicationSocket()
          Deprecated. ADVANCED: Returns the socket that will be used for the multicast communication.
 javax.naming.Context getContext(java.lang.String jndiHostURL)
          Deprecated. Since 4.5
 java.lang.Object getDispatcher()
          Deprecated. ADVANCED: This is the object that will be placed in JNDI to provide remote synchronization services
 RemoteConnection getLocalRemoteConnection()
          Deprecated. ADVANCED: This method should return a Remote Connection of the appropriate type that references the Remote dispatcher for this Session
 void registerDispatcher()
          Deprecated. ADVANCED: This method will register the dispatcher for this session in JNDI on the specified host.
 
Methods inherited from class org.eclipse.persistence.sessions.remote.AbstractJNDIClusteringService
getContext, getInitialContextProperties, getLocalContext, getPassword, getUserName, setContext, setInitialContextFactoryName, setInitialContextProperties, setLocalHostURL, setPassword, setUserName
 
Methods inherited from class org.eclipse.persistence.sessions.remote.AbstractClusteringService
announceSession, buildSessionId, connectBackToRemote, getAnnouncementDelay, getApplicationName, getLocalHostURL, getMulticastGroupAddress, getMulticastPort, getReconnectPolicy, getSession, getSessionId, getTimeToLive, initialize, listen, receivedAnnouncement, reconnect, run, setAnnouncementDelay, setApplicationName, setDispatcher, setMulticastGroupAddress, setMulticastPort, setReconnectPolicy, setSession, setSessionId, setTimeToLive, stopListening
 
Methods inherited from class java.lang.Thread
activeCount, checkAccess, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

RMIJNDIClusteringService

public RMIJNDIClusteringService(java.lang.String multicastAddress,
                                int multicastPort,
                                Session session)
Deprecated. 
ADVANCED: Creates a RMIJNDIClusteringService

Parameters:
multicastAddress - The address of the multicast group
multicastPort - The port the multicast group is listening on
SBGen:
Constructor

RMIJNDIClusteringService

public RMIJNDIClusteringService(Session session)
Deprecated. 
PUBLIC: Creates a RMIJNDIClusteringService

SBGen:
Constructor
Method Detail

registerDispatcher

public void registerDispatcher()
Deprecated. 
ADVANCED: This method will register the dispatcher for this session in JNDI on the specified host. It must register the dispatcher under the SessionId

Specified by:
registerDispatcher in class AbstractClusteringService

deregisterDispatcher

public void deregisterDispatcher()
Deprecated. 
ADVANCED: This method will deregister the dispatcher for this session from JNDI on the specified host. It must deregister the dispatcher under the SessionId

Specified by:
deregisterDispatcher in class AbstractClusteringService

createRemoteConnection

public RemoteConnection createRemoteConnection(java.lang.String sessionId,
                                               java.lang.String jndiHostURL)
Deprecated. 
ADVANCED: This method should return a remote connection of the appropraite type for use in the synchronizatio

Specified by:
createRemoteConnection in class AbstractClusteringService

getCommunicationSocket

public java.net.MulticastSocket getCommunicationSocket()
Deprecated. 
ADVANCED: Returns the socket that will be used for the multicast communication. By default this will be java.net.MulticastSocket

Specified by:
getCommunicationSocket in class AbstractClusteringService
SBGen:
Method get communicationSocket

getContext

public javax.naming.Context getContext(java.lang.String jndiHostURL)
Deprecated. Since 4.5

ADVANCED: Returns the active JNDI Context to store the remote service in

Overrides:
getContext in class AbstractJNDIClusteringService
SBGen:
Method get context

getDispatcher

public java.lang.Object getDispatcher()
                               throws java.rmi.RemoteException
Deprecated. 
ADVANCED: This is the object that will be placed in JNDI to provide remote synchronization services

Specified by:
getDispatcher in class AbstractClusteringService
Throws:
java.rmi.RemoteException
SBGen:
Method get dispatcher

getLocalRemoteConnection

public RemoteConnection getLocalRemoteConnection()
Deprecated. 
ADVANCED: This method should return a Remote Connection of the appropriate type that references the Remote dispatcher for this Session

Specified by:
getLocalRemoteConnection in class AbstractClusteringService

EclipseLink 1.0_1.0M2 API Reference - Incubation