Spring Cloud Netflix Feign vnd.error decoder
A custom error decoder for Netflix Feign that will unmarshall vnd.error.
Features
A custom Feign ErrorDecoder capable of handling JSON vnd.error responses.
Setup
Add the Spring Cloud starter to your project:
<dependency>
<groupId>com.github.jmnarloch</groupId>
<artifactId>feign-vnderror-spring-cloud-starter</artifactId>
<version>1.2.0</version>
</dependency>
Usage
First on server side make sure that your exception handling logic will return VndErrors (this is part of Spring Hateoas project). You can accomplish that by registering custom @ExceptionHandler
in your application
@ExceptionHandler
ResponseEntity<VndErrors> someExceptionHandler(SomeException e) {
String logref = UUID.randomUUID();
HttpHeaders httpHeaders = new HttpHeaders();
httpHeaders.setContentType(MediaType.parseMediaType("application/vnd.error+json"));
return new ResponseEntity<>(new VndErrors(logref, e.getMessage()), httpHeaders, HttpStatus.INTERNAL_SERVER_ERROR);
}
Place it in your @Controller
or @ControllerAdvice
annotated beans. You can populate the logref with some meaningful identifier that afterwards could be used during log analysis. Generally it could be a good idea to add HandlerInterceptor to populate request scoped identifier on preHandle()
.
The error decoding happens base on content type matching so it is crucial to return application/vnd.error+json
as response content type.
You use your Feign clients in the same manner as in any other cases, the only difference is that whenever a client call will end with vnd.error you should expect VndErrorException
instead of FeignException
.
Example:
try {
feignClient.operation();
} catch (VndErrorException exc) {
...
}
The VndErrorException
makes very convenient to passthrough exceptions, if you call remote service from a web application you can register @ExceptionHandler
and return the original vnd.error retrieved from the VndErrorException
.
Properties
feign.vnderror.enabled=true # whether to enable the vnd error decoder, true by default
Migration to 1.2.x
The VndErrorException has been reworked to include extra request information like http status, http headers and response body, replacing the existing exception constructors.
Also effort has been made to include the exception type directly in Spring HATEOAS.
License
Apache 2.0