目录
一、什么是Feign
二、什么是openfeign
三、使用feign进行开发
四、feign的日志配置
五、契约配置
六、设置超时时间
一、什么是Feign
Feign是Netflix开发的声明式、模板化的HTTP客户端，其灵感来自Retrofit、JAXRS-2.0以及WebSocket。Feign可帮助我们更加便捷、优雅地调用HTTP API。Feign支持多种注解，例如Feign自带的注解或者JAX-RS注解等，Feign可以做到使用 HTTP 请求远程服务时就像调用本地方法一样的体验，开发者完全感知不到这是远程方法，更感知不到这是个 HTTP 请求。它像 Dubbo 一样，consumer 直接调用接口方法调用 provider，而不需要通过常规的 Http Client 构造请求再解析返回数据。它解决了让开发者调用远程接口就跟调用本地方法一样，无需关注与远程的交互细节，更无需关注分布式环境开发。
二、什么是openfeign
由于netflix的闭源，加上feign本身对于开发不是很友好，因为需要额外记feign专门的注解（例如springmvc的@RequestMapping对应feign的注解是@RequestLine("GET /{id}")，还需要通过字符串来指定请求方式），springcloud openfeign对feign进行了增强，使其支持Spring MVC注解，另外还整合了Ribbon和Nacos，从而使得Feign的使用更加方便
三、使用feign进行开发
首先，我们先看一下这里被调用的方法是什么样子的（这是被调用的，和feign的使用无关，用于对比）
@RestController
@RequestMapping("/stock")
public class StockController {
@Value("${server.port}")
String port;
@RequestMapping("/reduct")
public String reduct() throws InterruptedException {
System.out.println("扣减库存");
return "扣减库存:"+port;
}
}
1、引入依赖
1.8 2.2.6.RELEASE 2.3.2.RELEASE Hoxton.SR9 org.springframework.boot spring-boot-startercom.alibaba.cloud spring-cloud-starter-alibaba-nacos-discoveryorg.springframework.cloud spring-cloud-starter-openfeigncom.alibaba.cloud spring-cloud-alibaba-dependencies${spring.cloud.alibaba.version} pom import org.springframework.boot spring-boot-starter-parent${spring.boot.version} pom import org.springframework.cloud spring-cloud-dependencies${spring.cloud.version} pom import
2、编写调用接口+@FeignClient注解
@FeignClient(name="stock-service",path ="/stock",configuration = FeignConfig.class)
public interface StockFeignService {
// 声明需要调用的rest接口对应的方法,requestMapping也与调用的方法中的requestMapping一致
@RequestMapping("/reduct")
String reduct();
}
3、在调用段的启动类上加上@EnableFeignClients注解，表示启动feign
@SpringBootApplication
@EnableFeignClients
public class MallUserFeignDemoApplication {
public static void main(String[] args) {
SpringApplication.run(MallUserFeignDemoApplication.class, args);
}
}
4、发起调用，像调用本地方式一样调用远程服务
@RestController
@RequestMapping("/user")
public class UserController {
@Autowired
OrderFeignService orderFeignService;
@RequestMapping(value = "/findOrderByUserId/{id}")
public R findOrderByUserId(@PathVariable("id") Integer id) {
//feign调用
R result = orderFeignService.findOrderByUserId(id);
return result;
}
}
四、feign的日志配置
在正常情况下，通过feign调用接口是不会输入相关信息的，所以有时候出现一些bug我们也不能准确定位问题，这时候可以打开feign的日志，通过日志来查看相关信息
feign日志的4种级别
NONE【性能最佳，适用于生产】：不记录任何日志（默认值）。BASIC【适用于生产环境追踪问题】：仅记录请求方法、URL、响应状态代码以及执行时间。HEADERS：记录BASIC级别的基础上，记录请求和响应的header。FULL【比较适用于开发及测试环境定位问题】：记录请求和响应的header、body和元数据。
准备阶段：由于springboot的默认的日志级别是info，这会导致信息不能输出，所以需要将feign包下的日志级别改为debug
logging:
level:
com.jjs.mall.feign: debug
全局日志配置：
方式一：通过配置类加上@Configuration即可将日志设置为全局的。
@Configuration
public class FeignConfig {
@Bean
public Logger.Level feignLoggerLevel(){
return Logger.Level.FULL;
}
}
局部日志配置：
方式一：
1、先新建一个配置类（注意：不能加上@Configuration，否则就会变为全局的）
public class FeignConfig {
@Bean
public Logger.Level feignLoggerLevel(){
return Logger.Level.FULL;
}
}
2、在feign的调用接口中的@Feignclient的configuration属性中加上配置类的字节码文件
@FeignClient(name="stock-service",path ="/stock",configuration = FeignConfig.class)
public interface StockFeignService {
// 声明需要调用的rest接口对应的方法,requestMapping也与调用的方法中的requestMapping一致
@RequestMapping("/reduct")
String reduct();
}
方式二：通过配置文件设置
feign:
client:
config:
mall-order: #对应微服务
loggerLevel: FULL #日志级别
五、契约配置
Spring Cloud 在 Feign 的基础上做了扩展，使用 Spring MVC 的注解来完成Feign的功能。原生的 Feign 是不支持 Spring MVC 注解的，如果你想在 Spring Cloud 中使用原生的注解方式来定义客户端也是可以的，通过配置契约来改变这个配置，Spring Cloud 中默认的是 SpringMvcContract。Spring Cloud 1 早期版本就是用的原生Fegin. 随着netflix的停更替换成了Open feign
方式一：配置类
@Bean
public Contract feignContract() {
return new Contract.Default();
}
方式二：配置文件
feign:
client:
config:
mall-order: #对应微服务
loggerLevel: FULL
contract: feign.Contract.Default #指定Feign原生注解契约配置
修改完之后只需要在feign的接口配置中使用原生注解即可
@FeignClient(value = "mall-order",path = "/order")
public interface OrderFeignService {
@RequestLine("GET /findOrderByUserId/{userId}")
public R findOrderByUserId(@Param("userId") Integer userId);
}
六、设置超时时间
方式一：通过配置类全局设置超时时间，通过 Options 可以配置连接超时时间和读取超时时间，Options 的第一个参数是连接的超时时间（ms），默认值是 2s；第二个是请求处理的超时时间（ms），默认值是 5s。
@Configuration
public class FeignConfig {
@Bean
public Request.Options options() {
return new Request.Options(5000, 10000);
}
}
方式二：通过yml设置个别服务的超时时间
feign:
client:
config:
mall-order: #对应微服务
# 连接超时时间，默认2s
connectTimeout: 5000
# 请求处理超时时间，默认5s
readTimeout: 10000
