在SpringBoot项目开发过程中，可能或多或少的会涉及到第三方接口的调用，并且在SpringBoot框架中也提供了许多的支持第三方接口调用的方式。但是在这些实现技术中，唯独使用OpenFeign来实现对第三方接口的封装调用，大大的简化HTTP客户端的编写。

OpenFeign是一个声明式的HTTP客户端，在开发中可以通过简单的注解就可以完成HTTP请求的定义和调用。这样在必定程度上就减少了手动去处理HTTP请求和响应的工作量，比起其他的实现来看真的是简单了不少。

下面我们就来看看如何在SpringBoot中使用OpenFeign来实现第三方接口的调用。

添加依赖

要想使用OpenFeign的功能，就必须要引入OpenFeign的依赖，如下所示。

<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

同时OpenFeign是Spring Cloud中的组件所以需要确保在项目中添加了Spring Cloud相关的版本依赖。当然也可以单独进行依赖。二者不冲突。如下所示。需要选择合适的Spring Cloud 的版本。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Hoxton.SR10</version> <!-- 版本号根据你的项目情况选择 -->
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

启用Feign

依赖引入完成之后，接下来就是配置Spring Boot的主启动类，要想使用OpenFeign，就需要在SpringBoot的启动类上添加@EnableFeignClients注解以启用Feign，如下所示。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;

@SpringBootApplication
@EnableFeignClients
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

定义Feign客户端接口

接下来就是通过@FeignClient注解来创建一个用于第三方调用的接口，如下所示。

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;

@FeignClient(name = "thirdPartyApi", url = "https://api.example.com")
public interface ThirdPartyApiClient {

    @GetMapping("/endpoint")
    String getEndpointData(@RequestParam("param") String param);
}

@FeignClient这个注解就是用来声明Feign的客户端。在这个注解中通过url指定了第三方API的基本URL。而在下面的方法中通过@GetMapping注解用于指定请求的HTTP方法和路径。就可以实现对第三方接口的调用。

使用Feign客户端

接下来就是在Service层调用注入的第三方接口客户端来进行调用，如下所示。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class ApiService {

    @Autowired
    private ThirdPartyApiClient thirdPartyApiClient;

    public String fetchData(String param) {
        return thirdPartyApiClient.getEndpointData(param);
    }
}

更多配置（可选）

当然除了上面设置的内容之外，还可以创建一些自定义的配置项，例如对于超时时间、重试策略等的配置，而这些配置就需要另外的配置文件，如下所示。

import feign.Logger;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class FeignConfig {

    @Bean
    public Logger.Level feignLoggerLevel() {
        return Logger.Level.FULL;
    }
}

创建完成之后，就可以在@FeignClient注解中引用这个配置，通过这个配置就可以对第三方调用的接口请求进行配置了。

@FeignClient(name = "thirdPartyApi", url = "https://api.example.com", configuration = FeignConfig.class)
public interface ThirdPartyApiClient {
    // 方法定义
}

总结

通过上面的实现步骤，就可以通过OpenFeign来封装和调用第三方接口了，然后就可以在SpringBoot项目中引用相关的配置服务，这个配置服务可以像是调用本地的逻辑实现一样。让HTTP客户端的开发变得更加便捷和高效。