org.springframework.cloud.openfeign

Annotation Type FeignClient

@Target(value=TYPE)
 @Retention(value=RUNTIME)
 @Documented
public @interface FeignClient

Annotation for interfaces declaring that a REST client with that interface should be created (e.g. for autowiring into another component). If ribbon is available it will be used to load balance the backend requests, and the load balancer can be configured using a @RibbonClient with the same name (i.e. value) as the feign client.

Author:

Spencer Gibb, Venil Noronha

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class<?>[]	configuration A custom @Configuration for the feign client.
String	contextId This will be used as the bean name instead of name if present, but will not be used as a service id.
boolean	decode404
Class<?>	fallback Fallback class for the specified Feign client interface.
Class<?>	fallbackFactory Define a fallback factory for the specified Feign client interface.
String	name
String	path
boolean	primary
String	qualifier
String	serviceId Deprecated. use name instead
String	url
String	value The name of the service with optional protocol prefix.

Element Detail

value

@AliasFor(value="name")
public abstract String value

The name of the service with optional protocol prefix. Synonym for name. A name must be specified for all clients, whether or not a url is provided. Can be specified as property key, eg: ${propertyKey}.

Returns:

the name of the service with optional protocol prefix

Default:

""

serviceId

@Deprecated
public abstract String serviceId

Deprecated. use name instead

The service id with optional protocol prefix. Synonym for value.

Returns:

the service id with optional protocol prefix

Default:

""

contextId

public abstract String contextId

This will be used as the bean name instead of name if present, but will not be used as a service id.

Returns:

bean name instead of name if present

Default:

""

name

@AliasFor(value="value")
public abstract String name

Returns:

The service id with optional protocol prefix. Synonym for value.

Default:

""

qualifier

public abstract String qualifier

Returns:

the @Qualifier value for the feign client.

Default:

""

url

public abstract String url

Returns:

an absolute URL or resolvable hostname (the protocol is optional).

Default:

""

decode404

public abstract boolean decode404

Returns:

whether 404s should be decoded instead of throwing FeignExceptions

Default:

false

configuration

public abstract Class<?>[] configuration

A custom @Configuration for the feign client. Can contain override @Bean definition for the pieces that make up the client, for instance Decoder, Encoder, Contract.

Returns:

list of configurations for feign client

See Also:

for the defaults

Default:

{}

fallback

public abstract Class<?> fallback

Fallback class for the specified Feign client interface. The fallback class must implement the interface annotated by this annotation and be a valid spring bean.

Returns:

fallback class for the specified Feign client interface

Default:

void.class

fallbackFactory

public abstract Class<?> fallbackFactory

Define a fallback factory for the specified Feign client interface. The fallback factory must produce instances of fallback classes that implement the interface annotated by FeignClient. The fallback factory must be a valid spring bean.

Returns:

fallback factory for the specified Feign client interface

See Also:

for details.

Default:

void.class

path

public abstract String path

Returns:

path prefix to be used by all method-level mappings. Can be used with or without @RibbonClient.

Default:

""

primary

public abstract boolean primary

Returns:

whether to mark the feign proxy as a primary bean. Defaults to true.

Default:

true