stream.runtime.rpc

Class RMINamingService

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

stream.runtime.rpc.RMINamingService

All Implemented Interfaces:

Serializable, Remote, LifeCycle, RemoteNamingService, NamingService

public class RMINamingService
extends UnicastRemoteObject
implements RemoteNamingService, LifeCycle

An implementation of the NamingService that uses RMI as underlying transport layer.

Author:

Christian Bockermann <christian.bockermann@udo.edu>

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
(package private) ContainerAnnouncement	announcement
(package private) Announcer	announcer
(package private) Map<String,ServiceInfo>	classes
(package private) Map<String,NamingService>	container
(package private) Discovery	discoverer
(package private) static org.slf4j.Logger	log
(package private) String	name
(package private) String	namespace
(package private) Registry	registry
private static long	serialVersionUID The unique class ID

Fields inherited from class java.rmi.server.RemoteObject

ref

Fields inherited from interface stream.runtime.rpc.RemoteNamingService

DIRECTORY_NAME

Constructor Summary

Constructors

Constructor and Description
RMINamingService()
RMINamingService(String name)
RMINamingService(String name, String host, int port)
RMINamingService(String name, String host, int port, boolean announce)

Method Summary

Modifier and Type	Method and Description
void	addContainer(String key, NamingService remoteNamingService)
Serializable	call(String name, String method, String signature, Serializable... args)
protected void	discover()
protected String	discover(String container)
void	finish()
protected String	getContainerName(String ref) Extracts the container name from a service reference.
static int	getFreePort()
protected String	getLocalRef(String ref) Extracts the local part of a reference, i.e.
Map<String,String>	getServiceInfo(String name) (non-Javadoc)
void	init(ApplicationContext context)
protected boolean	isLocal(String ref) Checks if the given reference is local to this naming service.
Map<String,ServiceInfo>	list()
<T extends Service> T	lookup(String ref, Class<T> serviceClass)
void	register(String ref, Service p)
void	unregister(String ref)

Methods inherited from class java.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

The unique class ID

See Also:

Constant Field Values

log

static org.slf4j.Logger log

name

final String name

namespace

final String namespace

registry

final Registry registry

classes

final Map<String,ServiceInfo> classes

announcer

Announcer announcer

discoverer

Discovery discoverer

announcement

ContainerAnnouncement announcement

container

Map<String,NamingService> container

Constructor Detail

RMINamingService

public RMINamingService()
                 throws Exception

Throws:

Exception

RMINamingService

public RMINamingService(String name)
                 throws Exception

Throws:

Exception

RMINamingService

public RMINamingService(String name,
                        String host,
                        int port)
                 throws Exception

Throws:

Exception

RMINamingService

public RMINamingService(String name,
                        String host,
                        int port,
                        boolean announce)
                 throws Exception

Throws:

Exception

Method Detail

getFreePort

public static int getFreePort()
                       throws Exception

Throws:

Exception

addContainer

public void addContainer(String key,
                         NamingService remoteNamingService)
                  throws Exception

Specified by:

addContainer in interface NamingService

Throws:

Exception

See Also:

NamingService.addContainer(java.lang.String, stream.service.NamingService)

discover

protected void discover()

discover

protected String discover(String container)
                   throws Exception

Throws:

Exception

isLocal

protected boolean isLocal(String ref)

Checks if the given reference is local to this naming service. It is local if it does not start with "//" or if it starts with this name service's namespace.

Parameters:

ref -

Returns:

getContainerName

protected String getContainerName(String ref)

Extracts the container name from a service reference.

Parameters:

ref -

Returns:

getLocalRef

protected String getLocalRef(String ref)

Extracts the local part of a reference, i.e. removes the name space part IF this is present and matching this name service's namespace. Otherwise this method will return null.

Parameters:

ref -

Returns:

lookup

public <T extends Service> T lookup(String ref,
                                    Class<T> serviceClass)
                             throws Exception

Specified by:

lookup in interface NamingService

Throws:

Exception

See Also:

NamingService.lookup(java.lang.String, java.lang.Class)

register

public void register(String ref,
                     Service p)
              throws Exception

Specified by:

register in interface NamingService

Throws:

Exception

See Also:

NamingService.register(java.lang.String, stream.service.Service)

unregister

public void unregister(String ref)
                throws Exception

Specified by:

unregister in interface NamingService

Throws:

Exception

See Also:

NamingService.unregister(java.lang.String)

list

public Map<String,ServiceInfo> list()
                             throws Exception

Specified by:

list in interface NamingService

Throws:

Exception

getServiceInfo

public Map<String,String> getServiceInfo(String name)
                                  throws RemoteException

(non-Javadoc)

Specified by:

getServiceInfo in interface RemoteNamingService

Throws:

RemoteException

See Also:

RemoteNamingService.getServiceInfo(java.lang.String)

call

public Serializable call(String name,
                         String method,
                         String signature,
                         Serializable... args)
                  throws RemoteException

Specified by:

call in interface RemoteNamingService

Throws:

RemoteException

finish

public void finish()
            throws Exception

Specified by:

finish in interface LifeCycle

Throws:

Exception

See Also:

LifeCycle.finish()

init

public void init(ApplicationContext context)
          throws Exception

Specified by:

init in interface LifeCycle

Throws:

Exception

See Also:

stream.runtime.LifeCycle#init(stream.Context)