【java学习】HTTP接口调用：Httpclient、Okhttp、HttpURLConnection、RestTemplate 和 Feign

1，概念

1）REST API规范

2）Spring MVC常用注解

2，java对象

1）Request对象

1>类图

javax.servlet.ServletRequest	--	父接口
		|	继承
javax.servlet.http.HttpServletRequest	-- 接口   表示请求
		|	实现
org.apache.catalina.connector.RequestFacade 类(tomcat)

2>工作机制及生命周期

HttpServletRequest 实例对象是什么时候创建和销毁的呢？

1. client请求server；
2. server根据http协议格式解析请求内容；创建请求对象： HttpServletRequest 的实现类 RequestFacade 的对象
3. 通过set方法，将解析出的数据封装到请求对象中， HttpServletRequest 实例初始化完毕。
4. 建立响应对象，server向client发送响应。
5. 销毁HttpServletRequest 实例对象。

3>使用

//方法参数声明HttpServletRequest对象，会自动接收到HttpServletRequest请求数据。
@GetMapping
public String get(HttpServletRequest request){
   
   
   //获取客户端的IP地址
   //如果使用了反向代理那么拿到的数据是127.0.0.1或 192.168.1.110；
   request.getRemoteAddr();
   //如果使用了路由转发那么拿到的是转发服务的ip(服务器ip)，此时可以使用HuTool的工具类拿到真实客户端ip
	 ServletUtil.getClientIP(request);
}

hutool工具类：

<!-- https://mvnrepository.com/artifact/cn.hutool/hutool-all -->
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.3.5</version>
</dependency>

4>常用api

举例：当前请求 GET /day14/demo1?name=zhangsan HTTP/1.1

1.属性获取

2. header内容获取

3. body请求体获取，只有post方法支持

4. 请求转发（路由转发）
   一种在服务器内部的资源跳转方式（路由转发，区别于网址重定向）
   特点：
   a. 浏览器地址栏路径不发生变化
   b. 转发只能访问当前服务器下的资源
   c. 转发是一次请求，可以使用request对象来共享数据

5. 共享数据：

域对象：
一个有作用范围的对象，可以在范围内共享数据

request域
代表一次请求的范围，一般用于请求转发的多个资源中共享数据

5>中文乱码问题

1. get方式：tomcat 8 已经将get方式乱码问题解决了
2. post方式：会乱码
   解决：在获取参数前，设置request的编码request.setCharacterEncoding("utf-8");

2）Response对象

1>使用

//方法参数直接声明HttpServletResponse 即可以操作响应对象
public FreeLoginUrlVo freeLogin(HttpServletResponse response) {
   
   
        String url = "https://xxx/";
        try {
   
   
        		//url重定向 传递302消息给浏览器 请求参数将失效
            response.sendRedirect(url);
        } catch (IOException e) {
   
   
            log.error("免登录发生错误，请检查当前免登录配置和第三方设备配置", e);
        }
        return freeLoginUrlVo;
    }

2>常见API

1. 设置响应消息

2. 设置响应体

3. 重定向
   特点：
4. 传递302消息给浏览器，地址栏发生变化
5. 请求参数将失效
6. 重定向是两次请求，不能使用request对象来共享数据
7. 重定向可以访问其他站点(服务器)的资源

3>中文乱码问题

1. PrintWriter pw = response.getWriter();获取的流的默认编码是ISO-8859-1
2. 设置该流的默认编码
3. 告诉浏览器响应体使用的编码

//简单的形式，设置编码，是在获取流之前设置
response.setContentType("text/html;charset=utf-8");

3）

3，Httpclient（推荐）

HttpClient 是 Apache Jakarta Common 下的子项目，用来提供高效的、最新的、功能丰富的支持 Http 协议的客户端编程工具包，并且它支持 HTTP 协议最新版本和建议。HttpClient 相比传统 JDK 自带的 URLConnection，提升了易用性和灵活性，使客户端发送 HTTP 请求变得容易，提高了开发的效率。

1）使用

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version>
</dependency>

1>GET

//创建 HttpClient 的实例  记得传输完成后要close
try(CloseableHttpClient client = getClient()){
   
   
	HttpGet httpGet = new HttpGet(url);
	byte[] bytes = null;
	try{
   
   
		HttpResponse response = client.execute(httpGet);
		//下载文件的字节流  response.getEntity()才是真实的返回数据 响应内容长度:responseEntity.getContentLength()
		bytes = EntityUtils.toByteArray(response.getEntity());	
	}catch (IOException e) {
   
   
	}finally {
   
   
	   if (httpClient != null) {
   
   
	        httpClient.close();
	   }
	   if (response != null) {
   
   
	        response.close();
	   }
	}
	//将文件保存到指定路径
	filePath = filePath + File.separator + eventName + ".docx";
	try (FileOutputStream fos = new FileOutputStream(filePath)) {
   
   
	    fos.write(bytes);
	    fos.flush();
	}
}catch(){
   
   

}

getClient()中设置了忽略对服务端的SSL证书校验

private CloseableHttpClient getClient() throws NoSuchAlgorithmException, KeyStoreException, KeyManagementException {
   
   
        SSLContext sslContext = new SSLContextBuilder().loadTrustMaterial(null, (TrustStrategy) (arg0, arg1) -> true).build();
        SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
        CloseableHttpClient client = HttpClients.custom()
                .setSSLSocketFactory(sslConnectionSocketFactory)
                .build();
        return client;
    }

2>POST

//创建 HttpClient 的实例  
HttpClient client = getClient();
HttpPost httpPost = new HttpPost(url);
//设置Header
httpPost.addHeader("Content-Type", "application/json; charset=utf-8");
httpPost.setHeader("Accept", "application/json");
//设置body参数
HttpEntity httpEntity = new StringEntity(JSONObject.toJSONString(userVo), Charset.forName("UTF-8"));
httpPost.setEntity(httpEntity);
//请求
HttpResponse response = client.execute(httpPost);
//获取请求结果
JSONObject result = JSONObject.parseObject(EntityUtils.toString(response.getEntity()), JSONObject.class);

4，HttpURLConnection

HttpURLConnection 是 Java 的标准类，它继承自 URLConnection，可用于向指定网站发送 GET 请求、POST 请求。HttpURLConnection 使用比较复杂，不像 HttpClient 那样容易使用。

5，RestTemplate

RestTemplate 是 Spring 提供的用于访问 Rest 服务的客户端。

1）常用api

• url：请求地址。
• method：HTTP方法。
• requestEntity：请求体的实体对象，可包括请求头和请求参数等信息。
• responseType：响应体的类型，可以是简单类型，也可以是复合类型，如List、Map等。
• uriVariables：可选参数，表示URL中的占位符，例如/user/{userId}中的userId。