HttpClient异常处理手册

HttpClient异常处理手册

开源中国

发表于 2014-08-26 19:44:06

异常处理 

HttpClient的使用者在执行HTPP方法（GET,PUT,DELETE等），可能遇到会两种主要类型的异常：

• 传输异常
• 协议异常

并非全部的异常都会传播给HttpClient的用户。HttpClient内部使用的异常在下文中将会标记为内部使用

• 传输异常
• 协议异常
• HTTP传输安全
• 自动异常恢复
• 自定义异常处理

传输异常 

传输异常都是诸如不可靠的链接到输入/输出失败或者未能在给与的时间内执行完HTPP方法（套接字超时）。通常来讲，传输异常是非致命的错误，经过屡次执行方法可以恢复。在非幕等方法中恢复特别须要注意（详细信息请参考HTTP传输安全）。 

 

java.io.IOException 

HttpCinet通常的传输异常能够用标准JAVA中 java.io.IOException或者其子类java.net.SocketException，java.net.InterruptedIOException来表示。 

为了规划化输入/输出异常类，HttpClient定义多种自定义传输异经常使用来传递HttpClient特定的信息。 

org.apache.commons.httpclient.NoHttpResponseException
java.io.IOException
+- org.apache.commons.httpclient.NoHttpResponseException 

 

在某些状况下，因为服务器负载过大，服务器能接受到请求，可是没有能力去处理，像工做线程这样限制性资源就是一个不多的例子。这可能会致使服务器丢弃与客户端的链接，而不会给予任何回应。HttpClient遭遇这种状况时，抛出NoHttpResponseException 。在多数状况下，经过重试可以今后异常中恢复。 

org.apache.commons.httpclient.ConnectTimeoutException
java.io.IOException
+- java.io.InterruptedIOException 

这种异常表示在给定的时间HttpClient与目标服务器或代理服务器创建起链接。 

 

org.apache.commons.httpclient.ConnectionPoolTimeoutException 

1. java.io.IOException  
2.   +- java.io.InterruptedIOException  
3.     +- org.apache.commons.httpclient.ConnectTimeoutException  
4.       +- org.apache.commons.httpclient.ConnectionPoolTimeoutException  

只有在使用多线程链接管理器时，才可能发生此异常。此异常表示在给定的时间从链接池中获取一个空闲链接失败。 

 

org.apache.commons.httpclient.HttpRecoverableException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.HttpRecoverableException  

废弃，任何标准HttpClient类中不会抛出此异常。 

 

协议异常 

在HTTP规范的解释中，协议异常一般是由客户端与服务器（web服务器或是代理服务器）的不匹配致使的逻辑错误。若是不对客户端的请求或服务器作出调整，HttpClient此异常不能恢复。HTTP规范的多个方面容许不一样甚至是相互冲突的解释。HttpClient能偶采用配置来支持从很是宽松到很是严格的HTTP规范的听从度。 

 

org.apache.commons.httpclient.HttpException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  

HttpException在HttpClient中表明一个抽象逻辑错误，通常状况下，程序不能从这种错误中恢复。 

 

org.apache.commons.httpclient.ProtocolException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.ProtocolException  

ProtocolException表示一个HTTP规范的冲突，值得注意的是HTTP代理服务器和HTTP服务器有着不一样的HTTP规范的支持度级别。经过配置HttpClient更宽松可让程序从非致命的协议冲突的HTTP协议异常恢复。 

 

org.apache.commons.httpclient.auth.MalformedChallengeException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.ProtocolException  
4.       +- org.apache.commons.httpclient.auth.MalformedChallengeException  

内部使用 

MalformedChallengeException表示一个身份认证凭证的某些方面在给定的身份认证的上下文中是无效或者非法的。 

 

org.apache.commons.httpclient.auth.AuthenticationException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.ProtocolException  
4.       +- org.apache.commons.httpclient.auth.AuthenticationException  

内部使用 

AuthenticationException用来表示身份认证过程当中的失败。一般，认证异常不会传递给调用者，只在内部处理使用。 

 

org.apache.commons.httpclient.auth.AuthChallengeException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.ProtocolException  
4.       +- org.apache.commons.httpclient.auth.AuthenticationException  
5.         +- org.apache.commons.httpclient.auth.AuthChallengeException  

内部使用 

HttpClient没法响应服务器发送的任何身份验证质询时，AuthenticationException将会抛出。 

 

org.apache.commons.httpclient.auth.CredentialsNotAvailableException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.ProtocolException  
4.       +- org.apache.commons.httpclient.auth.AuthenticationException  
5.         +- org.apache.commons.httpclient.auth.CredentialsNotAvailableException

内部使用 

CredentialsNotAvailableException代表响应身份验证质询的要求的证书不可用。 

 

org.apache.commons.httpclient.auth.InvalidCredentialsException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.ProtocolException  
4.       +- org.apache.commons.httpclient.auth.AuthenticationException  
5.         +- org.apache.commons.httpclient.auth.InvalidCredentialsException  

内部使用 

InvalidCredentialsException代表响应身份验证质询的要求的证书被服务器拒绝。 

 

org.apache.commons.httpclient.cookie.MalformedCookieException 

java.io.IOException 

  +- org.apache.commons.httpclient.HttpException 

    +- org.apache.commons.httpclient.ProtocolException 

      +- org.apache.commons.httpclient.cookie.MalformedCookieException 

内部使用 

MalformedCookieException表示cookie的某些方面在给定的HTTP会话上下文中是无效或者非法的。有多种不兼容cookie规范，所以，cookie合法性创建在用于分析的特定cookie规范的上下文中和验证服务器发送cookie头消息。若是应用程序须要处理不常见的cookie规范定义的cookie，请查看cookie文档获取更多的信息。 

 

org.apache.commons.httpclient.RedirectException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.ProtocolException  
4.       +- org.apache.commons.httpclient.RedirectException  

RedirectException表示一个无效的重定向响应致使了HTTP规范冲突。若是使用HttpClient的应用程序就重定向须要更多的宽松度的话，它能够选择禁用自动重定向处理和实现自定义重定向策略。 

 

org.apache.commons.httpclient.URIException 

1. java.io.IOException  
2.   +- org.apache.commons.httpclient.HttpException  
3.     +- org.apache.commons.httpclient.URIException  

URIException表示请求的URL不符合URI规范。 

 

HTTP传输安全 

有必要了解是HTTP协议并不适用于全部类型的应用程序。HTTP是一个简单的面向requestre/sponse的协议，协议最初设计为支持静态或动态生成的内容检索。它从未打算支持事务性操做。例如，若是HTTP服务器成功接收和处理该请求，HTTP服务器会考虑其履行契约的一部分，生成响应和发送状态码回客户端。若是客户端因为读取超时，请求取消，或者系统崩溃而致使读取整个响应失败，服务器将不试图回滚事务。若是客户端从新发送同一请求，服务器将最终无可避免再一次执行同一事务。在某些状况下，将有可能致使应用程序数据的损坏或程序状态的不一致。 

即便HTTP从未被设计为支持事务性处理，它仍是能够用做知足某些条件关键应用程序传输协议。为确保HTTP传输层安全系统必须确保应用层上的HTTP方法是幕等的。 

幕等方法 

HTTP/1.1规范定义幕等方法为： 

Methods can also have the property of"idempotence"in that (aside from error or expiration issues) the side-effects of N > 0 identical requests is the same as for a single request. 

换句话说，应用程序应该确保它准备处理同一个的方法的屡次执行带来的影响。这能够作到的，例如，经过提供一个惟一的事务id和经过其余方式避免执行相同的逻辑操做。 

须要注意的，这是问题并不是特定于HttpClient。基于浏览器的应用程序在涉及到非幕等HTTP方法时，也会面临一样的问题。 

 

自动异常恢复 

默认状况下HttpClient尝试从异常中自动恢复。默认的自动恢复机制仅限于少数的几个已知安全的异常。HttpClient不会尝试从任何逻辑或是HTTP协议错误（HttpException派生的异常类）中恢复。 

HttpClient将最多5次自动重试因传输异常失败的方法，虽然请求仍被传输到目标服务器（也就是说，请求还没有彻底传送到服务器）。 

HttpClient将最多自动重试那些方法5次，直到请求彻底传送到服务器，但该服务器没有响应的HTTP状态代码（服务器只是简单的丢弃链接而没有发回任何响应）。在这种状况下则假定请求未被服务器处理和应用程序状态没有改变。若是web服务器应用程序目标的假设不成立，那么极力建议您提供自定义的异常处理程序。 

 

自定义异常处理类 

为了启用自定义异常的恢复机制应提供HttpMethodRetryHandler接口的实现。 

 

HttpClient client = new HttpClient();

HttpMethodRetryHandler myretryhandler = new HttpMethodRetryHandler() {
 public boolean retryMethod(
 final HttpMethod method, 
 final IOException exception, 
 int executionCount) {
 if (executionCount >= 5) {
 // Do not retry if over max retry count
 return false;
}
 if (exception instanceof NoHttpResponseException) {
 // Retry if the server dropped connection on us
 return true;
}
 if (!method.isRequestSent()) {
 // Retry if the request has not been sent fully or
 // if it's OK to retry methods that have been sent
 return true;
}
 // otherwise do not retry
 return false;
}
};

GetMethod httpget = new GetMethod("http://www.whatever.com/");
httpget.getParams().
 setParameter(HttpMethodParams.RETRY_HANDLER, myretryhandler);
try {
client.executeMethod(httpget);
System.out.println(httpget.getStatusLine().toString());
} finally {
httpget.releaseConnection();
}