还在用HttpUtil？SpringBoot 3.0全新HTTP客户端工具来了，用起来够优雅~

我们平时开发项目的时候，经常会需要远程调用下其他服务提供的接口，于是我们会使用一些HTTP工具类比如Hutool提供的HttpUtil。前不久SpringBoot 3.0发布了，出了一个Http Interface的新特性，它允许我们使用声明式服务调用的方式来调用远程接口，今天我们就来聊聊它的使用！

SpringBoot实战电商项目mall（50k+star）地址：https://github.com/macrozheng/mall

简介

Http Interface让你可以像定义Java接口那样定义HTTP服务，而且用法和你平时写Controller中方法完全一致。它会为这些HTTP服务接口自动生成代理实现类，底层是基于Webflux的WebClient实现的。

使用声明式服务调用确实够优雅，下面是一段使用Http Interface声明的Http服务代码。

使用

在SpringBoot 3.0中使用Http Interface是非常简单的，下面我们就来体验下。

依赖集成

• 首先在项目的pom.xml中定义好SpringBoot的版本为3.0.0；

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.0.0</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

• 由于SpringBoot最低要求为Java 17，我们需要先安装好JDK 17，安装完成后配置项目的SDK版本为Java 17，JDK下载地址：https://www.oracle.com/cn/java/technologies/downloads/

• 由于Http Interface需要依赖webflux来实现，我们还需添加它的依赖。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>

基本使用

下面以调用mall-tiny-swagger中的接口为例，我们来体验下Http Interface的基本使用。

• 首先我们准备一个服务来方便远程调用，使用的是之前的mall-tiny-swagger这个Demo，打开Swagger看下，里面有一个登录接口和需要登录认证的商品品牌CRUD接口，项目地址：https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-swagger

• 先在application.yml中配置好mall-tiny-swagger的服务地址；

remote:
  baseUrl: http://localhost:8088/

• 再通过@HttpExchange声明一个Http服务，使用@PostExchange注解表示进行POST请求；

/**
 * @auther macrozheng
 * @description 定义Http接口，用于调用远程的UmsAdmin服务
 * @date 2022/1/19
 * @github https://github.com/macrozheng
 */
@HttpExchange
public interface UmsAdminApi {
   
   

    @PostExchange("admin/login")
    CommonResult<LoginInfo> login(@RequestParam("username") String username, @RequestParam("password") String password);
}

• 再创建一个远程调用品牌服务的接口，参数注解使用我们平时写Controller方法用的那些即可；

/**
 * @auther macrozheng
 * @description 定义Http接口，用于调用远程的PmsBrand服务
 * @date 2022/1/19
 * @github https://github.com/macrozheng
 */
@HttpExchange
public interface PmsBrandApi {
   
   
    @GetExchange("brand/list")
    CommonResult<CommonPage<