com.whaleal.icefrog.http.HttpBase Maven / Gradle / Ivy
The newest version!
package com.whaleal.icefrog.http;
import com.whaleal.icefrog.core.collection.CollUtil;
import com.whaleal.icefrog.core.collection.CollectionUtil;
import com.whaleal.icefrog.core.map.CaseInsensitiveMap;
import com.whaleal.icefrog.core.map.MapUtil;
import com.whaleal.icefrog.core.util.CharsetUtil;
import com.whaleal.icefrog.core.util.StrUtil;
import java.nio.charset.Charset;
import java.util.*;
import java.util.Map.Entry;
/**
* http基类
*
* @param 子类类型，方便链式编程
* @author Looly
* @author wh
*/
@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 1.0.0
*/
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 1.0.0
*/
public T headerMap( Map headers, boolean isOverride ) {
if (MapUtil.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 1.0.0
*/
public T header( Map> headers, boolean isOverride ) {
if (MapUtil.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 1.0.0
*/
public T addHeaders( Map headers ) {
if (MapUtil.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版本，此方法不会影响到实际请求的HTTP版本，只用于帮助判断是否connect:Keep-Alive
*
* @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)) {
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.getKey()).append(": ").append(CollUtil.join(entry.getValue(), ","))
.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();
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy