}
});
}
提取响应头(Accessing Headers)
通常,HTTP标头的工作方式类似于Map<String, String>:每个字段都有一个值或者没有值。但是一些头文件允许多个值,比如Guava的Multimap。例如:HTTP响应提供多个Vary响应头。OkHttp的API让这两种情况都适用。
在写请求头的时候,使用header(name, value)来设置唯一的name、value。如果存在现有值,则在添加新值之前将它们删除。使用addHeader(name, value)来添加一个头,而不必删除已经存在的头。
在读取响应头时,使用header(name)返回最后一次出现的name、value。通常情况这也是唯一的。如果不存在任何值,那么header(name)将会返回null。如果要读取字段所对应的所有值,请使用headers(name),它会返回一个列表。
如果要获取所有的Header,Headers类支持按索引访问。
private final OkHttpClient client = new OkHttpClient();
public void run() throws Exception {
Request request = new Request.Builder()
.url(“https://api.github.com/repos/square/okhttp/issues”)
.header(“User-Agent”, “OkHttp Headers.java”)
.addHeader(“Accept”, “application/json; q=0.5”)
.addHeader(“Accept”, “application/vnd.github.v3+json”)
.build();
try (Response response = client.newCall(request).execute()) {
if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
System.out.println("Server: " + response.header(“Server”));
System.out.println("Date: " + response.header(“Date”));
System.out.println("Vary: " + response.headers(“Vary”));
}
}
Post方式提交String(Posting a String)
使用HTTP POST提交请求到服务。本示例提交了一个Markdown文档到Web服务,并以HTML方式来渲染Markdown。由于整个请求体同时位于内存中,因此请避免使用此API发布较大的文档(大于1MB)。
public static final MediaType MEDIA_TYPE_MARKDOWN
= MediaType.parse(“text/x-markdown; charset=utf-8”);
private final OkHttpClient client = new OkHttpClient();
public void run() throws Exception {
String postBody = “”
-
“Releases\n”
-
“--------\n”
-
“\n”
-
" * 1.0 May 6, 2013\n"
-
" * 1.1 June 15, 2013\n"
-
" * 1.2 August 11, 2013\n";
Request request = new Request.Builder()
.url(“https://api.github.com/markdown/raw”)
.post(RequestBody.create(MEDIA_TYPE_MARKDOWN, postBody))
.build();
try (Response response = client.newCall(request).execute()) {
if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
System.out.println(response.body().string());
}
}
Post方式提交流(Post Streaming)
在这里,我们将请求体以流的方式进行提交。请求体的内容由流写入产生。该示例直接流入Okis的BufferedSink。你的程序可能会使用OutputStream,你可以用BufferedSink.outputStream()来获取。
public static final MediaType MEDIA_TYPE_MARKDOWN
= MediaType.parse(“text/x-markdown; charset=utf-8”);
private final OkHttpClient client = new OkHttpClient();
public void run() throws Exception {
RequestBody requestBody = new RequestBody() {
@Override public MediaType contentType() {
return