Feign：Java HTTP客户端库
Feign使得 Java HTTP 客户端编写更方便。Feign 灵感来源于Retrofit、JAXRS-2.0和WebSocket。Feign最初是为了降低统一绑定Denominator到HTTP API的复杂度，不区分是否支持Restful。Feign旨在通过最少的资源和代码来实现和HTTP API的连接。通过可定制的解码器和错误处理，可以编写任意的HTTP API。
主要特点
- 定制化
- 提供多个接口
- 支持JSON格式的编码和解码
- 支持XML格式的编码和解码
工作机制
Feign通过配置注入一个模板化请求进行工作。只需在发送之前关闭它，参数就可以被直接的运用到模板中。然而这也限制了Feign，只支持文本形式的API，它可以在响应请求方面来简化系统。了解了这一点，这也非常容易进行你的单元测试转换。
基础示例
下面是标准Retrofit的典型用法：
interface GitHub {
@RequestLine("GET /repos/{owner}/{repo}/contributors")
List<Contributor> contributors(@Param("owner") String owner, @Param("repo") String repo);
}
static class Contributor {
String login;
int contributions;
}
public static void main(String... args) {
GitHub github = Feign.builder()
.decoder(new GsonDecoder())
.target(GitHub.class, "https://api.github.com");
// Fetch and print a list of the contributors to this library.
List<Contributor> contributors = github.contributors("netflix", "feign");
for (Contributor contributor : contributors) {
System.out.println(contributor.login + " (" + contributor.contributions + ")");
}
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
interfaceGitHub{
@RequestLine("GET /repos/{owner}/{repo}/contributors")
List<Contributor>contributors(@Param("owner")Stringowner,@Param("repo")Stringrepo);
}
staticclassContributor{
Stringlogin;
intcontributions;
}
publicstaticvoidmain(String...args){
GitHub github=Feign.builder()
.decoder(newGsonDecoder())
.target(GitHub.class,"https://api.github.com");
// Fetch and print a list of the contributors to this library.
List<Contributor>contributors=github.contributors("netflix","feign");
for(Contributor contributor:contributors){
System.out.println(contributor.login+" ("+contributor.contributions+")");
}
}
|
可定制
Feign在一些方面可以定制。举个简单的例子，你可以使用Feign.builder()来构建一个API 接口，包含你自定义的内容。例如：
interface Bank {
@RequestLine("POST /account/{id}")
Account getAccountInfo(@Param("id") String id);
}
...
Bank bank = Feign.builder().decoder(new AccountDecoder()).target(Bank.class, "https://api.examplebank.com");
|
1
2
3
4
5
6
|
interfaceBank{
@RequestLine("POST /account/{id}")
Account getAccountInfo(@Param("id")Stringid);
}
...
Bank bank=Feign.builder().decoder(newAccountDecoder()).target(Bank.class,"https://api.examplebank.com");
|
支持多种接口
Feign可以提供多种API 接口。这些都被定义为Target<T>（默认为 HardCodeTarget<T>）。它允许动态扩展，并且被修饰过的请求会被优先执行。
例如，以下部分可以修饰来自当前身份验证服务的URL和AUTH的每一个请求。
Feign feign = Feign.builder().build();
CloudDNS cloudDNS = feign.target(new CloudIdentityTarget<CloudDNS>(user, apiKey));
|
1
2
|
Feign feign=Feign.builder().build();
CloudDNS cloudDNS=feign.target(newCloudIdentityTarget<CloudDNS>(user,apiKey));
|
示例
Feign被应用于GitHub和维基百科客户端。相似的项目也同样在实践中运用了Feign。尤其是它的示例后台程序。
官方网站：https://github.com/Netflix/feign
开源地址：https://github.com/Netflix/feign
http://hao.jobbole.com/feign/