HttpClient入门

最新推荐文章于 2021-02-24 14:49:25 发布
最新推荐文章于 2021-02-24 14:49:25 发布
阅读量481 收藏
点赞数
分类专栏： Java开发

1.1      执行请求

HttpClient的最重要的功能是执行HTTP方法。一个HTTP方法的执行涉及到一个或多个HTTP请求或HTTP响应的交流，HttpClient通常是在内部处理的。用户将提供一个执行请求对象，HttpClient发送请求到目标服务器返回一个相应的响应对象，如果执行失败则抛出一个异常。所以，HttpClient API的主要切入点是HttpClient的接口，它定义了上述约定。

下面是一个请求执行过程中的最简单形式的例子：

HttpClient httpclient = new DefaultHttpClient();

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

    InputStream instream = entity.getContent();

    int l;

    byte[] tmp = new byte[2048];

    while ((l = instream.read(tmp)) != -1) {

    }

}

1.1.1        HTTP请求

所有的HTTP请求包含一个由请求行组成的一个方法名，一个请求的URI和一个HTTP协议的版本。

HttpClient的支持在HTTP/1.1规范中定义的所有的HTTP方法：GET, HEAD, POST, PUT, DELETE, TRACE 和 OPTIONS。每有一个方法都有一个对应的类：HttpGet，HttpHead，HttpPost，HttpPut，HttpDelete，HttpTrace和HttpOptions。所有的这些类均实现了HttpUriRequest接口，故可以作为execute的执行参数使用。请求URI是能够应用请求的统一资源标识符。 HTTP请求的URI包含一个协议计划protocol scheme，主机名host name,，可选的端口optional port，资源的路径resource path，可选的查询optional query和可选的片段optional fragment。

 

HttpGet httpget = new HttpGet(

     "http://www.google.com/search?hl=en&q=httpclient&btnG=Google+Search&aq=f&oq=");

HttpClient提供了一系列实用的方法来简化创建和修改请求URI。

URI可以组装编程：

URI uri = URIUtils.createURI("http", "www.google.com", -1, "/search",

    "q=httpclient&btnG=Google+Search&aq=f&oq=", null);

HttpGet httpget = new HttpGet(uri);

System.out.println(httpget.getURI());

输出>

http://www.google.com/search?q=httpclient&btnG=Google+Search&aq=f&oq=

查询字符串也可以通过添加参数列表来生成:

List qparams = new ArrayList();

qparams.add(new BasicNameValuePair("q", "httpclient"));

qparams.add(new BasicNameValuePair("btnG", "Google Search"));

qparams.add(new BasicNameValuePair("aq", "f"));

qparams.add(new BasicNameValuePair("oq", null));

URI uri = URIUtils.createURI("http", "www.google.com", -1, "/search",

    URLEncodedUtils.format(qparams, "UTF-8"), null);

HttpGet httpget = new HttpGet(uri);

System.out.println(httpget.getURI());

输出>

http://www.google.com/search?q=httpclient&btnG=Google+Search&aq=f&oq=

1.1.2        HTTP响应

HTTP响应是由服务器收到和解释一个请求消息后返回给客户端的消息。该消息的第一行包含遵循的协议版本,他由一个数字状态代码及其相关的文本来表示。

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,

HttpStatus.SC_OK, "OK");

 

System.out.println(response.getProtocolVersion());

System.out.println(response.getStatusLine().getStatusCode());

System.out.println(response.getStatusLine().getReasonPhrase());

System.out.println(response.getStatusLine().toString());

输出>

HTTP/1.1

200

OK

HTTP/1.1 200 OK

1.1.3        Headers处理

一个HTTP消息可以包含一系列headers参数描述信息，例如内容长度，内容类型等。 HttpClient的提供方法来检索，添加，删除和枚举headers。

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,
    HttpStatus.SC_OK, "OK");
response.addHeader("Set-Cookie", "c1=a; path=/; domain=localhost");
response.addHeader("Set-Cookie","c2=b; path="/", c3=c; domain="localhost"");
Header h1 = response.getFirstHeader("Set-Cookie");
System.out.println(h1);
Header h2 = response.getLastHeader("Set-Cookie");
System.out.println(h2);
Header[] hs = response.getHeaders("Set-Cookie");
System.out.println(hs.length);

输出>

Set-Cookie: c1=a; path=/; domain=localhost

Set-Cookie: c2=b; path="/", c3=c; domain="localhost"

2

最有效获取所有的给定类型的headers方式是使用HeaderIterator接口。

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,

    HttpStatus.SC_OK, "OK");

response.addHeader("Set-Cookie",

    "c1=a; path=/; domain=localhost");

response.addHeader("Set-Cookie",

    "c2=b; path="/", c3=c; domain="localhost"");

HeaderIterator it = response.headerIterator("Set-Cookie");

while (it.hasNext()) {

    System.out.println(it.next());

}

输出>

Set-Cookie: c1=a; path=/; domain=localhost

Set-Cookie: c2=b; path="/", c3=c; domain="localhost"

它还提供了方便的方法来解析HTTP消息的单个header元素

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,

    HttpStatus.SC_OK, "OK");

response.addHeader("Set-Cookie",

    "c1=a; path=/; domain=localhost");

response.addHeader("Set-Cookie",

    "c2=b; path="/", c3=c; domain="localhost"");

 

HeaderElementIterator it = new BasicHeaderElementIterator(

    response.headerIterator("Set-Cookie"));

 

while (it.hasNext()) {

    HeaderElement elem = it.nextElement();

    System.out.println(elem.getName() + " = " + elem.getValue());

    NameValuePair[] params = elem.getParameters();

    for (int i = 0; i < params.length; i++) {

        System.out.println(" " + params[i]);

    }

输出>

c1 = a

path=/

domain=localhost

c2 = b

path=/

c3 = c

domain=localhost

1.1.4   HTTP 实体

HTTP消息的可以进行内容实体和请求或响应关联。可以在一些要求和一些回应中找到实体，因为它们是可选的。实体内附与请求之中。 HTTP规范定义了两个实体内附方法：POST和PUT。响应通常将会附上一个内容实体。但是响应HEAD方法和 204 No Content, 304 Not Modified, 205 Reset Content responses 除外。

HttpClient的区分三种不同实体的地方在于内容来源于：

streamed流媒体：内容是从收到的流，或在运行中产生的。特别是包括被从HTTP响应收到的实体。流媒体的实体一般不可重复。

self-contained独立的：内容是在内存或以从一个连接或其他实体的独立获得的。独立的的实体，一般可重复的。这种类型的实体将主要用于内附在HTTP请求中。

wrapping包装：实体内容是从另一个实体获得。

当得到一个HTTP响应流的内容的时候，这种区分对于连接管理是很重要的。对于请求实体，通过应用程序来创建和只通过使用的HttpClient发送，流和自载之间差别很小。在这种情况下，建议考虑非重复的流实体，以及那些重复的自载实体。

1.1.4.1             重复实体

一个实体可以是可重复的，这意味着它的内容可以被读取一次以上。唯一有可能是的独立的实体（如ByteArrayEntity或StringEntity（））

1.1.4.2             使用HTTP实体

由于一个实体能够表示二进制和字符的内容，它可以提供编码的支持（支持文字、IE和字符内容）。

这个实体在执行封闭内容的请求的时候或者在请求成功和响应返回成功的时候被创建。

若要读取从实体内容，一可以通过检索HttpEntity＃getContent（）方法，它返回一个java.io.InputStream，或一个可以提供一个输出流的HttpEntity＃writeTo（OutputStream中）方法的输入流，这将返回已被写入给定的流的所有内容。

当通过传入的消息收到实体，方法HttpEntity＃getContentType（）和HttpEntity＃getContentLength（）方法可用于阅读通用元数据metadata，如Content-Type，Content-Length headers（如果可用）。由于Content-Type header可以包含一个像text/plain或者text/html的文本mime-types的character encoding，HttpEntity＃getContentEncoding（）方法用来读取此信息。如果headers是不可用，返回的长度是-1，content type并为NUL。如果Content – Type header可用，将返回一个header对象。

当创建了一个即将卸任的消息实体，该meta data必须提供由该实体的创造者。

StringEntity myEntity = new StringEntity("important message",

    "UTF-8");

 

System.out.println(myEntity.getContentType());

System.out.println(myEntity.getContentLength());

System.out.println(EntityUtils.getContentCharSet(myEntity));

System.out.println(EntityUtils.toString(myEntity));

System.out.println(EntityUtils.toByteArray(myEntity).length);

stdout >

Content-Type: text/plain; charset=UTF-8

17

UTF-8

important message

17

1.1.5   确保资源释放

当响应实体完成之后，重要的是要确保所有的实体内容已被完全消耗，使该连接可以安全地返回到连接池，重新由连接管理器提供给后续请求使用。最简单的方法是调用HttpEntity＃consumeContent（）方法来消耗流上的所有可用的内容。当检测到内容已经达到流末尾的时候，HttpClient会自动释放底层连接返回到连接管理器。HttpEntity＃consumeContent（）方法多次调用也是安全的。

当只有小部分实体响应内容需要被检索和消费。其余内容，使用可重复的连接性能损失太大，可以简单地调用HttpUriRequest＃abort()方法来终止请求。

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

    InputStream instream = entity.getContent();

    int byteOne = instream.read();

    int byteTwo = instream.read();

    // Do not need the rest

    httpget.abort();

}

该连接将不可重用，但是所有资源会被释放。

1.1.6   获取实体内容

