Top Description Methods
org.osgi.service.async.delegate

public Interface AsyncDelegate

Annotations
@ConsumerType
Imports
java.lang.reflect.Method, org.osgi.annotation.versioning.ConsumerType, org.osgi.util.promise.Promise
This interface is used by services to allow them to optimize Asynchronous calls where they are capable of executing more efficiently.

This may mean that the service has access to its own thread pool, or that it can delegate work to a remote node, or act in some other way to reduce the load on the Asynchronous Services implementation when making an asynchronous call.

Method Summary

Modifier and TypeMethod and Description
public Promise<?>

Returns:

A Promise representing the asynchronous result, or null if this method cannot be asynchronously invoked.
async(Method
The method to be asynchronously invoked.
m, Object[]
The arguments to be used to invoke the method.
args)

Invoke the specified method as an asynchronous task with the specified arguments.

public boolean

Returns:

true if the asynchronous execution request has been accepted, or false if this method cannot be asynchronously invoked by the AsyncDelegate.
execute(Method
The method to be asynchronously invoked.
m, Object[]
The arguments to be used to invoke the method.
args)

Invoke the specified method as a "fire-and-forget" asynchronous task with the specified arguments.

Method Detail

asyncback to summary
public Promise<?> async(Method m, Object[] args) throws Exception

Invoke the specified method as an asynchronous task with the specified arguments.

This method can be used by clients, or the Async Service, to optimize Asynchronous execution of methods.

When called, this method should invoke the supplied method using the supplied arguments asynchronously, returning a Promise that can be used to access the result.

If the method cannot be executed asynchronously by this method then null must be returned.

Parameters
m:Method

The method to be asynchronously invoked.

args:Object[]

The arguments to be used to invoke the method.

Returns:Promise<?>

A Promise representing the asynchronous result, or null if this method cannot be asynchronously invoked.

Exceptions
Exception:
An exception should be thrown only if there was a serious error that prevented the asynchronous task from starting. For example, the specified method does not exist on this object. Exceptions must not be thrown to indicate that the call does not support asynchronous invocation. Instead this method must return null. Exceptions must also not be thrown to indicate a failure from the execution of the underlying method. This must be handled by failing the returned Promise.
executeback to summary
public boolean execute(Method m, Object[] args) throws Exception

Invoke the specified method as a "fire-and-forget" asynchronous task with the specified arguments.

This method can be used by clients, or the Async Service, to optimize Asynchronous execution of methods.

When called, this method should invoke the specified method using the specified arguments asynchronously. This method differs from async(Method, Object[]) in that it does not return a Promise. This method therefore allows the implementation to perform more aggressive optimizations because the end result of the invocation does not need to be returned to the caller.

If the method cannot be executed asynchronously by this method then false must be returned.

Parameters
m:Method

The method to be asynchronously invoked.

args:Object[]

The arguments to be used to invoke the method.

Returns:boolean

true if the asynchronous execution request has been accepted, or false if this method cannot be asynchronously invoked by the AsyncDelegate.

Exceptions
Exception:
An exception should be thrown only if there was a serious error that prevented the asynchronous task from starting. For example, the specified method does not exist on this object. Exceptions must not be thrown to indicate that the call does not support asynchronous invocation. Instead this method must return false. Exceptions must also not be thrown to indicate a failure from the execution of the underlying method.