Feign makes writing java http clients easier
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
|
|
|
# Ribbon
|
|
|
|
|
|
This module includes a feign `Target` and `Client` adapter to take advantage of [Ribbon](https://github.com/Netflix/ribbon).
|
|
|
|
|
|
|
|
|
|
|
|
## Conventions
|
|
|
|
|
|
This integration relies on the Feign `Target.url()` being encoded like `https://myAppProd` where `myAppProd` is the ribbon client or loadbalancer name and `myAppProd.ribbon.listOfServers` configuration is set.
|
|
|
|
|
|
|
|
|
|
|
|
### RibbonModule
|
|
|
|
|
|
Adding `RibbonModule` overrides URL resolution of Feign's client, adding smart routing and resiliency capabilities provided by Ribbon.
|
|
|
|
|
|
|
|
|
|
|
|
#### Usage
|
|
|
|
|
|
instead of
|
|
|
|
|
|
```java
|
|
|
|
|
|
MyService api = Feign.create(MyService.class, "https://myAppProd-1234567890.us-east-1.elb.amazonaws.com");
|
|
|
|
|
|
```
|
|
|
|
|
|
do
|
|
|
|
|
|
```java
|
|
|
|
|
|
MyService api = Feign.create(MyService.class, "https://myAppProd", new RibbonModule());
|
|
|
|
|
|
```
|
|
|
|
|
|
### LoadBalancingTarget
|
|
|
|
|
|
Using or extending `LoadBalancingTarget` will enable dynamic url discovery via ribbon including incrementing server request counts.
|
|
|
|
|
|
|
|
|
|
|
|
#### Usage
|
|
|
|
|
|
instead of
|
|
|
|
|
|
```java
|
|
|
|
|
|
MyService api = Feign.create(MyService.class, "https://myAppProd-1234567890.us-east-1.elb.amazonaws.com");
|
|
|
|
|
|
```
|
|
|
|
|
|
do
|
|
|
|
|
|
```java
|
|
|
|
|
|
MyService api = Feign.create(LoadBalancingTarget.create(MyService.class, "https://myAppProd"));
|
|
|
|
|
|
```
|
