org.objectweb.carol.irmi

Class Server

java.lang.Object

java.lang.Thread

org.objectweb.carol.irmi.Server

All Implemented Interfaces:

java.lang.Runnable, Constants

public class Server
extends java.lang.Thread
implements Constants

The Server class manages exported Remote objects and listens for connections from remote references. It also contains static methods that the Ref class uses to make remote invocations.

Author:

Rafael H. Schloming <rhs@mit.edu>

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 java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Fields inherited from interface org.objectweb.carol.irmi.Constants

DGC_PING, METHOD_CALL, METHOD_ERROR, METHOD_RESULT, SYSTEM_ERROR

Constructor Summary

Constructors

Constructor and Description
Server() Constructs a Server instance that will bind to any available port and does not have any Interceptors.
Server(ClientInterceptor clint, Interceptor srvint) Constructs a Server instance that will bind to any available port and use the given client and server Interceptors.
Server(int port, ClientInterceptor clint, Interceptor srvint) Construcst a Server instance with the specified port, client, and server Interceptors.

Method Summary

Modifier and Type	Method and Description
void	export(java.rmi.Remote object) Exports the given Remote object.
java.lang.ClassLoader	getLoader(java.rmi.server.ObjID oid) Return the ClassLoader used for deserializing arguments to methods of the exported object mapped to the given oid or null if there is none.
java.rmi.Remote	getObject(java.rmi.server.ObjID oid) Return the exported object for the given oid or null if there is none.
java.rmi.server.ObjID	getOID(java.rmi.Remote obj) Return the ObjID for the given Remote object or null if there is none.
static java.util.Collection	getServers() Returns all the Server instances for this JVM.
java.rmi.server.Skeleton	getSkel(java.rmi.Remote obj) Construct and return a Skeleton for the given Remote object.
java.rmi.server.RemoteStub	getStub(java.rmi.Remote obj) Converts the given Remote object to a RemoteStub instance.
void	run() Accepts connections and launches Handler threads.
boolean	unexport(java.rmi.server.ObjID oid) Unexports the Remote object associated with the given ObjID if it is being exported by this Server.
boolean	unexport(java.rmi.Remote obj) Unexports the given Remote object if it is being exported by this Server.

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, 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

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

Constructor Detail

Server

public Server(int port,
              ClientInterceptor clint,
              Interceptor srvint)

Construcst a Server instance with the specified port, client, and server Interceptors. If port is zero then any available port will be chosen.

Parameters:

port - the port for the server to bind to

clint - the client Interceptor or null

srvint - the server Interceptor or null

Server

public Server(ClientInterceptor clint,
              Interceptor srvint)

Constructs a Server instance that will bind to any available port and use the given client and server Interceptors.

Parameters:

clint - the client Interceptor

srvint - the server Interceptor

Server

public Server()

Constructs a Server instance that will bind to any available port and does not have any Interceptors.

Method Detail

getServers

public static java.util.Collection getServers()

Returns all the Server instances for this JVM.

Returns:

all the Server instances for this JVM

run

public void run()

Accepts connections and launches Handler threads.

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

getObject

public java.rmi.Remote getObject(java.rmi.server.ObjID oid)

Return the exported object for the given oid or null if there is none.

Parameters:

oid - the oid of an exported object

Returns:

the exported object or null if there is none

getOID

public java.rmi.server.ObjID getOID(java.rmi.Remote obj)

Return the ObjID for the given Remote object or null if there is none.

Parameters:

obj - an exported object

Returns:

the ObjID assigned to the exported object, or null if there is none

getLoader

public java.lang.ClassLoader getLoader(java.rmi.server.ObjID oid)

Return the ClassLoader used for deserializing arguments to methods of the exported object mapped to the given oid or null if there is none.

Parameters:

oid - the oid of an exported object

Returns:

the ClassLoader used for deserializing arguments to methods of the exported object mapped to the given oid or null if there is none

getSkel

public java.rmi.server.Skeleton getSkel(java.rmi.Remote obj)

Construct and return a Skeleton for the given Remote object.

Parameters:

obj - a Remote object

Returns:

the Skeleton for obj

getStub

public java.rmi.server.RemoteStub getStub(java.rmi.Remote obj)

Converts the given Remote object to a RemoteStub instance. This may involve nothing if the object is already a stub, or it may involve search for an appropriate stub class and constructing an instance of it.

Parameters:

obj - the Remote object

Returns:

a RemoteStub for obj

export

public void export(java.rmi.Remote object)
            throws java.rmi.server.ExportException

Exports the given Remote object.

Parameters:

object - the object to export

Throws:

java.rmi.server.ExportException - when there is an error

unexport

public boolean unexport(java.rmi.Remote obj)

Unexports the given Remote object if it is being exported by this Server.

Parameters:

obj - the object to unexport

Returns:

true iff the object was unexported

unexport

public boolean unexport(java.rmi.server.ObjID oid)

Unexports the Remote object associated with the given ObjID if it is being exported by this Server.

Parameters:

oid - the ObjID of the Remote object to be unexported

Returns:

true iff the object was unexported