org.apache.tuscany.sca.host.rmi
Interface RMIHost

All Known Implementing Classes:

DefaultRMIHost, ExtensibleRMIHost

public interface RMIHost

RMI Service hosting interface to be implemented by host environments that allows SCA Components to register RMI Services to handle inbound service requests over RMI to SCA Components

Field Summary

static int

RMI_DEFAULT_PORT

Method Summary

java.rmi.Remote	findService(java.lang.String host, java.lang.String port, java.lang.String svcName) find a remote service hosted on the given host, port and service name
void	registerService(java.lang.String serviceName, int port, java.rmi.Remote serviceObject) Register an RMI service with the given name and port
void	registerService(java.lang.String serviceName, java.rmi.Remote serviceObject) Register an RMI service with the given name and default port (1099)
void	unregisterService(java.lang.String serviceName) Unregister a service registered under the given service name and default port number (1099)
void	unregisterService(java.lang.String serviceName, int port) Unregister a service registered under the given service name and port number

Field Detail

RMI_DEFAULT_PORT

static final int RMI_DEFAULT_PORT

See Also:

Constant Field Values

Method Detail

registerService

void registerService(java.lang.String serviceName,
                     int port,
                     java.rmi.Remote serviceObject)
                     throws RMIHostException,
                            RMIHostRuntimeException

Register an RMI service with the given name and port

Parameters:

serviceName - against which the server is to be registered

port - the port against which the server is to be registered

serviceObject - the server object to be registered

Throws:

RMIHostException

RMIHostRuntimeException

registerService

void registerService(java.lang.String serviceName,
                     java.rmi.Remote serviceObject)
                     throws RMIHostException,
                            RMIHostRuntimeException

Register an RMI service with the given name and default port (1099)

Parameters:

serviceName - serviceName against which the server is to be registered

serviceObject - the server object to be registered

Throws:

RMIHostException

RMIHostRuntimeException

unregisterService

void unregisterService(java.lang.String serviceName,
                       int port)
                       throws RMIHostException,
                              RMIHostRuntimeException

Unregister a service registered under the given service name and port number

Parameters:

serviceName - serviceName against which the server is to be registered

port - the port against which the server is to be registered

Throws:

RMIHostException

RMIHostRuntimeException

unregisterService

void unregisterService(java.lang.String serviceName)
                       throws RMIHostException,
                              RMIHostRuntimeException

Unregister a service registered under the given service name and default port number (1099)

Parameters:

serviceName - the name of the service that has to be unregistered

Throws:

RMIHostException

RMIHostRuntimeException

findService

java.rmi.Remote findService(java.lang.String host,
                            java.lang.String port,
                            java.lang.String svcName)
                            throws RMIHostException,
                                   RMIHostRuntimeException

find a remote service hosted on the given host, port and service name

Parameters:

host - the name of the host on which the RMI service to be unregistered is running

port - the port against which the server is to be unregistered is running

svcName - serviceName against which the server is to be unregistered is running

Returns:

the RMI server object

Throws:

RMIHostException

RMIHostRuntimeException