org.ow2.carol.irmi
Class Server

java.lang.Object
  java.lang.Thread
      org.ow2.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.ow2.carol.irmi.Constants

DGC_PING, METHOD_CALL, METHOD_ERROR, METHOD_RESULT, SYSTEM_ERROR

Constructor Summary

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

Server(int port)
Construct a Server instance with the specified port, client, and server Interceptors.

Method Summary

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<Server>	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.
protected void	setInterceptors(java.rmi.Remote obj, ClientInterceptor clientInterceptor, Interceptor serverInterceptor)
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, 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

Server

public Server(int port)

Construct 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

Server

public Server()

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

Method Detail

getServers

public static java.util.Collection<Server> getServers()

Returns all the Server instances for this JVM.

Returns:

all the Server instances for this JVM

setInterceptors

protected void setInterceptors(java.rmi.Remote obj,
                               ClientInterceptor clientInterceptor,
                               Interceptor serverInterceptor)

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