org.glassfish.jersey.client.rx.spi

Interface RxInvokerProvider

All Known Implementing Classes:

RxCompletionStageInvokerProvider, RxListenableFutureInvokerProvider, RxObservableInvokerProvider

@Contract
 @ConstrainedTo(value=CLIENT)
public interface RxInvokerProvider

Client-provider interface for creating reactive invoker instances. If supported by the provider, an invoker instance of the requested Java type will be created.

A provider shall support a one-to-one mapping between a type, provided the type is not Object. A provider may also support mapping of sub-types of a type (provided the type is not Object). It is expected that each provider supports mapping for distinct set of types and subtypes so that different providers do not conflict with each other.

An implementation can identify itself by placing a Java service provider configuration file (if not already present) - org.glassfish.jersey.client.rx.spi.RxInvokerProvider - in the resource directory META-INF/services, and adding the fully qualified service-provider-class of the implementation in the file.

Since:

2.13

Author:

Michal Gajdos

Method Summary

Modifier and Type	Method and Description
<RX> RX	getInvoker(Class<RX> invokerType, javax.ws.rs.client.Invocation.Builder builder, ExecutorService executor) Create an invoker of a given type.

Method Detail

getInvoker

<RX> RX getInvoker(Class<RX> invokerType,
                   javax.ws.rs.client.Invocation.Builder builder,
                   ExecutorService executor)

Create an invoker of a given type.

Type Parameters:

RX - the concrete reactive invocation type.

Parameters:

invokerType - the invoker type.

builder - the builder to create JAX-RS invocation invoked in reactive way.

executor - the executor service to execute reactive requests.

Returns:

the invoker, otherwise null if the provider does not support the requested type.

Throws:

javax.ws.rs.ProcessingException - if there is an error creating the invoker.