获取实体内容推荐的方法是通过使用HttpEntity＃getContent（）或HttpEntity＃writeTo（OutputStream中）方法。 HttpClient的还配备了EntityUtils类，它暴露了一些静态方法，以更轻松地阅读一个实体的内容或资料。使用这个类的方法和直接使用java.io.InputStream方法不同的是，他可以检索字符串中的全部内容机构/字节数组。强烈建议不要使用EntityUtils，除非响应实体来自一个可信赖的HTTP服务器和已知的有限长度。

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

    long len = entity.getContentLength();

    if (len != -1 && len < 2048) {

        System.out.println(EntityUtils.toString(entity));

    } else {

        // Stream content out

    }

}

在某些情况下，实体内容可能需要能够读被多次读取。在这种情况下实体的内容必须以某种方式被缓冲在内存或磁盘上。最简单的方法是通过BufferedHttpEntity类来封装原始实体。原始实体内容可以从内存中的缓冲区来读取。其他方式封装实体都包含原始实体。

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

    entity = new BufferedHttpEntity(entity);

}

1.1.7   生产实体内容

HttpClient提供了一些类可以从HTTP连接内容中获得效地流。这些类的实例可以与实体内附如POST和PUT请求，以便为即将离任的HTTP请求附上实体内容。 HttpClient的为最常见的数据容器几类，如串，字节数组输入流和文件：StringEntity，ByteArrayEntity，InputStreamEntity和FileEntity。

File file = new File("somefile.txt");

FileEntity entity = new FileEntity(file, "text/plain; charset="UTF-8"");

 

HttpPost httppost = new HttpPost("http://localhost/action.do");

httppost.setEntity(entity);

请注意InputStreamEntity是不可重复的，因为它只能从底层数据流中读取一次。一般来说，建议实现自定义HttpEntity类是自载的，而不是使用通用InputStreamEntity。 FileEntity可以是一个很好的起点。

1.1.7.1             动态内容实体

通常的HTTP实体需要在执行上下文的时候动态生成的。 HttpClient的提供使用EntityTemplate实体类和ContentProducer接口支持动态实体。内容制作是通过写需求的内容到一个输出流，每次请求的时候都会产生。因此，通过EntityTemplate创建实体通常是独立的，重复性好。

ContentProducer cp = new ContentProducer() {

    public void writeTo(OutputStream outstream) throws IOException {

        Writer writer = new OutputStreamWriter(outstream, "UTF-8");

        writer.write("");

        writer.write("  ");

        writer.write("    important stuff");

        writer.write("  ");

        writer.write("");

        writer.flush();

    }

};

HttpEntity entity = new EntityTemplate(cp);

HttpPost httppost = new HttpPost("http://localhost/handler.do");

httppost.setEntity(entity);

1.1.7.2             HTML forms

许多应用程序经常需要模拟一个HTML表单提交的过程，例如，以登录到Web应用程序或提交的输入数据。 HttpClient的实体类UrlEncodedFormEntity可以帮助实现这一步。

List formparams = new ArrayList();

formparams.add(new BasicNameValuePair("param1", "value1"));

formparams.add(new BasicNameValuePair("param2", "value2"));

UrlEncodedFormEntity entity = new UrlEncodedFormEntity(formparams, "UTF-8");

HttpPost httppost = new HttpPost("http://localhost/handler.do");

httppost.setEntity(entity);

这UrlEncodedFormEntity实例将使用 URL编码的编码参数，并出示下列内容：

param1=value1&param2=value2

1.1.7.3             内容组块

一般来说，建议当HTTP消息的发送的时候让HttpClient的选择最合适的传输编码。这是可能的，但是，HttpClient首选通过设置HttpEntity＃setChunked（）为true设置编码。请注意的HttpClient将使用这个标志作为提示。当使用HTTP协议的版本不支持时候该值将被忽略时，如HTTP/1.0的块编码。

StringEntity entity = new StringEntity("important message",

    "text/plain; charset="UTF-8"");

entity.setChunked(true);

HttpPost httppost = new HttpPost("http://localhost/acrtion.do");

httppost.setEntity(entity);

1.1.8   响应处理程序

最简单和最方便的处理响应方式是通过使用ResponseHandler接口。这种方法完全免除了用户去担心连接管理。无论执行请求是否成功或导致异常，HttpClient的ResponseHandler会确保自动释放该连接回连接管理器。

HttpClient httpclient = new DefaultHttpClient();

HttpGet httpget = new HttpGet("http://localhost/");

 

ResponseHandler handler = new ResponseHandler() {

    public byte[] handleResponse(

            HttpResponse response) throws ClientProtocolException, IOException {

        HttpEntity entity = response.getEntity();

        if (entity != null) {

            return EntityUtils.toByteArray(entity);

        } else {

            return null;

        }

    }

};

 

