`

HttpClient的用法

阅读更多
http://www.diybl.com/course/3_program/java/javashl/20100106/186854.html
HttpClient简介
HTTP 协议可能是现在 Internet 上使用得最多、最重要的协议了,越来越多的 Java 应用程序需要直接通过 HTTP 协议来访问网络资源。
Commons-httpclient项目就是专门设计来简化HTTP客户端与服务器进行各种通讯编程。通过它可以让原来很头疼的事情现在轻松的解决,例如你不再管是HTTP或者HTTPS的通讯方式,告诉它你想使用HTTPS方式,剩下的事情交给 httpclient替你完成。
 
首先,我们必须安装好 HttpClient。
HttpClient 可以在http://jakarta.apache.org/commons/httpclient/downloads.html下载.
 
HttpClient 用到了 Apache Jakarta common 下的子项目 logging,你可以从这个地址http://jakarta.apache.org/site/downloads/downloads_commons-logging.cgi下载到 common logging,从下载后的压缩包中取出 commons-logging.jar 加到 CLASSPATH 中.
 
HttpClient 用到了 Apache Jakarta common 下的子项目 codec,你可以从这个地址http://jakarta.apache.org/site/downloads/downloads_commons-codec.cgi 下载到最新的 common codec,从下载后的压缩包中取出 commons-codec-1.x.jar 加到 CLASSPATH 中
 
1. 读取网页(HTTP/HTTPS)内容
下面是我们给出的一个简单的例子用来访问某个页面

package http.demo; 

import java.io.IOException; 

import org.apache.commons.httpclient.*; 

import org.apache.commons.httpclient.methods.*; 

/** 

* 最简单的HTTP客户端,用来演示通过GET或者POST方式访问某个页面 

* @author Liudong 

*/ 

public class SimpleClient { 

        public static void main(String[] args) throws IOException 

        { 

                HttpClient client = new HttpClient();        

                //设置代理服务器地址和端口         

                //client.getHostConfiguration().setProxy("proxy_host_addr",proxy_port); 

                //使用GET方法,如果服务器需要通过HTTPS连接,那只需要将下面URL中的http换成https 

                HttpMethod method = new GetMethod("http://java.sun.com"); 

                //使用POST方法 

                //HttpMethod method = new PostMethod("http://java.sun.com"); 

                client.executeMethod(method); 

                //打印服务器返回的状态 

                System.out.println(method.getStatusLine()); 

                //打印返回的信息 

                System.out.println(method.getResponseBodyAsString()); 

                //释放连接 

                method.releaseConnection(); 

        } 
} 

在这个例子中首先创建一个HTTP客户端(HttpClient)的实例,然后选择提交的方法是GET或者 POST,最后在HttpClient实例上执行提交的方法,最后从所选择的提交方法中读取服务器反馈回来的结果。这就是使用HttpClient的基本流程。其实用一行代码也就可以搞定整个请求的过程,非常的简单!
 
2. 以GET或者POST方式向网页提交参数

其实前面一个最简单的示例中我们已经介绍了如何使用GET或者POST方式来请求一个页面,本小节与之不同的是多了提交时设定页面所需的参数,我们知道如果是GET的请求方式,那么所有参数都直接放到页面的URL后面用问号与页面地址隔开,每个参数用&隔开,例如:http://java.sun.com?name=liudong&mobile=123456,但是当使用POST方法时就会稍微有一点点麻烦。本小节的例子演示向如何查询手机号码所在的城市,代码如下:

NameValuePair:
简单名称值对节点类NameValuePair. 摘要: 本类位于System. ... NameValuePair。主要用途是在DBConnectionString类中,解析ConnectionString时存储并串联Name/Value对。

package http.demo; 

import java.io.IOException; 

import org.apache.commons.httpclient.*; 

import org.apache.commons.httpclient.methods.*; 

/** 

* 提交参数演示 

* 该程序连接到一个用于查询手机号码所属地的页面 

* 以便查询号码段1330227所在的省份以及城市 

* @author Liudong 

*/ 

public class SimpleHttpClient { 

        public static void main(String[] args) throws IOException 

        { 

                HttpClient client = new HttpClient(); 

                client.getHostConfiguration().setHost("www.imobile.com.cn", 80, "http"); 

                HttpMethod method = getPostMethod();//使用POST方式提交数据 

                client.executeMethod(method); 

             //打印服务器返回的状态 

                System.out.println(method.getStatusLine()); 

                //打印结果页面 

                String response = 

                     new String(method.getResponseBodyAsString().getBytes("8859_1")); 

             //打印返回的信息 

                System.out.println(response); 

                method.releaseConnection(); 

        } 

        /** 

         * 使用GET方式提交数据
;  * @return 

         */ 

        private static HttpMethod getGetMethod(){ 

                return new GetMethod("/simcard.php?simcard=1330227"); 

        } 

        /** 

         * 使用POST方式提交数据 

         * @return 

         */ 

        private static HttpMethod getPostMethod(){ 

                PostMethod post = new PostMethod("/simcard.php"); 

                NameValuePair simcard = new NameValuePair("simcard","1330227"); 

                post.setRequestBody(new NameValuePair[] { simcard}); 

                return post; 

        } 

} 

在上面的例子中页面http://www.imobile.com.cn/simcard.php需要一个参数是simcard,这个参数值为手机号码段,即手机号码的前七位,服务器会返回提交的手机号码对应的省份、城市以及其他详细信息。GET的提交方法只需要在URL后加入参数信息,而POST则需要通过NameValuePair类来设置参数名称和它所对应的值.
 
3. 处理页面重定向

在JSP/Servlet编程中response.sendRedirect方法就是使用HTTP协议中的重定向机制。它与JSP中的<jsp:forward …>的区别在于后者是在服务器中实现页面的跳转,也就是说应用容器加载了所要跳转的页面的内容并返回给客户端;而前者是返回一个状态码,这些状态码的可能值见下表,然后客户端读取需要跳转到的页面的URL并重新加载新的页面。就是这样一个过程,所以我们编程的时候就要通过 HttpMethod.getStatusCode()方法判断返回值是否为下表中的某个值来判断是否需要跳转。如果已经确认需要进行页面跳转了,那么可以通过读取HTTP头中的location属性来获取新的地址。

状态码
对应HttpServletResponse的常量
详细描述

301
SC_MOVED_PERMANENTLY
页面已经永久移到另外一个新地址

302
SC_MOVED_TEMPORARILY
页面暂时移动到另外一个新的地址

303
SC_SEE_OTHER
客户端请求的地址必须通过另外的URL来访问

307
SC_TEMPORARY_REDIRECT
同SC_MOVED_TEMPORARILY


下面的代码片段演示如何处理页面的重定向

client.executeMethod(post); 

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

                post.releaseConnection(); 

                

                //检查是否重定向 

                int statuscode = post.getStatusCode(); 

                if ((statuscode == HttpStatus.SC_MOVED_TEMPORARILY) || 

                        (statuscode == HttpStatus.SC_MOVED_PERMANENTLY) || 

                        (statuscode == HttpStatus.SC_SEE_OTHER) || 

(statuscode == HttpStatus.SC_TEMPORARY_REDIRECT)) { 

//读取新的URL地址 

                        Header header = post.getResponseHeader("location"); 

                        if (header != null) { 

                                String newuri = header.getValue(); 

                                if ((newuri == null) || (newuri.equals(""))) 

                                        newuri = "/"; 

                                GetMethod redirect = new GetMethod(newuri); 

                                client.executeMethod(redirect); 

                                System.out.println("Redirect:"+ redirect.getStatusLine().toString()); 

                                redirect.releaseConnection(); 

                        } else 

                                System.out.println("Invalid redirect"); 

                } 

我们可以自行编写两个JSP页面,其中一个页面用response.sendRedirect方法重定向到另外一个页面用来测试上面的例子。
 
4. 模拟输入用户名和口令进行登录

/* 

* Created on 2003-12-7 by Liudong 

*/ 

package http.demo; 

import org.apache.commons.httpclient.*; 

import org.apache.commons.httpclient.cookie.*; 

import org.apache.commons.httpclient.methods.*; 

/** 

* 用来演示登录表单的示例 

* @author Liudong 

*/ 

public class 

FormLoginDemo { 

        static final String LOGON_SITE = "localhost"; 

        static final int        LOGON_PORT = 8080; 

        

        public static void main(String[] args) throws Exception{ 

                HttpClient client = new HttpClient(); 

                client.getHostConfiguration().setHost(LOGON_SITE, LOGON_PORT); 

             

             //模拟登录页面login.jsp->main.jsp 

                PostMethod post = new PostMethod("/main.jsp"); 

                NameValuePair name = new NameValuePair("name", "ld");         

                NameValuePair pass = new NameValuePair("password", "ld");         

                post.setRequestBody(new NameValuePair[]{name,pass}); 

             int status = client.executeMethod(post); 

                System.out.println(post.getResponseBodyAsString()); 

                post.releaseConnection(); 

             

             //查看cookie信息 

                CookieSpec cookiespec = CookiePolicy.getDefaultSpec(); 

                Cookie[] cookies = cookiespec.match(LOGON_SITE, LOGON_PORT, "/", false, client.getState().getCookies()); 

             if (cookies.length == 0) { 

                     System.out.println("None");        

             } else { 

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

                             System.out.println(cookies[i].toString());        

                     } 

             } 

             //访问所需的页面main2.jsp 

                GetMethod get = new GetMethod("/main2.jsp"); 

                client.executeMethod(get); 

                System.out.println(get.getResponseBodyAsString()); 

                get.releaseConnection(); 

        } 

} 
5. 提交XML格式参数
提交XML格式的参数很简单,仅仅是一个提交时候的ContentType问题,下面的例子演示从文件文件中读取XML信息并提交给服务器的过程,该过程可以用来测试Web服务。

import java.io.File; 

import java.io.FileInputStream; 

import org.apache.commons.httpclient.HttpClient; 

import org.apache.commons.httpclient.methods.EntityEnclosingMethod; 

import org.apache.commons.httpclient.methods.PostMethod; 

/** 

* 用来演示提交XML格式数据的例子 

*/ 

public class PostXMLClient { 

        public static void main(String[] args) throws Exception { 

                File input = new File(“test.xml”); 

                PostMethod post = new PostMethod(“http://localhost:8080/httpclient/xml.jsp”); 

                // 设置请求的内容直接从文件中读取 

                post.setRequestBody(new FileInputStream(input)); 

                

                if (input.length() < Integer.MAX_VALUE) 

                        post.setRequestContentLength(input.length()); 

                else
post.setRequestContentLength(EntityEnclosingMethod.CONTENT_LENGTH_CHUNKED); 

                

                // 指定请求内容的类型 

                post.setRequestHeader("Content-type", "text/xml; charset=GBK"); 

                

                HttpClient httpclient = new HttpClient(); 

                int result = httpclient.executeMethod(post); 

                System.out.println("Response status code: " + result); 

                System.out.println("Response body: "); 

                System.out.println(post.getResponseBodyAsString()); 

                post.releaseConnection(); 

        } 

}

6. 通过HTTP上传文件

httpclient使用了单独的一个HttpMethod子类来处理文件的上传,这个类就是MultipartPostMethod,该类已经封装了文件上传的细节,我们要做的仅仅是告诉它我们要上传文件的全路径即可,下面的代码片段演示如何使用这个类。

MultipartPostMethod filePost = new MultipartPostMethod(targetURL);

filePost.addParameter("fileName", targetFilePath);

HttpClient client = new HttpClient();

//由于要上传的文件可能比较大,因此在此设置最大的连接超时时间

client.getHttpConnectionManager().getParams().setConnectionTimeout(5000);

int status = client.executeMethod(filePost);


上面代码中,targetFilePath即为要上传的文件所在的路径。
7. 访问启用认证的页面


我们经常会碰到这样的页面,当访问它的时候会弹出一个浏览器的对话框要求输入用户名和密码后方可,这种用户认证的方式不同于我们在前面介绍的基于表单的用户身份验证。这是HTTP的认证策略,httpclient支持三种认证方式包括:基本、摘要以及NTLM认证。其中基本认证最简单、通用但也最不安全;摘要认证是在HTTP 1.1中加入的认证方式,而NTLM则是微软公司定义的而不是通用的规范,最新版本的NTLM是比摘要认证还要安全的一种方式。

下面例子是从httpclient的CVS服务器中下载的,它简单演示如何访问一个认证保护的页面:


import org.apache.commons.httpclient.HttpClient; 

import org.apache.commons.httpclient.UsernamePasswordCredentials; 

import org.apache.commons.httpclient.methods.GetMethod; 

public class BasicAuthenticationExample { 

        public BasicAuthenticationExample() { 

        } 

        public static void main(String[] args) throws Exception { 

                HttpClient client = new HttpClient(); 

                client.getState().setCredentials( 

                        "www.verisign.com", 

                        "realm", 

                        new UsernamePasswordCredentials("username", "password") 

                ); 

                GetMethod get = new GetMethod("https://www.verisign.com/products/index.html"); 

                get.setDoAuthentication( true ); 

                int status = client.executeMethod( get ); 

                System.out.println(status+""+ get.getResponseBodyAsString()); 

                get.releaseConnection(); 

        } 

} 

8. 多线程模式下使用httpclient


多线程同时访问httpclient,例如同时从一个站点上下载多个文件。对于同一个HttpConnection 同一个时间只能有一个线程访问,为了保证多线程工作环境下不产生冲突,httpclient使用了一个多线程连接管理器的类: MultiThreadedHttpConnectionManager,要使用这个类很简单,只需要在构造HttpClient实例的时候传入即可,代码如下:

MultiThreadedHttpConnectionManager connectionManager =

     new MultiThreadedHttpConnectionManager();

HttpClient client = new HttpClient(connectionManager);

以后尽管访问client实例即可。
 

httpclient的多线程处理

  使用多线程的主要目的,是为了实现并行的下载。在httpclient运行的过程中,每个http协议的方法,使用一个HttpConnection实例。由于连接是一种有限的资源,每个连接在某一时刻只能供一个线程和方法使用,所以需要确保在需要时正确地分配连接。HttpClient采用了一种类似jdbc连接池的方法来管理连接,这个管理工作由 MultiThreadedHttpConnectionManager完成。

MultiThreadedHttpConnectionManager connectionManager =

new MultiThreadedHttpConnectionManager();

HttpClient client = new HttpClient(connectionManager);

此是,client可以在多个线程中被用来执行多个方法。每次调用 HttpClient.executeMethod() 方法,都会去链接管理器申请一个连接实例,申请成功这个链接实例被签出(checkout),随之在链接使用完后必须归还管理器。管理器支持两个设置: maxConnectionsPerHost 每个主机的最大并行链接数,默认为2

maxTotalConnections 客户端总并行链接最大数,默认为20

  管理器重新利用链接时,采取早归还者先重用的方式(least recently used approach)。

  由于是使用HttpClient的程序而不是HttpClient本身来读取应答包的主体,所以HttpClient无法决定什么时间连接不再使用了,这也就要求在读完应答包的主体后必须手工显式地调用releaseConnection()来释放申请的链接。

MultiThreadedHttpConnectionManager connectionManager = new MultiThreadedHttpConnectionManager();

HttpClient client = new HttpClient(connectionManager);

...

// 在某个线程中。

GetMethod get = new GetMethod("http://jakarta.apache.org/");

try {

client.executeMethod(get);

// print response to stdout

System.out.println(get.getRsponseBodyAsStream());
} finally {

// be sure the connection is released back to the connection

// manager

get.releaseConnection();


}

对每一个HttpClient.executeMethod须有一个method.releaseConnection()与之匹配
分享到:
评论

相关推荐

    httpclient用法,发送get和post请求,设置header

    httpclient的用法,发送get请求和post请求,设置header

    HttpClient用法

    在这个主题中,我们将深入探讨HttpClient的用法,特别是如何获取客户端信息并发送回服务器。 首先,让我们了解如何初始化HttpClient实例。HttpClient的使用通常始于创建一个HttpClient对象。你可以使用`HttpClients...

    HttpClient用法,实例

    HttpClient用法,实例 HttpClient用法,实例 HttpClient用法,实例 HttpClient用法,实例

    HTTPClient用法

    这篇博客文章“HTTPClient用法”可能是关于如何使用Apache HttpClient库进行HTTP通信的教程,虽然具体内容没有给出,但我们可以根据常见的HTTPClient使用场景和方法来探讨相关知识点。 1. **Apache HttpClient简介*...

    HttpClient各种使用方法

    NULL 博文链接:https://wenkaixuan.iteye.com/blog/2109590

    如何在WPF应用程序中通过HttpClient调用Web API

    下面的代码示例展示了如何使用HttpClient的GetAsync方法发起一个异步的GET请求: ```csharp private async void GetProducts() { using (var client = new HttpClient()) { try { var response = await client...

    httpClient4.1入门教程.

    内容包括了基本的 HttpClient 使用方法以及 SSL 访问的配置步骤。随着 HttpClient 版本的更新和功能的扩展,教程也将不断更新以涵盖更多高级特性和最佳实践。 总结:HttpClient 是 Java 开发者进行 HTTP 请求的重要...

    爬虫:httpclient+jsoup

    1. HttpClient使用方法: - 创建HttpClient实例,例如`CloseableHttpClient httpClient = HttpClients.createDefault();` - 构建HttpGet或HttpPost对象,指定目标URL。 - 发送请求并获取HttpResponse,如`...

    C# httpclient demo

    在描述中提到,这个示例可能是在微软开发者网络(MSDN)上找到的,对于寻找关于HttpClient用法的人来说可能是有价值的。HttpClient类通常用于从Web服务器获取数据,如发送GET和POST请求,这在开发移动应用(如WP8,...

    httpclient-4.5.6-API文档-中文版.zip

    赠送jar包:httpclient-4.5.6.jar;...使用方法:解压翻译后的API文档,用浏览器打开“index.html”文件,即可纵览文档内容。 人性化翻译,文档中的代码和结构保持不变,注释和说明精准翻译,请放心使用。

    【ASP.NET编程知识】.NET CORE HttpClient的使用方法.docx

    .NET CORE HttpClient 的使用方法 .NET CORE 中的 HttpClient 是一个非常重要的组件,它提供了一个强大且灵活的方式来发送 HTTP 请求。然而,在使用 HttpClient 时,我们需要注意一些重要的配置和使用方法,以避免...

    HttpClient使用教程 事例

    首先,HttpClient库提供了一套完整的API,允许开发者构建复杂的HTTP请求,包括GET、POST、PUT等HTTP方法,同时支持连接管理、重试策略、超时设置等高级特性。在Java项目中,HttpClient通常被用来替代内置的`java.net...

    Httpclient使用jar包三合一,基本使用方法

    简单使用方法: public static void main(String[] args) { // String str1 = &quot;http://dev.d-smart.cn/Login&quot;; // http协议路径 String str1 = &quot;&quot;; HttpClient httpClient = new HttpClient...

    httpclient使用教程

    ### httpclient使用教程 #### HttpClient概述与重要性 ...为了解决这一问题,Apache ...此教程不仅介绍了HttpClient的基本使用方法,还强调了资源管理和异常处理的重要性,是Java开发者处理HTTP通信不可或缺的技能之一。

    使用HttpClient调试android接口-通用方法

    在这个场景下,"使用HttpClient调试android接口-通用方法"的标题表明我们将讨论如何使用HttpClient来调试Android应用中的API接口。下面,我们将深入探讨HttpClient的基础知识、调试技巧以及如何封装通用方法。 1. *...

    httpclient.jar包下载

    HttpClient库允许开发者执行各种HTTP方法(如GET、POST、PUT等),处理重定向、认证、cookie管理等复杂网络交互,同时提供了线程安全和高效的连接管理机制。这个库在处理Web服务API、爬虫程序或任何需要与HTTP服务器...

    httpclient httpclient.jar

    在本文中,我们将深入探讨HttpClient的核心概念、使用方法以及如何通过`httpclient.jar`进行实战应用。 首先,HttpClient的主要组件包括: 1. **HttpClient实例**:这是整个HTTP通信的核心,负责管理连接、请求和...

Global site tag (gtag.js) - Google Analytics