
icu.easyj.web.util.HttpClientUtils Maven / Gradle / Ivy
/*
* Copyright 2021-2024 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package icu.easyj.web.util;
import java.util.Map;
import icu.easyj.core.loader.EnhancedServiceLoader;
import icu.easyj.web.util.httpclient.IHttpClientService;
import org.springframework.lang.Nullable;
import org.springframework.util.MultiValueMap;
/**
* http(s)客户端工具类
*
* 提供请求http(s)服务。
*
* @author wangliang181230
*/
public abstract class HttpClientUtils {
/**
* {@link IHttpClientService} 默认的实现
*/
private static final IHttpClientService HTTP_CLIENT_SERVICE = EnhancedServiceLoader.load(IHttpClientService.class);
/**
* 获取 {@link IHttpClientService} 默认的实现
*
* @return 默认的实现
*/
public static IHttpClientService getService() {
return HTTP_CLIENT_SERVICE;
}
//region GET请求
/**
* 发送GET请求
*
* @param url 服务地址
* @param queryStringMap 更多的 QueryString 参数(键和值未转义)
* @param headers 附加头信息
* @param responseClass 响应类型
* @param 响应类
* @return 响应
*/
public T get(String url, @Nullable Map queryStringMap, @Nullable MultiValueMap headers, Class responseClass) {
return HTTP_CLIENT_SERVICE.get(url, queryStringMap, headers, responseClass);
}
/**
* 发送GET请求(无附加头信息)
*
* @param url 服务地址
* @param queryStringMap 更多的 QueryString 参数(键和值未转义)
* @param responseClass 响应类型
* @param 响应类
* @return 响应
*/
public static T get(String url, @Nullable Map queryStringMap, Class responseClass) {
return HTTP_CLIENT_SERVICE.get(url, queryStringMap, null, responseClass);
}
/**
* 发送GET请求(无更多QueryString参数)
*
* @param url 服务地址
* @param headers 附加头信息
* @param responseClass 响应类型
* @param 响应类
* @return 响应
*/
public static T get(String url, @Nullable MultiValueMap headers, Class responseClass) {
return HTTP_CLIENT_SERVICE.get(url, null, headers, responseClass);
}
/**
* 发送GET请求(无更多QueryString参数、无附加头信息)
*
* @param url 服务地址
* @param responseClass 响应类型
* @param 响应类
* @return 响应
*/
public static T get(String url, Class responseClass) {
return HTTP_CLIENT_SERVICE.get(url, null, null, responseClass);
}
/**
* 发送GET请求(无更多QueryString参数、无附加头信息、返回String)
*
* @param url 服务地址
* @return 响应
*/
public static String get(String url) {
return HTTP_CLIENT_SERVICE.get(url, null, null, String.class);
}
//endregion
//region POST请求
/**
* 发送POST请求
*
* @param url 服务地址
* @param requestBody 请求体
* @param headers 附加头信息
* @param responseClass 响应类型
* @param 响应类
* @return 响应
*/
public static T post(String url, @Nullable Object requestBody, @Nullable MultiValueMap headers, Class responseClass) {
return HTTP_CLIENT_SERVICE.post(url, requestBody, headers, responseClass);
}
/**
* 发送POST请求(无请求体)
*
* @param url 服务地址
* @param requestBody 请求体
* @param responseClass 响应类型
* @param 响应类
* @return 响应
*/
public static T post(String url, @Nullable Object requestBody, Class responseClass) {
return HTTP_CLIENT_SERVICE.post(url, requestBody, null, responseClass);
}
/**
* 发送POST请求(无请求体)
*
* @param url 服务地址
* @param headers 附加头信息
* @param responseClass 响应类型
* @param 响应类
* @return 响应
*/
public static T post(String url, @Nullable MultiValueMap headers, Class responseClass) {
return HTTP_CLIENT_SERVICE.post(url, null, headers, responseClass);
}
/**
* 发送POST请求(无请求体、无附加头信息)
*
* @param url 服务地址
* @param responseClass 响应类型
* @param 响应类
* @return 响应
*/
public static T post(String url, Class responseClass) {
return HTTP_CLIENT_SERVICE.post(url, null, null, responseClass);
}
/**
* 发送POST请求(无请求体、无附加头信息、返回String)
*
* @param url 服务地址
* @return 响应
*/
public static String post(String url) {
return HTTP_CLIENT_SERVICE.post(url, null, null, String.class);
}
//endregion
}