byte[] response = httpclient.execute(httpget, handler);


技术博客汇总888
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
httpClient入门
03-22
NULL 博文链接：https://ait.iteye.com/blog/981514
HttpPost链接解析网络服务器xml（response.getStatusLine().getStatusCode()==200链接成功）
热门推荐
heng615975867的专栏
09-27 2万+
HttpPost链接解析xml，response.getStatusLine().getStatusCode()==200链接成功，==500失败。 public class XmlPullParserBase { private static final String TAG = "XmlPullParserBase"; public static XmlPullParse
Java http响应状态码_如何获得HttpClient返回状态码和响应正文？
weixin_42393261的博客
02-24 1551
小编典典不要向提供处理程序execute。获取HttpResponse对象，使用处理程序获取主体并直接从中获取状态代码try (CloseableHttpClient httpClient = HttpClients.createDefault()) {final HttpGet httpGet = new HttpGet(GET_URL);try (CloseableHttpResponse r...
Httpclient-My坑
AnxiangLemon的博客
06-05 573
学习了一下Httpclient，用SmartQQ练下手 坑一：Referer HTTP Referer是header的一部分，当浏览器向web服务器发送请求的时候，一般会带上Referer，告诉服务器我是从哪个页面链接过来的，服务器基此可以获得一些信息用于处理。 不管三七二十一 ：headers.put("Referer", url);  没错 坑二：Post参数装填 参数为 name=...
Android学习历程12-Android 网络请求
anye_anye的博客
01-23 1672
简单的介绍一下Android常用的联网方式、判断网络连接状态以及volley框架、AsyncHttpClient框架的使用
HttpClient入门教程
最新发布
01-23
HttpClient入门教程 HttpClient 是 apache 组织下面的一个用于处理 HTTP 请求和响应的开源工具。它不是一个浏览器，也不处理客户端缓存等浏览器的功能。它只是一个类库！它在 JDK 的基本类库基础上做了更好的封装！
java abort_java - HttpGet.abort（）/ HttpPost.abort（）并不总是立即中止 - 堆栈内存溢出...
weixin_39731782的博客
02-23 693
我正在使用Apache HttpComponents 4.2.1而我无法让HttpGet.abort()和HttpPost.abort()立即中止。 它大部分时间都可以工作，但偶尔连接会阻塞，直到超时。 我注意到这只发生在我明确设置超时值时。这是我的测试代码：public static void main(String[] args) throws Exception {for (int i ...
HttpGet.abort（）/ HttpPost.abort（）并不总是立即中止
香槟的博客
11-06 4575
地址：https://stackoverflow.com/questions/12014673/httpget-abort-httppost-abort-doesnt-always-abort-immediately I’m using Apache HttpComponents 4.2.1 and I’m having trouble getting HttpGet.abort() and H...
HttpClient 的 abort（终止）程序示例
维京群岛
12-29 2万+
/* * ==================================================================== * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file
HttpClient使用时遇到几个隐蔽小坑分析
luozhuwang的专栏
09-24 5877
问题场景一： 1.在用get方法去获取数据时，一直都是好好的运行状态，突然遇到“Attempted read from closed stream” 错误。 相关方法用到的代码贴上： HttpGet httpGet = new HttpGet(url); httpClient = new DefaultHttpClient(); httpResponse
Android Post Get 示例
firewings_r的专栏
03-12 5464
package alex.reader.ebook.bam;import java.io.IOException;import java.util.ArrayList;import java.util.HashMap;import java.util.Iterator;import java.util.List;import java.util.Map;impo
关于HttpResponse返回结果解析
weixin_34296641的博客
01-02 1万+
2019独角兽企业重金招聘Python工程师标准>>> ...
Android开发中访问服务器常用到的response.getStatusCode()的值各代表什么
huanongjingchao的专栏
05-30 8867
response.getStatusCode()==200:代表请求成功  口200请求成功  口303重定向  口400请求错误  口401未授权  口403禁止访问  口404文件未找到  口500服务器错误
response.getStatusCode() - 页面请求状态码
Poirot酱的博客
09-13 7550
页面请求的状态值，分别有：200请求成功、303重定向、400请求错误、401未授权、403禁止访问、404文件未找到、500服务器错误
HTTP的abort状态
weixin_30740581的博客
08-13 497
http请求的abort状态指的是：客户端一厢情愿的丢弃了服务器端的返回，并不是服务器丢弃处理请求。比如：<iframe src=http://www.googl.e.com></iframe> <script> setTimeout('window.top.location="http://www.baidu.com"',3...
HttpClient
10-09
HttpClient最初是Apache的一个开源项目，现在已经成为了Apache HttpComponents的一部分。HttpClient的主要特点包括： 1. 简单易用：HttpClient提供了简洁、易用的API，使得我们可以轻松地发送HTTP请求。 2. 可扩展...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值