Spring Boot中使用OpenFeign实现第三方接口的封装调用?
在SpringBoot项目开发过程中，可能或多或少的会涉及到第三方接口的调用，并且在SpringBoot框架中也提供了很多的支持第三方接口调用的方式。但是在这些实现技术中，唯独使用OpenFeign来实现对第三方接口的封装调用，大大的简化HTTP客户端的编写。
OpenFeign是一个声明式的HTTP客户端，在开发中可以通过简单的注解就可以完成HTTP请求的定义和调用。这样在一定程度上就减少了手动去处理HTTP请求和响应的工作量，比起其他的实现来看真的是简单了不少。
下面我们就来看看如何在SpringBoot中使用OpenFeign来实现第三方接口的调用。
添加依赖
要想使用OpenFeign的功能，就必须要引入OpenFeign的依赖，如下所示。
org.springframework.cloud
spring-cloud-starter-openfeign
同时OpenFeign是Spring Cloud中的组件所以需要确保在项目中添加了Spring Cloud相关的版本依赖。当然也可以单独进行依赖。二者不冲突。如下所示。需要选择合适的Spring Cloud 的版本。
org.springframework.cloud
spring-cloud-dependencies
Hoxton.SR10
pom
import
启用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客户端的开发变得更加便捷和高效。