org.eclipse.ecf.remoteservice.client

Class AbstractRSAClientService

java.lang.Object

org.eclipse.ecf.remoteservice.asyncproxy.AbstractAsyncProxyRemoteService

org.eclipse.ecf.remoteservice.AbstractRemoteService

org.eclipse.ecf.remoteservice.client.AbstractClientService

org.eclipse.ecf.remoteservice.client.AbstractRSAClientService

All Implemented Interfaces:

InvocationHandler, IRemoteService

public abstract class AbstractRSAClientService
extends AbstractClientService

Abstract client remote service instance. This class should be overridden to implement the abstract invokeAsync, and invokeSync methods, which will be called when the proxy created is called by clients.

Since:

8.9

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractRSAClientService.RSARemoteCall

Nested classes/interfaces inherited from class org.eclipse.ecf.remoteservice.client.AbstractClientService

AbstractClientService.AsyncResult, AbstractClientService.UriRequest

Nested classes/interfaces inherited from class org.eclipse.ecf.remoteservice.AbstractRemoteService

AbstractRemoteService.AsyncArgs, AbstractRemoteService.ProxyClassLoader

Field Summary

Fields inherited from class org.eclipse.ecf.remoteservice.client.AbstractClientService

container, registration

Fields inherited from class org.eclipse.ecf.remoteservice.AbstractRemoteService

EMPTY_ARGS, futureExecutorService, futureExecutorServiceMaxThreads, iFutureExecutor

Constructor Summary

Constructors

Constructor and Description
AbstractRSAClientService(AbstractClientContainer container, RemoteServiceClientRegistration registration)

Method Summary

Modifier and Type	Method and Description
protected AbstractRSAClientService.RSARemoteCall	createRemoteCall(Object proxy, Method method, String methodName, Object[] parameters, long timeout)
Object	invoke(Object proxy, Method method, Object[] args)
protected abstract Object	invokeAsync(AbstractRSAClientService.RSARemoteCall remoteCall) Invoke a remote call asynchronously.
protected Object	invokeRemoteCall(IRemoteCall call, IRemoteCallable callable) Invoke remote call.
protected abstract Object	invokeSync(AbstractRSAClientService.RSARemoteCall remoteCall) Invoke a remote call synchronously.

Methods inherited from class org.eclipse.ecf.remoteservice.client.AbstractClientService

callAsync, callAsync, callAsync, callAsync, callSync, createUriRequest, fireAsync, getCallMethodNameForProxyInvoke, getCallParametersForProxyInvoke, getClientContainer, getInterfaceClassNames, getNextRequestID, getRegistration, getRemoteServiceID, getRemoteServiceReference, handleInvokeException, invokeSync, prepareEndpointAddress, prepareParameters, processResponse

Methods inherited from class org.eclipse.ecf.remoteservice.AbstractRemoteService

addAsyncProxyClasses, addRemoteServiceProxyToProxy, callAsync, callAsyncWithResult, callCompletableAsync, callFutureAsync, callFutureAsync, convertInterfaceNameToAsyncInterfaceName, createProxy, createProxy, createRemoteCall, dispose, findAsyncRemoteServiceProxyClass, findAsyncRemoteServiceProxyClass, getAsyncArgs, getAsyncInvokeMethodName, getAsyncRemoteCall, getCallTimeoutForProxyInvoke, getDefaultTimeout, getFutureExecutorService, getIFutureExecutor, getProxy, getProxy, getRemoteService, getRemoteServiceProxyCreator, handleInvokeSyncException, handleProxyException, invokeAsync, invokeObject, isAsync, loadInterfaceClass, loadInterfaceClass, logWarning, setFutureExecutorService, setIFutureExecutor

Methods inherited from class org.eclipse.ecf.remoteservice.asyncproxy.AbstractAsyncProxyRemoteService

callFuture

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractRSAClientService

public AbstractRSAClientService(AbstractClientContainer container,
                                RemoteServiceClientRegistration registration)

Method Detail

invokeRemoteCall

protected Object invokeRemoteCall(IRemoteCall call,
                                  IRemoteCallable callable)
                           throws ECFException

Description copied from class: AbstractClientService

Invoke remote call. The implementation of this method should actually make the remote call for the given call and associated callable.

Specified by:

invokeRemoteCall in class AbstractClientService

Parameters:

call - the remote call to invoke

callable - the remote callable to invoke

Returns:

Object result of remote call

Throws:

ECFException - if invoke fails

invokeAsync

protected abstract Object invokeAsync(AbstractRSAClientService.RSARemoteCall remoteCall)
                               throws ECFException

Invoke a remote call asynchronously. This method should not block and should return either a IFuture, Future, or CompletableFuture or a CompletableFuture based upon the return type defined in the asynchronous service interface.

Parameters:

remoteCall - the RSARemoteCall to use to make the asynchronous remote call. Will not be null.

Returns:

Object. Should return a non-null instance of IFuture, Future, or CompletableFuture

Throws:

ECFException - if async cannot be invoked

invokeSync

protected abstract Object invokeSync(AbstractRSAClientService.RSARemoteCall remoteCall)
                              throws ECFException

Invoke a remote call synchronously. This method should block until a value may be returned, or the remote call has failed or timed out.

Parameters:

remoteCall - the RSARemoteCall to synchronously invoke. Will not be null.

Returns:

the result (of appropriate type)

Throws:

ECFException - if some exception occurred during invocation

createRemoteCall

protected AbstractRSAClientService.RSARemoteCall createRemoteCall(Object proxy,
                                                                  Method method,
                                                                  String methodName,
                                                                  Object[] parameters,
                                                                  long timeout)

invoke

public Object invoke(Object proxy,
                     Method method,
                     Object[] args)
              throws Throwable

Specified by:

invoke in interface InvocationHandler

Overrides:

invoke in class AbstractRemoteService

Throws:

Throwable