contract

type BodyEncoder interface {
	Encode() (io.Reader, error)
}

type CertConfig struct {
	CertFile string
	KeyFile  string
}

type ClientConfig struct {
	Timeout  time.Duration
	Cert     CertConfig
	ProxyURI string
	// 如果需要定制化tls, 设置该属性, 否则请使用Cert
	TlsConfig *tls.Config
}

type ClientInterface interface {
	// SetConfig 覆盖原来的 Client 配置
	SetConfig(config *ClientConfig)

	// GetConfig 返回当前客户端配置(副本)
	GetConfig() ClientConfig

	// DoRequest 默认请求接口
	DoRequest(request *http.Request) (response *http.Response, err error)
}

type MultipartDfInterface interface {
	Boundary(b string) MultipartDfInterface
	FileByPath(fieldName string, filePath string) MultipartDfInterface
	FileMem(fieldName string, fileName string, reader io.Reader) MultipartDfInterface
	Part(header textproto.MIMEHeader, reader io.Reader) MultipartDfInterface
	FieldValue(fieldName string, value string) MultipartDfInterface
	Field(fieldName string, reader io.Reader) MultipartDfInterface
	Close() error
	GetBoundary() string
	GetReader() io.Reader
	GetContentType() string
	Err() error
}

type RequestDataflowInterface interface {
	WithContext(ctx context.Context) RequestDataflowInterface
	Method(method string) RequestDataflowInterface
	Uri(uri string) RequestDataflowInterface
	Url(url string) RequestDataflowInterface
	Header(key string, values ...string) RequestDataflowInterface
	Query(key string, values ...string) RequestDataflowInterface

	Json(jsonAny interface{}) RequestDataflowInterface
	Body(body io.Reader) RequestDataflowInterface
	Any(data BodyEncoder) RequestDataflowInterface
	Xml(xmlAny interface{}) RequestDataflowInterface
	Multipart(multipartDf func(multipart MultipartDfInterface)) RequestDataflowInterface

	Err() error

	Request() (response *http.Response, err error)
	Result(result interface{}) (err error)
	RequestResHelper() (response ResponseHelper, err error)
}

type RequestHandle func(request *http.Request) (response *http.Response, err error)

type RequestHelperInterface interface {
	SetClient(client ClientInterface)
	GetClient() ClientInterface

	// WithMiddleware 设置中间件, 在初始化 RequestDataflowInterface 时调用
	WithMiddleware(middlewares ...RequestMiddleware)

	// Df 返回链式构建实例, 该实例应该引用 RequestHelperInterface 的 ClientDriver 和 RequestHandle(middleware build以后的方法)
	Df() RequestDataflowInterface
}

type RequestMiddleware func(handle RequestHandle) RequestHandle

type ResponseHelper interface {
	GetStatusCode() int
	GetHeader(key string) string
	GetBody() io.Reader
	GetBodyBytes() ([]byte, error)
	GetBodyJsonAsMap() (map[string]interface{}, error)
}