什么是Feigin
- Feign是Netflix开发的声明式、模板化的HTTP客户端,其灵感来自Retrofit、JAXRS-2.0以及 WebSocket。Feign可帮助我们更加便捷、优雅地调用HTTP API。
- 在Spring Cloud中,使用Feign非常简单—─创建一个接口,并在接口上添加一些注解,代码就完成了。Feign支持多种注解,例如 Feign自带的注解或者JAX-RS注解等。
- Spring Cloud对 Feign进行了增强,使Feign支持了Spring MVC注解,并整合了Ribbon和 Eureka,从而让Feign的使用更加方便。
使用Fegin步骤
1. 添加pom文件
<!--Feign HTTP 请求调用-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
2. 启动类添加@EnableFeignClients
@SpringBootApplication
@EnableFeignClients
public class CloudClientApplication {
public static void main(String[] args) {
SpringApplication.run(CloudClientApplication.class, args);
}
}
3. 声明远程调用
@Component
@FeignClient(name = "cloud-provider",path = "/hello")
public interface HelloService {
@RequestMapping("getHello")
String getProduct();
}
@FeignClient所含有的字段
- name:是服务名称,注册到eureka的服务名称
- path:是定义当前FeignClient的统一前缀,可以不写,在@RequestMapping中写也行
- url: url一般用于调试,可以手动指定@FeignClient调用的地址
- decode404:当发生http 404错误时,如果该字段位true,会调用decoder进行解码,否则抛出FeignException
- configuration: Feign配置类,可以自定义Feign的Encoder、Decoder、LogLevel、Contract
- fallback: 定义容错的处理类,当调用远程接口失败或超时时,会调用对应接口的容错逻辑,fallback指定的类必须实现@FeignClient标记的接口
- configuration: Feign配置类,可以自定义Feign的Encoder、Decoder、LogLevel、Contract
Fegin的自定义配置
自定义配置一般修改日志,日志可以yml文件和bean注入配合注解使用
yml
全局配置
feign:
client:
config:
default: # 这里用default就是全局配置,如果是写服务名称,则是针对某个微服务的配置
loggerLevel: FULL # 日志级别
局部配置
feign:
client:
config:
userservice: # 这里用default就是全局配置,如果是写服务名称,则是针对某个微服务的配置
loggerLevel: FULL # 日志级别
bean注入配合注解使用
先声明配置类 FeignClientConfiguration
public class FeignClientConfiguration {
@Bean
public Logger.Level loglevel(){
return Logger.Level.FULL;
}
}
全局配置
如果是全局配置,放到启动类中的@EnableFeignClients中defaultConfiguration:
@EnableFeignClients(defaultConfiguration = FeignClientConfiguration.class)
局部配置
如果是局部配置,则把它放到服务接口的@FeignClient这个注解中:
@FeignClient(name = "userservice", configuration = FeignClientConfiguration.class)
Fegin的优化
优化Fegin的性能主要包括
- 使用连接池代替默认的URLConnection,减少三次握手和四次挥手
- 日志级别最好使用BASIC或NONE,减少日志对性能的损耗
Feign底层的客户端实现
- URLConnection:默认实现,不支持连接池,每次请求需要TCP三次握手和四次挥手
- Apache HttpClient :支持连接池
- OKHttp:支持连接池
Feign添加HttpClient的支持
1. 引入依赖
<!--Feign-HttpClient连接池-->
<dependency>
<groupId>io.github.openfeign</groupId>
<artifactId>feign-httpclient</artifactId>
</dependency>
2. 配置连接池
feign:
httpclient: #配置连接池
enabled: true #开启Feign对httpclient的支持
max-connections: 200 #最大连接数
max-connections-per-route: 50 # 每个路径的最大连接数
Feign在工程中的最佳实践
- 首先创建一 个module, 命名为feign-api,然后引入feign的starter依赖
- 将order-service中 编写的UserClient、User、DefaultFeignConfiguration都复 制到feign-api项目中
- 在order-service中 引入feign-api的依赖
- 修改order-service中 的所有与上述三个组件有关的import部分,改成导入feign-api中的包
- 重启测试
此时会启动报错,因为当定义的FeignClient不在SpringBootApplication的扫描包范围时,这些FeignClient无法使用。
有两种方式解决:
方式一:指定FeignClient所在包(大范围)
@EnableFeignClients(basePackages = "cn . itcast . feign. clients")
方式二:指定FeignClient字节码(具体)
@EnabLeFeignClients (clients = {UserClient. cLass})