com.dahuatech.hutool.http.HttpBase Maven / Gradle / Ivy
package com.dahuatech.hutool.http;
import com.dahuatech.hutool.core.collection.CollectionUtil;
import com.dahuatech.hutool.core.map.CaseInsensitiveMap;
import com.dahuatech.hutool.core.util.CharsetUtil;
import com.dahuatech.hutool.core.util.StrUtil;
import java.nio.charset.Charset;
import java.util.*;
import java.util.Map.Entry;
/**
* http基类
*
* @author Looly
* @param 子类类型，方便链式编程
*/
@SuppressWarnings("unchecked")
public abstract class HttpBase {
/** HTTP/1.0 */
public static final String HTTP_1_0 = "HTTP/1.0";
/** HTTP/1.1 */
public static final String HTTP_1_1 = "HTTP/1.1";
/** 存储头信息 */
protected Map> headers = new HashMap<>();
/** 编码 */
protected Charset charset = CharsetUtil.CHARSET_UTF_8;
/** http版本 */
protected String httpVersion = HTTP_1_1;
/** 存储主体 */
protected byte[] bodyBytes;
// ---------------------------------------------------------------- Headers start
/**
* 根据name获取头信息
* 根据RFC2616规范，header的name不区分大小写
*
* @param name Header名
* @return Header值
*/
public String header(String name) {
final List values = headerList(name);
if (CollectionUtil.isEmpty(values)) {
return null;
}
return values.get(0);
}
/**
* 根据name获取头信息列表
*
* @param name Header名
* @return Header值
* @since 3.1.1
*/
public List headerList(String name) {
if (StrUtil.isBlank(name)) {
return null;
}
final CaseInsensitiveMap> headersIgnoreCase =
new CaseInsensitiveMap<>(this.headers);
return headersIgnoreCase.get(name.trim());
}
/**
* 根据name获取头信息
*
* @param name Header名
* @return Header值
*/
public String header(Header name) {
if (null == name) {
return null;
}
return header(name.toString());
}
/**
* 设置一个header
* 如果覆盖模式，则替换之前的值，否则加入到值列表中
*
* @param name Header名
* @param value Header值
* @param isOverride 是否覆盖已有值
* @return T 本身
*/
public T header(String name, String value, boolean isOverride) {
if (null != name && null != value) {
final List values = headers.get(name.trim());
if (isOverride || CollectionUtil.isEmpty(values)) {
final ArrayList valueList = new ArrayList<>();
valueList.add(value);
headers.put(name.trim(), valueList);
} else {
values.add(value.trim());
}
}
return (T) this;
}
/**
* 设置一个header
* 如果覆盖模式，则替换之前的值，否则加入到值列表中
*
* @param name Header名
* @param value Header值
* @param isOverride 是否覆盖已有值
* @return T 本身
*/
public T header(Header name, String value, boolean isOverride) {
return header(name.toString(), value, isOverride);
}
/**
* 设置一个header
* 覆盖模式，则替换之前的值
*
* @param name Header名
* @param value Header值
* @return T 本身
*/
public T header(Header name, String value) {
return header(name.toString(), value, true);
}
/**
* 设置一个header
* 覆盖模式，则替换之前的值
*
* @param name Header名
* @param value Header值
* @return T 本身
*/
public T header(String name, String value) {
return header(name, value, true);
}
/**
* 设置请求头
*
* @param headers 请求头
* @param isOverride 是否覆盖已有头信息
* @return this
* @since 4.6.3
*/
public T headerMap(Map headers, boolean isOverride) {
if (CollectionUtil.isEmpty(headers)) {
return (T) this;
}
for (Entry entry : headers.entrySet()) {
this.header(entry.getKey(), StrUtil.nullToEmpty(entry.getValue()), isOverride);
}
return (T) this;
}
/**
* 设置请求头
* 不覆盖原有请求头
*
* @param headers 请求头
* @return this
*/
public T header(Map> headers) {
return header(headers, false);
}
/**
* 设置请求头
*
* @param headers 请求头
* @param isOverride 是否覆盖已有头信息
* @return this
* @since 4.0.8
*/
public T header(Map> headers, boolean isOverride) {
if (CollectionUtil.isEmpty(headers)) {
return (T) this;
}
String name;
for (Entry> entry : headers.entrySet()) {
name = entry.getKey();
for (String value : entry.getValue()) {
this.header(name, StrUtil.nullToEmpty(value), isOverride);
}
}
return (T) this;
}
/**
* 新增请求头
* 不覆盖原有请求头
*
* @param headers 请求头
* @return this
* @since 4.0.3
*/
public T addHeaders(Map headers) {
if (CollectionUtil.isEmpty(headers)) {
return (T) this;
}
for (Entry entry : headers.entrySet()) {
this.header(entry.getKey(), StrUtil.nullToEmpty(entry.getValue()), false);
}
return (T) this;
}
/**
* 移除一个头信息
*
* @param name Header名
* @return this
*/
public T removeHeader(String name) {
if (name != null) {
headers.remove(name.trim());
}
return (T) this;
}
/**
* 移除一个头信息
*
* @param name Header名
* @return this
*/
public T removeHeader(Header name) {
return removeHeader(name.toString());
}
/**
* 获取headers
*
* @return Headers Map
*/
public Map> headers() {
return Collections.unmodifiableMap(headers);
}
// ---------------------------------------------------------------- Headers end
/**
* 返回http版本
*
* @return String
*/
public String httpVersion() {
return httpVersion;
}
/**
* 设置http版本
*
* @param httpVersion Http版本，{@link HttpBase#HTTP_1_0}，{@link HttpBase#HTTP_1_1}
* @return this
*/
public T httpVersion(String httpVersion) {
this.httpVersion = httpVersion;
return (T) this;
}
/**
* 返回字符集
*
* @return 字符集
*/
public String charset() {
return charset.name();
}
/**
* 设置字符集
*
* @param charset 字符集
* @return T 自己
* @see CharsetUtil
*/
public T charset(String charset) {
if (StrUtil.isNotBlank(charset)) {
this.charset = Charset.forName(charset);
}
return (T) this;
}
/**
* 设置字符集
*
* @param charset 字符集
* @return T 自己
* @see CharsetUtil
*/
public T charset(Charset charset) {
if (null != charset) {
this.charset = charset;
}
return (T) this;
}
@Override
public String toString() {
StringBuilder sb = StrUtil.builder();
sb.append("Request Headers: ").append(StrUtil.CRLF);
for (Entry> entry : this.headers.entrySet()) {
sb.append(" ").append(entry).append(StrUtil.CRLF);
}
sb.append("Request Body: ").append(StrUtil.CRLF);
sb.append(" ").append(StrUtil.str(this.bodyBytes, this.charset)).append(StrUtil.CRLF);
return sb.toString();
}
}