使用Feign发送HTTP请求

2020 年 11 月 23 日
笔记
JAVA, spring

使用Feign发送HTTP请求

在往常的 HTTP 调用中，一直都是使用的官方提供的 RestTemplate 来进行远程调用，该调用方式将组装代码冗余到正常业务代码中，不够优雅，因此在接触到 Feign 后，考虑使其作为一个 HTTP 发送基础，来进行远程调用。

下面就让我们来看一下，其是如何使用的。

引入依赖

首先，我们需要将 Feign 的基础依赖引入项目，因为我们只使用 Feign 的 remote 功能，因此，只引入基础依赖。

此外在项目中，我们还自定义了了 JSON 转换和 log 设置，因此还需要引入这些的第三方依赖，如下所示。

      <!-- feign -->
        <dependency>
            <groupId>io.github.openfeign</groupId>
            <artifactId>feign-core</artifactId>
            <version>10.10.1</version>
        </dependency>
        <dependency>
            <groupId>io.github.openfeign</groupId>
            <artifactId>feign-gson</artifactId>
            <version>10.10.1</version>
        </dependency>
        <dependency>
            <groupId>io.github.openfeign</groupId>
            <artifactId>feign-slf4j</artifactId>
            <version>10.10.1</version>
        </dependency>

发送路径和方法设置

然后，因为 Feign 是一种申明式的调用，因此我们需要配置发送的接口路径和发送接口定义，看下面的例子。

    @RequestLine("GET /user/getone?arkOrgId={arkOrgId}&userId={userId}")
    JSONObject getOneStaff(@Param("arkOrgId") String arkOrgId,@Param("userId") String userId);

    @RequestLine("POST /user/add")
    @Headers("Content-Type: application/json")
    @Body("{body}")
    JSONObject saveStaff(@Param("body") SaveEmployeeDTO saveEmployeeDTO);

在代码实例中，我们定义了两种发送的实例，一种是 GET 请求，一种是 POST 请求，下面，我们分别来看一下其中的代码的作用是什么。

@RequestLine：定义发送方式和发送接口定义，其中用 GET 和 POST 来定义发送方式，然后空格后，写上 servelt path（context path 和域名或ip端口号在其他地方配置）；
{}：用来作为占位符，动态填充需要的参数；
@Param：用来匹配 URI 中的占位符；
@Headers(“Content-Type: application/json”)：构建请求表头，在 POST 请求中，需要声明该请求的发送格式为 json；
@Body：POST 请求，需要标注请求体；
JSONObject：在本实例中，采用是一个通用的 json 对象来接收，方便统一，在自己的代码中，也可以定义一个接受实体类来接受，作用是一样的。

POST 请求，需要在实体中重写 toString() 方法，使其在发送时调用该方法后，是一个 JSON 字符串，详细见后文 Tips 中写的。

定义发送客户端

@Configuration
public class FeignConfig {
    public static final String DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";
    @Value("${staff.base.url}")
    private String staffBaseUrl;
    @Bean
    public StaffFeignService staffFeignService() {
        GsonBuilder builder = new GsonBuilder();
        builder.setDateFormat(DATE_TIME_FORMAT);
        return Feign.builder()
                .retryer(closeFeignRetry())
                .decoder(new GsonDecoder(builder.create()))
                .encoder(new GsonEncoder())
                .logger(new Slf4jLogger())
                .logLevel(Logger.Level.FULL)
                .target(StaffFeignService.class, staffBaseUrl);
    }
    /**
     * 关闭feign的失败重试功能
     */
    @Bean
    public Retryer closeFeignRetry() {
        return Retryer.NEVER_RETRY;
    }

    @Bean
    public Request.Options options() {
        return new Request.Options(15000, 30000);
    }
}

紧接着，我们来定义发送客户端。

首先，我们采用 @Value 来动态添加路由，这样，就可以根据在配置文件中的属性来添加 context path，从而做到可拓展。

然后，feign 的很多配置都是可以根据自身项目需要在 DIY 的，因此在这里，我们配置了编解码采用 GSON 的编解码器，日志级别设置全打印。通过该设置来生成一个 Feign 客户端。

Feign 官方文档，在官方文档中，有详细的配置说明，根据自身需要使用，即可。

使用

@Autowired
StaffFeignService staffFeignService;

// get 请求
JSONObject saveSingleQrCode = staffFeignService.saveSingleQrCode(userId);

// post 请求
SaveMultiQrCodesDTO saveMultiQrCodesDTO = new SaveMultiQrCodesDTO();;
JSONObject saveMultiQrCodes = staffFeignService.saveMultiQrCodes(saveMultiQrCodesDTO);

通过该方式，即可发送对应请求。

Tips

记录一些在使用中的重点，需要注意。

重写 toString() 方法

在发送 JSON 时，需要重写 toString() 方法，否则会导致接受方，无法用 json 进行解析。

    @Override
    public String toString() {
        return JSON.toJSONString(this);
    }

异步客户端

有时候，我们使用异步发送，从而不影响我们的主体业务，Feign 也支持该种配置。

    @Bean
    public IHermesFeignService hermesFeignService() {
        GsonBuilder builder = new GsonBuilder();
        builder.setDateFormat(DATE_TIME_FORMAT);
        return AsyncFeign.asyncBuilder()
                .decoder(new GsonDecoder(builder.create()))
                .encoder(new GsonEncoder(builder.create()))
                .logger(new Slf4jLogger())
                .logLevel(Logger.Level.FULL)
                .target(IHermesFeignService.class, hermesBaseUrl);
    }

重点，就是在构建 Feign 时，采用 AsyncFeign.asyncBuilder() 来进行构建。

公众号截图

文章在公众号「iceWang」第一手更新，有兴趣的朋友可以关注公众号，第一时间看到笔者分享的各项知识点，谢谢！笔芯！

Tags: JAVA spring