JAVA基础 - HTTP调用

常用方式

Java项目中调用第三方接口的方式有：

1. 通过JDK自带的网络类HttpURLConnection

2. 通过Apache common封装HttpClient

3. 通过Apache封装好的CloseableHttpClient

4. Springboot提供的RestTemplate

5. 通过OkHttp

6. 通过hutool的HttpUtil

HttpClient

参考资料：Java请求Http接口-httpClient (超详细-附带工具类)_java 请求接口-优快云博客

HttpClient是Apache Common下的子项目，用来提供高效的、最新的、功能丰富的支持HTTP协议的客户端编程工具包，相比传统JDK自带的URLConnection，增加了易用性和灵活性，既提高了开发的效率，也方便提高代码的健壮性。

使用步骤

使用HttpClient发送请求、接收响应很简单，一般需要如下几步即可。

使用HttpClient发送请求、接收响应很简单，一般需要如下几步即可。

1. 创建HttpClient对象。HttpClients.createDefault(); 最新版的实现类是CloseableHTTPClient。
2. 创建HttpUriRequest对象。创建HttpGet或HttpPost对象，并指定请求URL。
3. 设置请求参数（HttpEntity或HttpParams）。 可调用HttpGet、HttpPost共同的setParams(HttpParams params)方法来添加请求参数；对于HttpPost对象而言，也可调用setEntity(HttpEntity entity)方法来设置请求参数。
4. 发送请求。调用HttpClient对象的execute(HttpUriRequest request)发送请求，该方法返回一个HttpResponse。
5. 获取响应内容（HttpResponse）。调用HttpResponse的getAllHeaders()、getHeaders(String name)等方法可获取服务器的响应头；调用HttpResponse的getEntity()方法可获取HttpEntity对象，该对象包装了服务器的响应内容。程序可通过该对象获取服务器的响应内容。
6. 释放连接（HttpClientUtils.closeQuietly(httpResponse);）。无论执行方法是否成功，都必须释放连接。

HttpEntity (接口)

介绍

HttpEntity接口，位于 org.apache.http.HttpEntity 包中，它表示 HTTP 消息实体，是 HTTP 请求或响应的载体。

HttpEntity 接口定义了几个方法来操作 HTTP 消息实体：

• boolean isRepeatable(): 检查实体是否可重复读取。
• boolean isChunked(): 检查实体是否使用分块传输编码。
• long getContentLength(): 获取内容长度。
• InputStream getContent(): 获取内容作为输入流。
• Header getContentType(): 获取内容类型头信息。
• Header getContentEncoding(): 获取内容编码头信息。
• void writeTo(OutputStream outstream) throws IOException: 将内容写入到输出流。
• boolean isStreaming(): 检查内容是否流式。

实现类

在Java中，有许多实现了 HttpEntity 接口的类，例如 StringEntity, ByteArrayEntity, InputStreamEntity, 和 FileEntity 等。

StringEntity

httpPost.setEntity(new StringEntity(requestParams, ContentType.APPLICATION_JSON));

ByteArrayEntity

HttpPost post = new HttpPost("http://www.example.com");

byte[] data = new byte[] { 1, 2, 3, 4 };

ByteArrayEntity entity = new ByteArrayEntity(data);

post.setEntity(entity);

InputStreamEntity

HttpPost post = new HttpPost("http://www.example.com");

InputStream is = new FileInputStream("data.bin");

InputStreamEntity entity = new InputStreamEntity(is, is.available());

post.setEntity(entity);

FileEntity

HttpPost post = new HttpPost("http://www.example.com");

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

FileEntity entity = new FileEntity(file, ContentType.TEXT_PLAIN);

post.setEntity(entity);

HttpEntity<T> (泛型类)

介绍

HttpEntity<T> 是一个泛型类，位于包org.springframework.http，是 Spring 框架中的一个重要类，它用来封装 HTTP 请求或响应的头信息和正文内容，其中 T 代表请求或响应的主体类型。在 Spring 的 RestTemplate、WebClient 和 RestController 中广泛使用。以下是 HttpEntity 类的详细介绍。

常用方法：

• 获取头信息：HttpHeaders headers = entity.getHeaders();
• 获取正文内容：T body = entity.getBody();

RequestEntity<T>

RequestEntity<T>继承自HttpEntity<T>，是封装请求报文的一种类型，需要在控制器方法的形参中设置该类型的形参，当前请求的请求报文就会赋值给该形参，可以通过getHeaders()获取请求头信息，通过getBody()获取请求体信息。

ResponseEntity<T>

ResponseEntity<T> 是一个更具体的类，它也支持一个数据类型参数 T，但还包含了一个 Status 类型的成员变量，用于表示 HTTP 响应的状态码。这使得 ResponseEntity<T> 能够更好地表示完整的 HTTP 响应，包括状态码、响应头和响应体。

RestTemplate

RestTemplate是由Spring框架提供的一个可用于应用中调用rest服务的类。它的设计原则与许多其他Spring的模板类(例如JdbcTemplate)相同，为执行复杂任务提供了一种具有默认行为的简化方法。

它简化了与http服务的通信方式，统一了RESTFul的标准，封装了http连接，只需要传入url及其返回值类型即可。相较于常用的HttpClient，RestTemplate是一种更为优雅的调用RESTFul服务的方式。

常用方法

        getForObject 和 getForEntity 的差异主要体现在返回值的差异上， getForObject 的返回值就是服务提供者返回的数据，使用 getForObject 无法获取到响应头。postForObject 和 postForEntity 基本一致也是同样的区别。