httplib

type FilterFunc func(args *RequestArgs) error

type HTTPClient struct {
	// EnableHTTPS 是否启用HTTPS
	EnableHTTPS bool

	// TLSConfig 使用HTTPS的配置
	TLSConfig *tls.Config

	// ConnectTimeout 连接超时
	ConnectTimeout time.Duration

	// RWTimeout 读写超时
	RWTimeout time.Duration

	// Retry 请求重试次数
	Retry int

	// Debug 调试信息写入
	Debug logWriter
}

type RequestArgs struct {
	// URL 请求地址 (必填)
	URL string

	// Headers HTTP请求头设置 (可选)
	// nil表示不设置请求头
	Headers map[string]string

	// Params HTTP请求参数，键值对 (可选)
	Params map[string]string

	// Body HTTP请求体设置，必须是struct或[]byte类型 (可选)
	// nil表示无请求体
	Body interface{}

	// Filters 请求过滤器，会在请求发出前依次调用
	Filters []FilterFunc

	// JSONResult 接收JSON格式的响应内容, 必须是strcut类型 (可选)
	// 如果该字段非空，将自动解析至JSONResult
	JSONResult interface{}

	// BytesResult 接收字节流响应内容 (可选)
	// 如果该字段非空，响应体内容将被写入BytesResult
	BytesResult *bytes.Buffer
}