org.osgi.service.async

Interface Async

@ProviderType
public interface Async

The Async Service, as defined in OSGi RFC 204 https://github.com/osgi/design/tree/master/rfcs/rfc0206

Method Summary

Methods

Modifier and Type	Method and Description
Promise<?>	call() Asynchronously run the last method call registered by a mediated object, returning the result as a Promise.
<R> Promise<R>	call(R r) Asynchronously run the last method call registered by a mediated object, returning the result as a Promise.
Promise<Void>	execute() Asynchronously run the last method call registered by a mediated object, ignoring the return value.
<T> T	mediate(org.osgi.framework.ServiceReference<? extends T> target, Class<T> iface) Create a mediated object for asynchronous calls
<T> T	mediate(T target, Class<T> iface) Create a mediated object for asynchronous calls

Method Detail

mediate

<T> T mediate(T target,
            Class<T> iface)

Create a mediated object for asynchronous calls

Parameters:

target - The object to mediate

iface - The type that the mediated object should implement or extend

Returns:

A mediated object

Throws:

IllegalArgumentException - if mediation fails

mediate

<T> T mediate(org.osgi.framework.ServiceReference<? extends T> target,
            Class<T> iface)

Create a mediated object for asynchronous calls

Parameters:

target - The service reference to mediate

iface - The type that the mediated object should implement or extend

Returns:

A mediated service

Throws:

IllegalArgumentException - if mediation fails

call

<R> Promise<R> call(R r)

Asynchronously run the last method call registered by a mediated object, returning the result as a Promise.

Parameters:

r - the return value of the mediated call

Returns:

a Promise

call

Promise<?> call()

Asynchronously run the last method call registered by a mediated object, returning the result as a Promise.

Returns:

a Promise

execute

Promise<Void> execute()

Asynchronously run the last method call registered by a mediated object, ignoring the return value.

Returns:

a Promise indicating whether the task started successfully