1、什么是Feign
声明式http客户端
2、如何使用
加依赖
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
加注解
@EnableFeignClients
加配置
无写代码
package com.fj.xiaofeiyang.pay.api.feignclient;
import com.fj.xiaofeiyang.pay.api.domain.entity.pay.MallPay;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
/**
* @author: yangchun
* @description:
* @date: Created in 2020-02-19 19:17
*/
@FeignClient(name = "pay")
public interface PayFeignClient {
@GetMapping("/mallpay/{id}")
MallPay findById(@PathVariable("id") Integer id);
}
feign的组成
接口 | 作用 | 默认值 |
Feign.Builder | Feign的入口 | Feign.Builder |
Client | Feign底层用什么去发起请求 | 和Ribbon配合时:LoadBalancerFeignClient,不和Ribbon配合时feign.Client.Defualt |
Contract | 锲约支持 | Feign不支持springMVC注解,SpringMvcContract |
Encoder | 编码器,用于将对象转换成http消息体 | SpringEncoder |
Decoder | 解码器,将响应消息体转换成对象 | ResponseEntityDecoder |
Logger |
日志管理器 | Slf4jLogger |
RequestInterceptor |
用于为每个请求添加通用逻辑 | 无 |
Feign日志
级别 | 打印内容 |
NONE默认值 | 不记录日志 |
BASIC | 仅记录请求方法、URL、响应状态代码以及执行时间 |
HEADERS | 记录BASIC级别的基础上,记录请求和响应的header |
FULL | 记录请求和响应的header、body和元数据 |
自定义日志级别
package com.fj.xiaofeiyang.pay.api.feignclient;
import com.fj.xiaofeiyang.pay.api.configuration.PayFeignClientConfiguration;
import com.fj.xiaofeiyang.pay.api.domain.entity.pay.MallPay;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
/**
* @author: yangchun
* @description:
* @date: Created in 2020-02-19 19:17
*/
@FeignClient(name = "pay",configuration = PayFeignClientConfiguration.class)
public interface PayFeignClient {
@GetMapping("/mallpay/{id}")
MallPay findById(@PathVariable("id") Integer id);
}
package com.fj.xiaofeiyang.pay.api.configuration;
import feign.Logger;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* @author: yangchun
* @description:
* @date: Created in 2020-02-19 20:42
*/
@Configuration
public class PayFeignClientConfiguration {
@Bean
public Logger.Level logLevel(){
return Logger.Level.BASIC;
}
}
logging:
level:
com.fj.xiaofeiyang.pay.api.feignclient.PayFeignClient: debug
feign日志时建立再包必须输出日志上的,所以必须有debug
属性配置如下
feign:
client:
config:
pay:
loggerLevel: full
以上都是细粒度配置
全局配置两种方式
java代码方式
第一种添加Configuration,父子上下文重叠
第二种
@EnableFeignClients(defaultConfiguration = PayFeignClientConfiguration.class)
配置属性全局配置
feign:
client:
config:
#全局配置
default:
loggerLevel: full
支持的配置项
java代码方式
配置项 | 作用 |
Logger.level |
指定日志级别 |
Retryer |
指定重试策略 |
ErrorDecodre |
指定错误解码器 |
Request.options |
超时 |
Collection<RequestInterceptor> |
拦截器 |
SelectFactory |
用于设置Hystrix配置属性,Feign整合Hystrix才会使用 |
属性配置方式支持的配置项
feign:
client:
config:
#全局配置
default:
loggerLevel: full
connectionTimeout: 5000
readTimeout: 5000
errerDecoder: com.demo.decoder
retryer: com.demo.retryer
requestInterceptors:
- com.demo.FooRequestInterceptor
decode404: false
encoder: com.demo.encoder
decoder: com.demo.decoder
contract: com.demo.Contract
Feign多参数请求
1、GET
@GetMapping("/q")
List<MallPay> query(@SpringQueryMap MallPay mallPay);
第一种不支持继承
@GetMapping("/q")
List<MallPay> query1(@RequestParam("id") Integer id);
@GetMapping("/q")
List<MallPay> query2(@RequestParam Map<String,Object> mallPay);
@GetMapping("/q")
public List<MallPay> query(MallPay mallPay){
return mallPayMapper.select(mallPay);
}
@GetMapping("/q")
public List<MallPay> query1(MallPay mallPay){
return mallPayMapper.select(mallPay);
}
@GetMapping("/q")
public List<MallPay> query2(MallPay mallPay){
return mallPayMapper.select(mallPay);
}
2、POST