public interface IRemoteService
null
IFuture
instance
that can be polled for results. See IFuture.get()
,
IFuture.get(long)
, and IFuture.isDone()
.
timeout, exception, or successful completion)Modifier and Type | Method and Description |
---|---|
org.eclipse.equinox.concurrent.future.IFuture |
callAsync(IRemoteCall call)
Call remote method specified by call parameter asynchronously, and immediately
return
IFuture instance. |
void |
callAsync(IRemoteCall call,
IRemoteCallListener listener)
Call remote method specified by call parameter asynchronously, and notify
specified listener when call starts and completes.
|
java.lang.Object |
callSync(IRemoteCall call)
Call remote method specified by call parameter synchronously.
|
void |
fireAsync(IRemoteCall call)
Fire remote method specified by call parameter.
|
java.lang.Object |
getProxy()
Get local proxy for remote interface.
|
java.lang.Object |
getProxy(java.lang.ClassLoader cl,
java.lang.Class[] interfaceClasses)
Get local proxy for remote interface.
|
java.lang.Object callSync(IRemoteCall call) throws ECFException
call
- the remote call to makenull
if
remote provides null
as result.ECFException
- thrown if disconnect occurs, caller not currently connected,
or remote throws Exceptionvoid callAsync(IRemoteCall call, IRemoteCallListener listener)
call
- the remote call to make. Must not be null
.listener
- the listener to notify when call starts and is completed. The
listener will be notified via the two event types
IRemoteCallStartEvent and IRemoteCallCompleteEvent. Must not
be null
.IRemoteCallStartEvent
,
IRemoteCallCompleteEvent
org.eclipse.equinox.concurrent.future.IFuture callAsync(IRemoteCall call)
IFuture
instance. Returned IFuture will not be null
,
and allows the caller to retrieve the actual resulting value from the remote call
(or exception).call
- the remote call to make. Must not be null
.IFuture.isDone()
, and then to IFuture.get()
the actual result.void fireAsync(IRemoteCall call) throws ECFException
call
- the remote call to make. Must not be null
.ECFException
- if caller not currently connectedjava.lang.Object getProxy() throws ECFException
null
.ECFException
- If some problem in creating the proxy. The underlying problem is
conveyed in the nested exception.java.lang.Object getProxy(java.lang.ClassLoader cl, java.lang.Class[] interfaceClasses) throws ECFException
cl
- ClassLoader to use to create the proxy class.
Must not be null
.interfaceClasses
- array of Class that has the loaded interface classes.
Must not be null
and should have dimension of one or more.null
ECFException
- If some problem in creating the proxy. The underlying problem is
conveyed in the nested exception.