mandala.rami
Interface ResultUpdater

All Known Subinterfaces:

FutureServer, RemoteFutureServer, RemoteResultUpdater

All Known Implementing Classes:

RemoteResultUpdaterProxy

public interface ResultUpdater

This interface provides methods to update a future object used to handle an asynchronous method invocation.

This interface is not intended to be used by end-user.

This interface is dedicated to set some fields of its implementation business part such as the result or the exception thrown during the asynchronous call.

Version:

1.0

Method Summary

void	setCalleeThread(ThreadOp callee) Deprecated. The usability of the callee thread depends on the asynchronous policy used by the AsynchronousReference implementation. For example, if a thread-pool is used, the callee thread returned may be running a completely different method than the one called. Hence, callee thread use is error prone. No replacement. Current implementations always give null. This method will be removed in the next light release.
void	setResult(java.lang.Object result, java.lang.Throwable throwable) Set the result of the asynchronous method invocation.
void	setStarted() Informs clients that the method is being started.

Method Detail

setResult

public void setResult(java.lang.Object result,
                      java.lang.Throwable throwable)

Set the result of the asynchronous method invocation.

The result may be either the returned value of the method or the thrown exception.

Result must be considered available after this call.

Parameters:

result - the result returned by an asynchronous method invocation, which can be null.

throwable - the exception thrown by an asynchronous method invocation, a null value is considered as no exception has been thrown.

setCalleeThread

public void setCalleeThread(ThreadOp callee)

Deprecated.

The usability of the callee thread depends on the asynchronous policy used by the AsynchronousReference implementation. For example, if a thread-pool is used, the callee thread returned may be running a completely different method than the one called. Hence, callee thread use is error prone. No replacement. Current implementations always give null. This method will be removed in the next light release.

Set the thread which has been created for the invocation of the method.

Parameters:

callee - the thread which has been created for the invocation of the method

setStarted

public void setStarted()

Informs clients that the method is being started.

Since:

3.0