rsb.patterns

Class RemoteServer

java.lang.Object

rsb.Participant

rsb.patterns.Server

rsb.patterns.RemoteServer

All Implemented Interfaces:

RSBObject

public class RemoteServer
extends Server

Objects of this class represent remote servers in a way that allows calling methods on them as if they were local.

Author:

jmoringe, swrede

Nested Class Summary

Nested classes/interfaces inherited from class rsb.patterns.Server

Server.ServerStateActive, Server.ServerStateInactive

Field Summary

Fields inherited from class rsb.patterns.Server

methods

Constructor Summary

Constructors

Constructor and Description
RemoteServer(Scope scope) Create a new RemoteServer object that provides its methods under the scope @a scope.
RemoteServer(Scope scope, double timeout) Create a new RemoteServer object that provides its methods under the scope @a scope.
RemoteServer(java.lang.String scope) Create a new RemoteServer object that provides its methods under the scope @a scope.
RemoteServer(java.lang.String scope, double timeout) Create a new RemoteServer object that provides its methods under the scope @a scope.

Method Summary

Methods

Modifier and Type	Method and Description
protected <U,T> AbstractRemoteMethod<?,?>	addMethod(java.lang.String name, boolean isEvent)
Event	call(java.lang.String name, Event event)
<U,T> U	call(java.lang.String name, T data) Blocking call directly returning the data or throwing an exception upon timeout, interruption or failure.
Future<Event>	callAsync(java.lang.String name, Event event)
<T,U> Future<T>	callAsync(java.lang.String name, U data) Async call returning an rsb.patterns.Future object
double	getTimeout()

Methods inherited from class rsb.patterns.Server

activate, deactivate, getMethods, isActive

Methods inherited from class rsb.Participant

getId, getRouter, getScope, getTransportFactory

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteServer

public RemoteServer(Scope scope,
            double timeout)

Create a new RemoteServer object that provides its methods under the scope @a scope.

Parameters:

scope - The common super-scope under which the methods of the remote created server are provided.

timeout - The amount of seconds methods calls should wait for their replies to arrive before failing.

RemoteServer

public RemoteServer(java.lang.String scope,
            double timeout)

Create a new RemoteServer object that provides its methods under the scope @a scope.

Parameters:

scope - The common super-scope under which the methods of the remote created server are provided.

timeout - The amount of seconds methods calls should wait for their replies to arrive before failing.

RemoteServer

public RemoteServer(Scope scope)

Create a new RemoteServer object that provides its methods under the scope @a scope.

Parameters:

scope - The common super-scope under which the methods of the remote created server are provided.

RemoteServer

public RemoteServer(java.lang.String scope)

Create a new RemoteServer object that provides its methods under the scope @a scope.

Parameters:

scope - The common super-scope under which the methods of the remote created server are provided.

Method Detail

getTimeout

public double getTimeout()

callAsync

public Future<Event> callAsync(java.lang.String name,
                      Event event)
                        throws RSBException

Throws:

RSBException

callAsync

public <T,U> Future<T> callAsync(java.lang.String name,
                        U data)
                    throws RSBException

Async call returning an rsb.patterns.Future object

Parameters:

name -

data -

Returns:

Throws:

RSBException

call

public Event call(java.lang.String name,
         Event event)
           throws RSBException

Throws:

RSBException

call

public <U,T> U call(java.lang.String name,
           T data)
       throws RSBException

Blocking call directly returning the data or throwing an exception upon timeout, interruption or failure.

Parameters:

name -

data -

Returns:

Throws:

RSBException

addMethod

protected <U,T> AbstractRemoteMethod<?,?> addMethod(java.lang.String name,
                                        boolean isEvent)
                                       throws InitializeException

Throws:

InitializeException