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.
boolean	decode404 Whether 404s should be decoded instead of throwing FeignExceptions
Class<?>	fallback Fallback class for the specified Feign client interface.
Class<?>	fallbackFactory Define a fallback factory for the specified Feign client interface.
String	name The service id with optional protocol prefix.
String	path Path prefix to be used by all method-level mappings.
boolean	primary Whether to mark the feign proxy as a primary bean.
String	qualifier Sets the @Qualifier value for the feign client.
String	serviceId Deprecated. use name instead
String	url An absolute URL or resolvable hostname (the protocol is optional).
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}.

Default:

""

serviceId

@Deprecated
public abstract String serviceId

Deprecated. use name instead

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

Default:

""

name

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

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

Default:

""

qualifier

public abstract String qualifier

Sets the @Qualifier value for the feign client.

Default:

""

url

public abstract String url

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

Default:

""

decode404

public abstract boolean decode404

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.

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.

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.

See Also:

for details.

Default:

void.class

path

public abstract String path

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

Default:

""

primary

public abstract boolean primary

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

Default:

true