### HttpClient入门介绍与实例解析
#### 一、HttpClient概述
HttpClient是Apache Jakarta Commons项目下的一个子项目，提供了高效、功能丰富的HTTP客户端实现。它不仅支持HTTP协议的基本操作，还提供了高级功能，如重定向处理、身份验证、SSL/TLS安全连接等。在Java开发中，HttpClient是一个非常重要的库，用于发送HTTP请求并接收响应。
#### 二、HttpClient的使用详解
##### 1. HttpClient实例化
我们需要创建一个`HttpClient`实例。这一步是所有后续操作的基础，因为所有的HTTP请求都是通过这个实例来执行的。
```java
HttpClient httpClient = new HttpClient();
```
##### 2. GET方法的实现
接着，我们需要创建一个`GetMethod`对象，并设置其URL。这个URL是我们想要访问的网页地址。
```java
GetMethod getMethod = new GetMethod("http://www.ibm.com");
```
注意，如果目标URL包含重定向，可以通过`setFollowRedirects(false)`来控制是否自动跟随重定向，默认情况下，`GetMethod`会自动处理重定向。
##### 3. 执行方法
然后，我们调用`executeMethod`方法来执行我们的`GetMethod`。这个方法可能抛出`HttpException`或`IOException`异常，因此我们需要进行适当的错误处理。
```java
int statusCode = httpClient.executeMethod(getMethod);
```
##### 4. 检查状态码
执行完`executeMethod`后，我们检查返回的状态码，以判断请求是否成功。
```java
if (statusCode != HttpStatus.SC_OK) {
System.err.println("Method failed: " + getMethod.getStatusLine());
}
```
##### 5. 获取响应数据
一旦确认请求成功，我们就可以获取响应的数据了。`getResponseBody`方法返回字节数组，而`getResponseBodyAsString`则直接返回字符串格式的响应体。默认情况下，字符串的编码是平台的默认编码。
```java
byte[] responseBody = getMethod.getResponseBody();
String responseString = new String(responseBody);
```
##### 6. 释放连接
不要忘记调用`releaseConnection`方法来释放HTTP连接，这是一个很好的编程习惯，可以避免资源泄露。
```java
getMethod.releaseConnection();
```
#### 三、示例代码分析
以下是一段完整的示例代码，演示了如何使用`HttpClient`进行GET请求：
```java
package test;
import java.io.IOException;
import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.GetMethod;
import org.apache.commons.httpclient.params.HttpMethodParams;
public class GetSample {
public static void main(String[] args) {
// 创建HttpClient实例
HttpClient httpClient = new HttpClient();
// 创建GET方法并设置URL
GetMethod getMethod = new GetMethod("http://www.ibm.com");
// 使用系统提供的默认重试处理器
getMethod.getParams().setParameter(HttpMethodParams.RETRY_HANDLER,
new DefaultHttpMethodRetryHandler());
try {
// 执行GET方法
int statusCode = httpClient.executeMethod(getMethod);
if (statusCode != HttpStatus.SC_OK) {
System.err.println("Method failed: " + getMethod.getStatusLine());
} else {
byte[] responseBody = getMethod.getResponseBody();
System.out.println(new String(responseBody));
}
} catch (HttpException e) {
System.err.println("Fatal protocol violation: " + e.getMessage());
} catch (IOException e) {
System.err.println("Fatal transport error: " + e.getMessage());
} finally {
getMethod.releaseConnection();
}
}
}
```
这段代码展示了如何使用`HttpClient`发送一个GET请求，并处理可能出现的异常。通过这段代码，我们可以看到`HttpClient`的使用流程，包括实例化、方法创建、执行、结果检查、数据获取以及连接释放等关键步骤。这对于初学者理解和掌握`HttpClient`的使用至关重要。
