feign

Class AsyncFeign<C>

java.lang.Object

feign.Feign

feign.AsyncFeign<C>

Direct Known Subclasses:

ReflectiveAsyncFeign

@Experimental
public abstract class AsyncFeign<C>
extends Feign

Enhances Feign to provide support for asynchronous clients. Context (for example for session cookies or tokens) is explicit, as calls for the same session may be done across several threads.

Retryer is not supported in this model, as that is a blocking API. ExceptionPropagationPolicy is made redundant as RetryableException is never thrown.
Alternative approaches to retrying can be handled through clients.

Target interface methods must return CompletableFuture with a non-wildcard type. As the completion is done by the AsyncClient, it is important that any subsequent processing on the thread be short - generally, this should involve notifying some other thread of the work to be done (for example, creating and submitting a task to an ExecutorService).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AsyncFeign.AsyncBuilder<C>

Nested classes/interfaces inherited from class feign.Feign

Feign.Builder, Feign.ResponseMappingDecoder

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AsyncFeign(AsyncFeign.AsyncBuilder<C> asyncBuilder)

Method Summary

Modifier and Type	Method and Description
static <C> AsyncFeign.AsyncBuilder<C>	asyncBuilder()
protected void	clearInvocationContext()
<T> T	newInstance(Target<T> target) Returns a new instance of an HTTP API, defined by annotations in the Contract, for the specified target.
<T> T	newInstance(Target<T> target, C context)
protected void	setInvocationContext(feign.AsyncInvocation<C> invocationContext)
protected abstract <T> T	wrap(Class<T> type, T instance, C context)

Methods inherited from class feign.Feign

builder, configKey, configKey

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AsyncFeign

protected AsyncFeign(AsyncFeign.AsyncBuilder<C> asyncBuilder)

Method Detail

asyncBuilder

public static <C> AsyncFeign.AsyncBuilder<C> asyncBuilder()

setInvocationContext

protected void setInvocationContext(feign.AsyncInvocation<C> invocationContext)

clearInvocationContext

protected void clearInvocationContext()

newInstance

public <T> T newInstance(Target<T> target)

Description copied from class: Feign

Returns a new instance of an HTTP API, defined by annotations in the Contract, for the specified target. You should cache this result.

Specified by:

newInstance in class Feign

newInstance

public <T> T newInstance(Target<T> target,
                         C context)

wrap

protected abstract <T> T wrap(Class<T> type,
                              T instance,
                              C context)