Spring Cloud OpenFeign 中文手册 菜鸡翻译

除了更改集合的名称以外，还 使用注释的contextId属性，它将覆盖客户端名称的别名，并将其用作为该客户端创建的配置Bean名称的一部分。 @FeignClient``ApplicationContext

以前，使用url属性不需要name属性。name现在需要使用。

name和url属性中支持占位符。

@FeignClient(name = “$feign.name",url="${feign.url}”)

public interface StoreClient {

//…

}

Spring Cloud OpenFeign默认为假装提供以下bean（BeanTypebeanName ：）ClassName：

• DecoderfeignDecoder ：（ResponseEntityDecoder包含SpringDecoder）

• Encoder feignEncoder： SpringEncoder

• Logger feignLogger： Slf4jLogger

• Contract feignContract： SpringMvcContract

• Feign.Builder feignBuilder： HystrixFeign.Builder

• ClientfeignClient：如果Ribbon在类路径中且已启用，则为LoadBalancerFeignClient，否则，如果Spring Cloud LoadBalancer在类路径中，FeignBlockingLoadBalancerClient则使用。如果它们都不在类路径中，则使用默认的客户端。

spring-cloud-starter-openfeign同时支持spring-cloud-starter-netflix-ribbon和spring-cloud-starter-loadbalancer。但是，由于它们是可选的依赖项，因此需要确保将要使用的依赖项添加到项目中。

OkHttpClient和ApacheHttpClient客户端可以通过设置一起使用feign.okhttp.enabled或feign.httpclient.enabled以true分别，以及具有它们的类路径上。您可以通过org.apache.http.impl.client.CloseableHttpClient在使用Apache或okhttp3.OkHttpClient使用OK HTTP时提供Bean来定制所使用的HTTP客户端。

默认情况下，Spring Cloud OpenFeign_不会_为Feign提供以下bean，但仍会从应用程序上下文中查找这些类型的bean以创建Feign客户端：

• Logger.Level

• Retryer

• ErrorDecoder

• Request.Options

• Collection<RequestInterceptor>

• SetterFactory

• QueryMapEncoder

默认情况下会创建Retryer.NEVER_RETRY具有类型的Bean Retryer，这将禁用重试。请注意，此重试行为不同于Feign的默认行为，在Feign默认行为中，它将自动重试IOException，将它们视为与网络临时相关的异常，以及从ErrorDecoder抛出的任何RetryableException。

创建这些类型之一的bean并将其放置在@FeignClient配置中（例如FooConfiguration上述配置），您可以覆盖所描述的每个bean。例：

@Configuration

public class FooConfiguration {

@Bean

public Contract feignContract() {

return new feign.Contract.Default();

}

@Bean

public BasicAuthRequestInterceptor basicAuthRequestInterceptor() {

return new BasicAuthRequestInterceptor(“user”, “password”);

}

}

替换为SpringMvcContract，并向的集合feign.Contract.Default添加。RequestInterceptor``RequestInterceptor

@FeignClient 也可以使用配置属性进行配置。

application.yml

feign:

client:

config:

feignName:

connectTimeout: 5000

readTimeout: 5000

loggerLevel: full

errorDecoder: com.example.SimpleErrorDecoder

retryer: com.example.SimpleRetryer

requestInterceptors:

• com.example.FooRequestInterceptor

• com.example.BarRequestInterceptor

decode404: false

encoder: com.example.SimpleEncoder

decoder: com.example.SimpleDecoder

contract: com.example.SimpleContract

可以按照与上述类似的方式在@EnableFeignClients属性defaultConfiguration中指定默认配置。不同之处在于此配置将适用于_所有_客户端。

如果您希望使用配置属性来配置所有 @FeignClient，则可以使用default假名创建配置属性。

application.yml

feign:

client:

config:

default:

connectTimeout: 5000

readTimeout: 5000

loggerLevel: basic

如果我们同时创建@Configurationbean和配置属性，则配置属性将获胜。它将覆盖@Configuration值。但是，如果要将优先级更改为@Configuration，则可以更改feign.client.default-to-properties为false。

