一款轻量级的声明式http调用工具！

阅读原文时间：2021年04月29日阅读：1

项目中我们经常会使用HTTP工具向外部的REST接口发送请求，大家一般使用Okhttp,或者java的HttpClient发起，今天给大家介绍一款轻量级声明式的Http库（FeignClient），使用起来会使我们的项目代码更整洁，利于维护！

Feign是spring cloud中服务消费端的调用框架,通常与ribbon,hystrix等组合使用。但是在某些项目中，由于遗留原因，整个系统并不是spring cloud项目，甚至不是spring项目，而使用者关注的重点仅仅是简化http调用代码的编写。如果采用httpclient或者okhttp这样相对较重的框架，对初学者来说编码量与学习曲线都会是一个挑战，而使用spring中RestTemplate，又没有配置化的解决方案，由此想到是否可以脱离spring cloud，独立使用Feign。

引入依赖

com.netflix.feign feign-core 8.18.0 com.netflix.feign feign-gson 8.18.0
定义接口

public interface OuterService { @RequestLine("GET /requesr/list?name={name}") @Headers("Authorization: Basic {token}") String request(@Param(value = "name") String name，@Param(value = "token") String token);}

通过@RequestLine指定HTTP请求方式及URL地址，@Param指定参数，可以在url或者header中使用{参数名}去填充请求参数。

配置类

OuterService service = Feign.builder() .options(new Options(1000, 3500)) .retryer(new Retryer.Default(5000, 5000, 3)) .target(OuterService.class, "http://127.0.0.1:8085");
开始调用

service.request("test","ad12hj3bhj1b23hj1b2");

在项目中，我们发起的Http请求往往都是json格式，feign同样提供基于json的对象转换工具，方便我们直接以对象形式交互。

接口层面指定header：

@Headers({"Content-Type: application/json","Accept: application/json"})
指定Encoder跟Decoder

## 指定Gson序列化。也可以使用Jackson序列化（引入其依赖）OuterService service = Feign.builder() .encoder(new GsonEncoder()) .decoder(new GsonDecoder()) .options(new Options(1000, 3500)) .retryer(new Retryer.Default(5000, 5000, 3)) .target(OuterService.class, "http://127.0.0.1:8085");

支持我们完成声明式Http接口调用

在配置代理类时可以自定义拦截器

OuterService&nbsp;service&nbsp;=&nbsp;Feign.builder()&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.encoder(new&nbsp;GsonEncoder())&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.decoder(new&nbsp;GsonDecoder())&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.requestInterceptor(template&nbsp;->&nbsp;{&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;template&nbsp;可以获取/修改body，header等信息&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;})&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.options(new&nbsp;Options(1000,&nbsp;3500))&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.retryer(new&nbsp;Retryer.Default(5000,&nbsp;5000,&nbsp;3))&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.target(OuterService.class,&nbsp;"http://127.0.0.1:8085");

### @RequestLine("GET /messages/detail")

指定请求方式跟请求URL

&nbsp;&nbsp;&nbsp;&nbsp;##&nbsp;get请求&nbsp;&nbsp;&nbsp;&nbsp;@RequestLine("GET&nbsp;/messages/detail?msg_ids={msgIds}")&nbsp;&nbsp;&nbsp;&nbsp;##&nbsp;post请求&nbsp;&nbsp;&nbsp;&nbsp;@RequestLine("POST&nbsp;/messages/detail?msg_ids={msgIds}")