cn.geektool.http.HttpBase Maven / Gradle / Ivy
package cn.geektool.http;
import cn.geektool.core.collection.CollUtil;
import cn.geektool.core.collection.CollectionUtil;
import cn.geektool.core.map.CaseInsensitiveMap;
import cn.geektool.core.util.CharsetUtil;
import cn.geektool.core.util.StrUtil;
import java.nio.charset.Charset;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
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)){
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();
}
}