如果需要ThreadLocal在您的系统中使用绑定变量，RequestInterceptors you will need to either set the thread isolation strategy for Hystrix to SEMAPHORE或者在Feign中禁用Hystrix。

application.yml

To disable Hystrix in Feign

feign:

hystrix:

enabled: false

To set thread isolation to SEMAPHORE

hystrix:

command:

default:

execution:

isolation:

strategy: SEMAPHORE

如果我们要创建多个具有相同名称或URL的伪客户端，以便它们指向同一台服务器，但每个客户端具有不同的自定义配置，则必须使用的contextId属性，@FeignClient以避免这些配置Bean的名称冲突。

@FeignClient(contextId = “fooClient”, name = “stores”, configuration = FooConfiguration.class)

public interface FooClient {

//…

}

@FeignClient(contextId = “barClient”, name = “stores”, configuration = BarConfiguration.class)

public interface BarClient {

//…

}

还可以将FeignClient配置为不从父上下文继承bean。您可以通过重写这样做inheritParentConfiguration()的FeignClientConfigurer bean来回报false：

@Configuration

public class CustomConfiguration{

@Bean

public FeignClientConfigurer feignClientConfigurer() {

return new FeignClientConfigurer() {

@Override

public boolean inheritParentConfiguration() {

return false;

}

};

}

}

1.3 手动创建Feign

在某些情况下，可能有必要使用上述方法无法实现的方式自定义Feign客户。在这种情况下，您可以使用Feign Builder API创建客户端 。下面是一个示例，该示例创建具有相同接口的两个Feign Client，但为每个Feign Client配置一个单独的请求拦截器。

@Import(FeignClientsConfiguration.class)

