gohttpx

Documentation

Index

• Constants
• func AddGlobalHeader(k, v string)
• func GetBaseUrl() string
• func GetGlobalHeaders() map[string]string
• func HttpConcurrencyRequest[T any](req *Request, t *T) error
• func HttpGet[T any](context context.Context, req *Request, t *T) error
• func HttpPost[T any](context context.Context, req *Request, t *T) error
• func HttpPostJson[T any](context context.Context, req *Request, t *T) error
• func HttpRequest[T any](context context.Context, req *Request, t *T) error
• func SetBaseUrl(base string)
• type Request
  • func (r *Request) AddUrl(url string)
  • func (r *Request) SetBody(body interface{})
  • func (r *Request) SetHeader(name string, value string)
  • func (r *Request) SetMethod(method string)
  • func (r *Request) SetQueryParams(name string, value string)
  • func (r *Request) SetRetryCount(tryCount int)
  • func (r *Request) SetRetryWaitTime(waitTime time.Duration)
  • func (r *Request) SetTimeout(timeout time.Duration)
• type Response
  • func HttpBadRequest(msg string) *Response
  • func HttpFail(msg string) *Response
  • func HttpFailForCode(code int64, msg string) *Response
  • func HttpForbidden(msg string) *Response
  • func HttpNotFound(msg string) *Response
  • func HttpServerError(msg string) *Response
  • func HttpSuccess(data interface{}) *Response
  • func HttpSuccessByCode(code int64, data interface{}) *Response
  • func HttpUnauthorized(msg string) *Response

Constants

const (
	TAG = "gohttpx"

	CONTENT_TYPE_XML  = "application/xml"
	CONTENT_TYPE_JSON = "application/json"
	CONTENT_TYPE_FORM = "application/x-www-form-urlencoded"
)

const (
	POST   = "post"
	GET    = "get"
	PUT    = "put"
	DELETE = "delete"
)

const (
	HttpUnknownError = 1000
	HttpRetryError   = 2000
	HttpParamsError  = 3000
)

Functions

func AddGlobalHeader

func AddGlobalHeader(k, v string)

func GetBaseUrl

func GetBaseUrl() string

func GetGlobalHeaders

func GetGlobalHeaders() map[string]string

func HttpConcurrencyRequest

func HttpConcurrencyRequest[T any](req *Request, t *T) error

带多个Urls重试逻辑,并发请求,速度快先到达后 直接返回，其他请求取消

func HttpGet

func HttpGet[T any](context context.Context, req *Request, t *T) error

func HttpPost

func HttpPost[T any](context context.Context, req *Request, t *T) error

func HttpPostJson

func HttpPostJson[T any](context context.Context, req *Request, t *T) error

func HttpRequest

func HttpRequest[T any](context context.Context, req *Request, t *T) error

带多个Urls重试逻辑

func SetBaseUrl

func SetBaseUrl(base string)

Types

type Request

type Request struct {
	Url         string
	Urls        []string // 如果有值，当url 请求失败时继续用这里的接口尝试，直到成功返回或者全部失败
	Method      string
	Body        interface{}       //post body 参数
	QueryParams map[string]string //get 参数
	FormData    map[string]string //formdata 参数
	Headers     map[string]string

	Files             map[string]string //上传文件列表
	FileName          string            //文件名称
	MultipartFormData map[string]string
	FileBytes         []byte

	Timeout       time.Duration
	RetryCount    int
	RetryWaitTime time.Duration

	//trace infos
	TraceInfo     resty.TraceInfo
	ResponseTime  time.Duration
	ResponseProto string
	Response      *resty.Response
	// contains filtered or unexported fields
}

func (*Request) AddUrl

func (r *Request) AddUrl(url string)

重复会去重

func (*Request) SetBody

func (r *Request) SetBody(body interface{})

func (*Request) SetHeader

func (r *Request) SetHeader(name string, value string)

func (*Request) SetMethod

func (r *Request) SetMethod(method string)

func (*Request) SetQueryParams

func (r *Request) SetQueryParams(name string, value string)

func (*Request) SetRetryCount

func (r *Request) SetRetryCount(tryCount int)

func (*Request) SetRetryWaitTime

func (r *Request) SetRetryWaitTime(waitTime time.Duration)

func (*Request) SetTimeout

func (r *Request) SetTimeout(timeout time.Duration)

type Response

type Response struct {
	Code int64       `json:"code"`
	Msg  string      `json:"msg"`
	Data interface{} `json:"data,omitempty"`
}

func HttpBadRequest

func HttpBadRequest(msg string) *Response

请求格式错误，比如参数格式、参数字段名等 不正确

func HttpFail

func HttpFail(msg string) *Response

请求失败

func HttpFailForCode

func HttpFailForCode(code int64, msg string) *Response

如需返回特殊错误码，调用此接口

func HttpForbidden

func HttpForbidden(msg string) *Response

用户已进行身份认证，但权限不够

func HttpNotFound

func HttpNotFound(msg string) *Response

接口不存在

func HttpServerError

func HttpServerError(msg string) *Response

服务器内部错误

func HttpSuccess

func HttpSuccess(data interface{}) *Response

请求成功

func HttpSuccessByCode

func HttpSuccessByCode(code int64, data interface{}) *Response

func HttpUnauthorized

func HttpUnauthorized(msg string) *Response

用户没有访问权限，需要进行身份认证