org.granite.client.messaging

Class RemoteService

java.lang.Object

org.granite.client.messaging.RemoteService

public class RemoteService
extends java.lang.Object

RemoteService allows to call a remote service using RPC style Calling a service is asynchronous and won't block the thread initiating the call.

 RemoteService remoteService = new RemoteService(remotingChannel, "myService");
 remoteService.newInvocation("myMethod", arg1, arg2).invoke();
 
 

It is also possible to chain multiple invocations in one single call:

 RemoteService remoteService = new RemoteService(remotingChannel, "myService");
 remoteService.newInvocation("myMethod", arg1, arg2).appendInvocation("myMethod2", arg3).invoke();
 
 

Author:

Franck WOLFF

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RemoteService.RemoteServiceInvocation
static interface	RemoteService.RemoteServiceInvocationChain

Constructor Summary

Constructors

Constructor and Description
RemoteService(Channel channel, java.lang.String id) Create a remote service for the specified channel and destination

Method Summary

Methods

Modifier and Type	Method and Description
Channel	getChannel() Remoting channel
java.lang.String	getId() Destination id
RemoteService.RemoteServiceInvocation	newInvocation(java.lang.String method, java.lang.Object... parameters) Create an invocation for this service

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteService

public RemoteService(Channel channel,
             java.lang.String id)

Create a remote service for the specified channel and destination

Parameters:

channel - messaging channel

id - remote destination name

Method Detail

getChannel

public Channel getChannel()

Remoting channel

Returns:

channel

getId

public java.lang.String getId()

Destination id

Returns:

destination id

newInvocation

public RemoteService.RemoteServiceInvocation newInvocation(java.lang.String method,
                                                  java.lang.Object... parameters)

Create an invocation for this service

Parameters:

method - remote method name

parameters - arguments to send

Returns:

fluent invocation object