class FooController {

private FooClient fooClient;

private FooClient adminClient;

@Autowired

public FooController(Decoder decoder, Encoder encoder, Client client, Contract contract) {

this.fooClient = Feign.builder().client(client)

.encoder(encoder)

.decoder(decoder)

.contract(contract)

.requestInterceptor(new BasicAuthRequestInterceptor(“user”, “user”))

.target(FooClient.class, “https://PROD-SVC”);

this.adminClient = Feign.builder().client(client)

.encoder(encoder)

.decoder(decoder)

.contract(contract)

.requestInterceptor(new BasicAuthRequestInterceptor(“admin”, “admin”))

.target(FooClient.class, “https://PROD-SVC”);

}

}

在上面的示例中，FeignClientsConfiguration.class是Spring Cloud OpenFeign提供的默认配置。

PROD-SVC 是客户将向其请求的服务的名称。

FeignContract对象定义在接口上有效的注释和值。自动装配的Contractbean提供对SpringMVC注释的支持，而不是默认的Feign本机注释。

您也可以在Builderto configure FeignClient not to inherit beans from the parent context. You can do this by overriding calling inheritParentContext(false)上使用Builder。

1.4 Feign Hystrix支持

如果Hystrix在classpath和上feign.hystrix.enabled=true，Feign将使用断路器包装所有方法。com.netflix.hystrix.HystrixCommand还可以返回 。这允许您使用反应模式（与以打电话.toObservable()或.observe()或异步使用（通过调用.queue()）。

要基于每个客户端禁用Hystrix支持，请创建Feign.Builder具有“原型”范围的香草，例如：

@Configuration

public class FooConfiguration {

@Bean

@Scope(“prototype”)

public Feign.Builder feignBuilder() {

return Feign.builder();

}

}

在Spring Cloud Dalston发行之前，如果Hystrix在类路径中，Feign默认会将所有方法包装在断路器中。Spring Cloud Dalston中更改了此默认行为，以支持选择加入方法。

1.5 Feign Hystrix Fallbacks

Hystrix支持回退的概念：当它们的电路断开或出现错误时执行的默认代码路径。要为给定@FeignClient集启用后备，该fallback属性应为实现后备的类名称。您还需要将实现声明为Spring bean。

@FeignClient(name = “hello”, fallback = HystrixClientFallback.class)

protected interface HystrixClient {

@RequestMapping(method = RequestMethod.GET, value = “/hello”)

Hello iFailSometimes();

}

static class HystrixClientFallback implements HystrixClient {

@Override

public Hello iFailSometimes() {

return new Hello(“fallback”);

}

}

如果需要访问引起后备触发器的原因，则可以使用fallbackFactory里面的属性@FeignClient。

@FeignClient(name = “hello”, fallbackFactory = HystrixClientFallbackFactory.class)

protected interface HystrixClient {

@RequestMapping(method = RequestMethod.GET, value = “/hello”)

Hello iFailSometimes();

}

@Component

static class HystrixClientFallbackFactory implements FallbackFactory {

@Override

public HystrixClient create(Throwable cause) {

return new HystrixClient() {

@Override

public Hello iFailSometimes() {

return new Hello("fallback; reason was: " + cause.getMessage());

}

};

}

}

Feign中的后备实现以及Hystrix后备如何工作存在局限性。返回com.netflix.hystrix.HystrixCommand和的方法目前不支持后备rx.Observable。

1.6 Feign @Primary

将Feign与Hystrix后备一起使用ApplicationContext时，同一类型的多个bean 。这将导致@Autowired无法正常工作，因为没有确切的一个bean，也没有一个标记为主要的bean。为了解决这个问题，Spring Cloud OpenFeign将所有Feign实例标记为@Primary，因此Spring Framework将知道要注入哪个bean。在某些情况下，这可能不是理想的。要关闭此行为，请将primary属性设置@FeignClient为false。

@FeignClient(name = “hello”, primary = false)

public interface HelloClient {

// methods here

}

1.7 Feign支持继承

Feign通过单继承接口支持样板API。这允许将常用操作分组为方便的基本接口。

UserService.java

public interface UserService {

@RequestMapping(method = RequestMethod.GET, value =“/users/{id}”)

User getUser(@PathVariable(“id”) long id);

}

UserResource.java

@RestController

public class UserResource implements UserService {

}

UserClient.java

小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Java工程师，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新Java开发全套学习资料》送给大家，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频

如果你觉得这些内容对你有帮助，可以添加下面V无偿领取！（备注Java）

最后

俗话说，好学者临池学书，不过网络时代，对于大多数的我们来说，我倒是觉得学习意识的觉醒很重要，这是开始学习的转折点，比如看到对自己方向发展有用的信息，先收藏一波是一波，比如如果你觉得我这篇文章ok，先点赞收藏一波。这样，等真的沉下心来学习，不至于被找资料分散了心神。慢慢来，先从点赞收藏做起，加油吧！

另外，给大家安排了一波学习面试资料：

以上就是本文的全部内容，希望对大家的面试有所帮助，祝大家早日升职加薪迎娶白富美走上人生巅峰！

望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。**
[外链图片转存中…(img-ZUdXI0IW-1710739501767)]
[外链图片转存中…(img-7VAUGuq9-1710739501768)]
[外链图片转存中…(img-RUIthRnO-1710739501768)]

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频

如果你觉得这些内容对你有帮助，可以添加下面V无偿领取！（备注Java）
[外链图片转存中…(img-lhHYj8KF-1710739501768)]

最后

俗话说，好学者临池学书，不过网络时代，对于大多数的我们来说，我倒是觉得学习意识的觉醒很重要，这是开始学习的转折点，比如看到对自己方向发展有用的信息，先收藏一波是一波，比如如果你觉得我这篇文章ok，先点赞收藏一波。这样，等真的沉下心来学习，不至于被找资料分散了心神。慢慢来，先从点赞收藏做起，加油吧！

另外，给大家安排了一波学习面试资料：

[外链图片转存中…(img-8PzZeIMp-1710739501769)]

[外链图片转存中…(img-K4eyjVOP-1710739501769)]

以上就是本文的全部内容，希望对大家的面试有所帮助，祝大家早日升职加薪迎娶白富美走上人生巅峰！

本文已被CODING开源项目：【一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码】收录