状态码
|
对应
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. 模拟输入用户名和口令进行登录
本小节应该说是HTTP客户端编程中最常碰见的问题,很多网站的内容都只是对注册用户可见的,这种情况下就必须要求使用正确的用户名和口令登录成功后,方可浏览到想要的页面。因为HTTP协议是无状态的,也就是连接的有效期只限于当前请求,请求内容结束后连接就关闭了。在这种情况下为了保存用户的登录信息必须使用到Cookie机制。以JSP/Servlet为例,当浏览器请求一个JSP或者是Servlet的页面时,应用服务器会返回一个参数,名为 jsessionid(因不同应用服务器而异),值是一个较长的唯一字符串的Cookie,这个字符串值也就是当前访问该站点的会话标识。浏览器在每访问该站点的其他页面时候都要带上jsessionid这样的Cookie信息,应用服务器根据读取这个会话标识来获取对应的会话信息。
对于需要用户登录的网站,一般在用户登录成功后会将用户资料保存在服务器的会话中,这样当访问到其他的页面时候,应用服务器根据浏览器送上的Cookie中读取当前请求对应的会话标识以获得对应的会话信息,然后就可以判断用户资料是否存在于会话信息中,如果存在则允许访问页面,否则跳转到登录页面中要求用户输入帐号和口令进行登录。这就是一般使用JSP开发网站在处理用户登录的比较通用的方法。
这样一来,对于HTTP的客户端来讲,如果要访问一个受保护的页面时就必须模拟浏览器所做的工作,首先就是请求登录页面,然后读取Cookie值;再次请求登录页面并加入登录页所需的每个参数;最后就是请求最终所需的页面。当然在除第一次请求外其他的请求都需要附带上Cookie信息以便服务器能判断当前请求是否已经通过验证。说了这么多,可是如果你使用 httpclient的话,你甚至连一行代码都无需增加,你只需要先传递登录信息执行登录过程,然后直接访问想要的页面,跟访问一个普通的页面没有任何区别,因为类HttpClient已经帮你做了所有该做的事情了,太棒了!下面的例子实现了这样一个访问的过程。
/*
* 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+
"\n"
+
get.getResponseBodyAsString());
get.releaseConnection();
}
}
8. 多线程模式下使用httpclient
多线程同时访问httpclient,例如同时从一个站点上下载多个文件。对于同一个HttpConnection同一个时间只能有一个线程访问,为了保证多线程工作环境下不产生冲突,httpclient使用了一个多线程连接管理器的类: MultiThreadedHttpConnectionManager,要使用这个类很简单,只需要在构造HttpClient实例的时候传入即可,代码如下:
MultiThreadedHttpConnectionManager
connectionManager
=
new
MultiThreadedHttpConnectionManager();
HttpClient
client
=
new
HttpClient(connectionManager);
以后尽管访问client实例即可。
参考资料:
httpclient首页: http://jakarta.apache.org/commons/httpclient/
关于NTLM是如何工作: http://davenport.sourceforge.net/ntlm.html