Feign是一个声明式的Web服务客户端，它可以轻松地将Java代码转换为HTTP请求。它的使用非常简单，可以快速地将Java代码中的方法直接映射到HTTP请求，还可以轻松地处理HTTP错误和异常。本文将介绍如何使用Feign Client调用第三方接口。
一、创建Feign Client
在使用Feign Client调用第三方接口之前，需要先创建一个Feign Client。这里我们以调用GitHub API为例，演示如何创建一个Feign Client。首先需要在pom.xml文件中添加以下依赖：
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
接下来创建一个接口，并使用@FeignClient注解标记该接口：
@FeignClient(name = "github-api", url = "https://api.github.com")
public interface GitHubApiClient {
@GetMapping("/repos/{owner}/{repo}")
GitHubRepo getRepository(@PathVariable("owner") String owner, @PathVariable("repo") String repo);
}
在上面的代码中，我们使用@FeignClient注解标记了接口，并指定了服务的名称和服务的URL。接口定义了一个方法getRepositor，在该方法上我们使用@GetMapping注解来指定请求的URL。
二、配置Feign Client
创建了Feign Client之后，还需要对其进行配置。我们可以通过编写一个@Configuration注解的类来实现配置。在配置类中，我们可以设置一些全局的配置，如请求连接超时时间、请求读取超时时间等。
@Configuration
public class FeignConfig {
@Bean
public Retryer retryer() {
return new Retryer.Default();
}
@Bean
public RequestInterceptor requestInterceptor() {
return requestTemplate -> {
requestTemplate.header("User-Agent", "Feign");
requestTemplate.header("Accept", "application/json");
};
}
@Bean
public Decoder decoder() {
return new JacksonDecoder();
}
@Bean
public Encoder encoder() {
return new JacksonEncoder();
}
}
在上面的代码中，我们首先配置了一个Retryer。Retryer是用于定义当请求失败时如何重试的策略。在这里，我们使用了默认的重试策略（重试时间间隔为100ms，最大重试次数为5次）。
接着，我们使用@Bean注解标记了一个RequestInterceptor。RequestInterceptor可以用来对请求进行修改、添加Headers等操作。在这里，我们添加了"User-Agent"和"Accept"两个Header。
然后，我们使用@Bean注解标记了一个Decoder和一个Encoder。Decoder用于将HTTP响应转换为Java对象，而Encoder用于将Java对象转换为HTTP请求。
三、使用Feign Client调用接口
配置好Feign Client之后，就可以使用它来调用第三方接口了。只需要在需要调用接口的地方注入该接口即可。
@RestController
public class GitHubApiController {
@Autowired
private GitHubApiClient gitHubApiClient;
@GetMapping("/repos/{owner}/{repo}")
public GitHubRepo getRepository(@PathVariable("owner") String owner, @PathVariable("repo") String repo) {
return gitHubApiClient.getRepository(owner, repo);
}
}
在上面的代码中，我们使用@Autowired注解将GitHubApiClient注入到控制器中。然后我们可以在控制器的方法中直接使用该客户端调用接口。
四、调用第三方接口的注意事项
在使用Feign Client调用第三方接口时，需要注意以下几点：
1. Feign使用的是默认的JDK Http连接，如果要使用其他连接方式，需要添加相应的依赖。
2. Feign默认情况下会将所有的Http响应代码都视为成功的响应，需要通过Feign的自定义配置来处理Http错误和异常。
3. Feign默认情况下会按照Hystrix的方式进行熔断和降级。如果不需要使用熔断和降级，可以禁用Hystrix。
4. 需要注意接口路径、请求方法、请求参数的准确性。
五、总结
本文主要介绍了如何使用Feign Client调用第三方接口。首先我们创建了一个Feign Client，并配置了一些全局的配置。然后，我们使用该客户端调用了一个接口并获取数据。最后，我们介绍了一些使用Feign Client时需要注意的事项。希望对大家有所帮助。
