SpringBoot发送Http请求
[提前声明]
文章由作者:张耀峰 结合自己生产中的使用经验整理,最终形成简单易懂的文章
写作不易,转载请注明,谢谢!
大数据代码案例地址: https://github.com/Mydreamandreality/sparkResearch
前言
之前我写过一篇关于SpringBoot发送Http请求的文章、当时使用的是Apache,Http.client
,
文章地址:图解springboot后端发送HttpGet和HttpPost请求
但是使用这个工具发送请求很繁琐、代码看起来也很复杂、而且大部分都是冗余的代码、而Spring给我们提供了一个发送Http请求的工具、所以我觉得有必要安利一下
RestTemplate
首先看下spring官方对RestTemplate的解释
RestTemplate是Spring用于同步client端的核心类,简化了与http服务的通信,并满足RestFul原则,程序代码可以给它提供URL,并提取结果。默认情况下,RestTemplate默认依赖jdk的HTTP连接工具。当然你也可以 通过setRequestFactory属性切换到不同的HTTP源,比如Apache HttpComponents、Netty和OkHttp
如何使用
经过简单了解后、我们不多bb、直接上代码、通过代码来说话
- 1、pom配置
先声明下我的SpringBoot版本:<version>2.1.13.RELEASE</version>
在org.springframework.web
中已经默认集成了RestTemplate
引用apache的httclient (不是用RestTemplate吗?为什么又引用了apache的client、别急 稍后解释
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.6</version>
</dependency>
- 2、RestTemplate配置
在Spring的官方文档中可以了解到、RestTemplate 采用同步方式执行 HTTP 请求的类,底层使用 JDK 原生 HttpURLConnection API ,或者 HttpComponents等其他 HTTP 客户端请求类库。还有一处强调的就是 RestTemplate 提供模板化的方法让开发者能更简单地发送 HTTP 请求
既然如此、那么我们底层依然使用apache的client给我们提供的http请求服务能力、上层的应用开发使用RestTemplate的模板
ClientHttpRequestFactory 接口有4个实现类,分别是:
- AbstractClientHttpRequestFactoryWrapper 用来装配其他request factory的抽象类。
- CommonsClientHttpRequestFactory 允许用户配置带有认证和http连接池的httpclient,已废弃,推荐用HttpComponentsClientHttpRequestFactory。
- HttpComponentsClientHttpRequestFactory 同2.
- SimpleClientHttpRequestFactory 接口的一个简单实现,可配置proxy,connectTimeout,readTimeout等参数。
我们使用的是HttpComponentsClientHttpRequestFactory
来配置
- 配置application.yml
首先我们自定义一些配置参数、后面会用到
http_pool:
max_total: 200
default_max_per_route: 100
connect_timeout: 5000
connection_request_timeout: 1000
socket_timeout: 65000
validate_after_inactivity: 2000
- 新建ApplicationValues.java
这个是读取配置中的参数方法
import lombok.Getter;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
/**
* @author 孤
* @version v1.0
* @Developers 张耀烽
* @serviceProvider 四叶草安全(SeClover)
* @description 获取Application配置数据
* @date
*/
@Getter
@Component
public class ApplicationValues {
@Value("${http_pool.max_total}")
private int maxTotal;
@Value("${http_pool.default_max_per_route}")
private int maxPerRoute;
@Value("${http_pool.connect_timeout}")
private int connTimeOut;
@Value("${http_pool.connection_request_timeout}")
private int connReqTimeOut;
@Value("${http_pool.socket_timeout}")
private int socketTimeout;
@Value("${http_pool.validate_after_inactivity}")
private int inactivity;
}
- 新建RestTemplateConfig.java
这个是配置我们的底层http客户端(这里我们使用apache的client
如何配置:
Spring提供了HttpComponentsClientHttpRequestFactory可以通过该方法来配置我们的http客户端
import com.clover.api.consts.ApplicationValues;
import org.apache.http.client.HttpClient;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.config.Registry;
import org.apache.http.config.RegistryBuilder;
import org.apache.http.conn.socket.ConnectionSocketFactory;
import org.apache.http.conn.socket.PlainConnectionSocketFactory;
import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.client.ClientHttpRequestFactory;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;
/**
* @author 孤
* @version v1.0
* @Developers 张耀烽
* @serviceProvider 四叶草安全(SeClover)
* @description http工厂配置
* @date
*/
@Configuration
public class RestTemplateConfig {
@Autowired
private ApplicationValues appValues;
@Bean
public RestTemplate restTemplate() {
return new RestTemplate(httpRequestFactory());
}
@Bean
public ClientHttpRequestFactory httpRequestFactory() {
return new HttpComponentsClientHttpRequestFactory(httpClient());
}
@Bean
public HttpClient httpClient() {
Registry<ConnectionSocketFactory> registry = RegistryBuilder.<ConnectionSocketFactory>create()
.register("http", PlainConnectionSocketFactory.getSocketFactory())
.register("https", SSLConnectionSocketFactory.getSocketFactory())
.build();
PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager(registry);
connectionManager.setMaxTotal(appValues.getMaxTotal());
connectionManager.setDefaultMaxPerRoute(appValues.getMaxPerRoute());
connectionManager.setValidateAfterInactivity(appValues.getInactivity());
RequestConfig requestConfig = RequestConfig.custom()
//服务器返回数据(response)的时间,超过抛出read timeout
.setSocketTimeout(appValues.getSocketTimeout())
//连接上服务器(握手成功)的时间,超出抛出connect timeout
.setConnectTimeout(appValues.getConnTimeOut())
//从连接池中获取连接的超时时间,超时间未拿到可用连接,会抛出org.apache.http.conn.ConnectionPoolTimeoutException: Timeout waiting for connection from pool
.setConnectionRequestTimeout(appValues.getConnReqTimeOut())
.build();
return HttpClientBuilder.create()
.setDefaultRequestConfig(requestConfig)
.setConnectionManager(connectionManager)
.build();
}
}
- 发送请求
RestTemplate对于不同的请求方式提供了不同的函数、我把官方的图贴一下、下面我会把常用的跟大家说一下
发送Post请求、请求参数为json
一般的post请求都是从body中传递json参数、比如是这样的
{
"name":"张耀烽",
"sex":"男"
}
- 首先我们构造我们的json请求参数
- 其次发送请求
请求发送成功后、会返回 ResponseEntity
对象、spring把response的所有结果集都封装在了这个对象中、我们可以按需使用、此处我只获取了请求成功后返回的body
/**
* 生成post请求的JSON请求参数
* 请求示例:
* {
* "id":1,
* "name":"张耀烽"
* }
*
* @return
*/
public HttpEntity<Map<String, String>> generatePostJson(Map<String, String> jsonMap) {
//如果需要其它的请求头信息、都可以在这里追加
HttpHeaders httpHeaders = new HttpHeaders();
MediaType type = MediaType.parseMediaType("application/json;charset=UTF-8");
httpHeaders.setContentType(type);
HttpEntity<Map<String, String>> httpEntity = new HttpEntity<>(jsonMap, httpHeaders);
return httpEntity;
}
/**
* post请求、请求参数为json
*
* @return
*/
public String sendPost() {
String uri = "http://127.0.0.1:80";
Map<String, String> jsonMap = new HashMap<>(6);
jsonMap.put("name", "张耀烽");
jsonMap.put("sex", "男");
ResponseEntity<String> apiResponse = restTemplate.postForEntity
(
uri,
generatePostJson(jsonMap),
String.class
);
return apiResponse.getBody();
}
发送get请求、请求参数为uri参数
get的请求我们一般都是通过uri的方式来进行传参,比如:
http://127.0.0.1:80/?name=张耀烽&sex=男
- 首先构造我们的get请求参数
- 发送get请求、获取结果
/**
* 生成get参数请求url
* 示例:https://0.0.0.0:80/api?u=u&o=o
* 示例:https://0.0.0.0:80/api
*
* @param protocol 请求协议 示例: http 或者 https
* @param uri 请求的uri 示例: 0.0.0.0:80
* @param params 请求参数
* @return
*/
public String generateRequestParameters(String protocol, String uri, Map<String, String> params) {
StringBuilder sb = new StringBuilder(protocol).append("://").append(uri);
if (ToolUtil.isNotEmpty(params)) {
sb.append("?");
for (Map.Entry map : params.entrySet()) {
sb.append(map.getKey())
.append("=")
.append(map.getValue())
.append("&");
}
uri = sb.substring(0, sb.length() - 1);
return uri;
}
return sb.toString();
}
/**
* get请求、请求参数为?拼接形式的
* <p>
* 最终请求的URI如下:
* <p>
* http://127.0.0.1:80/?name=张耀烽&sex=男
*
* @return
*/
public String sendGet() {
Map<String, String> uriMap = new HashMap<>(6);
uriMap.put("name", "张耀烽");
uriMap.put("sex", "男");
ResponseEntity responseEntity = restTemplate.getForEntity
(
generateRequestParameters("http", "127.0.0.1:80", uriMap),
String.class
);
return (String) responseEntity.getBody();
}
总结
到此我们两种常用的请求就已经掌握了、其它的方法你们需要用的时候去看就可以了、都是一些重载的方法、大同小异。
完整代码:
import com.clover.api.utils.tools.ToolUtil;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestTemplate;
import java.util.HashMap;
import java.util.Map;
/**
* @author 孤
* @version v1.0
* @Developers 张耀烽
* @serviceProvider 四叶草安全(SeClover)
* @description 请简易描述定义
* @date 2020/5/14
*/
@Component
public class RestMock<k, v> {
@Autowired
private RestTemplate restTemplate;
/**
* 生成post请求的JSON请求参数
* 请求示例:
* {
* "id":1,
* "name":"张耀烽"
* }
*
* @return
*/
public HttpEntity<Map<String, String>> generatePostJson(Map<String, String> jsonMap) {
//如果需要其它的请求头信息、都可以在这里追加
HttpHeaders httpHeaders = new HttpHeaders();
MediaType type = MediaType.parseMediaType("application/json;charset=UTF-8");
httpHeaders.setContentType(type);
HttpEntity<Map<String, String>> httpEntity = new HttpEntity<>(jsonMap, httpHeaders);
return httpEntity;
}
/**
* 生成get参数请求url
* 示例:https://0.0.0.0:80/api?u=u&o=o
* 示例:https://0.0.0.0:80/api
*
* @param protocol 请求协议 示例: http 或者 https
* @param uri 请求的uri 示例: 0.0.0.0:80
* @param params 请求参数
* @return
*/
public String generateRequestParameters(String protocol, String uri, Map<String, String> params) {
StringBuilder sb = new StringBuilder(protocol).append("://").append(uri);
if (ToolUtil.isNotEmpty(params)) {
sb.append("?");
for (Map.Entry map : params.entrySet()) {
sb.append(map.getKey())
.append("=")
.append(map.getValue())
.append("&");
}
uri = sb.substring(0, sb.length() - 1);
return uri;
}
return sb.toString();
}
/**
* get请求、请求参数为?拼接形式的
* <p>
* 最终请求的URI如下:
* <p>
* http://127.0.0.1:80/?name=张耀烽&sex=男
*
* @return
*/
public String sendGet() {
Map<String, String> uriMap = new HashMap<>(6);
uriMap.put("name", "张耀烽");
uriMap.put("sex", "男");
ResponseEntity responseEntity = restTemplate.getForEntity
(
generateRequestParameters("http", "127.0.0.1:80", uriMap),
String.class
);
return (String) responseEntity.getBody();
}
/**
* post请求、请求参数为json
*
* @return
*/
public String sendPost() {
String uri = "http://127.0.0.1:80";
Map<String, String> jsonMap = new HashMap<>(6);
jsonMap.put("name", "张耀烽");
jsonMap.put("sex", "男");
ResponseEntity<String> apiResponse = restTemplate.postForEntity
(
uri,
generatePostJson(jsonMap),
String.class
);
return apiResponse.getBody();
}
}