http

Documentation

Index

• func CloneMultipartFileHeader(fh *multipart.FileHeader) *multipart.FileHeader
• func CloneMultipartForm(f *multipart.Form) *multipart.Form
• func CloneOrMakeHeader(hdr http.Header) http.Header
• func CloneURL(u *url.URL) *url.URL
• func CloneURLValues(v url.Values) url.Values
• func GetIPFromRequest(r *http.Request) (net.IP, error)
• type Client
  • func NewClient(options ...ClientOption) (*Client, error)
  • func (o *Client) ApplyOptions(options ...ClientOption) *Client
  • func (c *Client) Get(url string) ([]byte, error)
  • func (c *Client) Post(url, contentType string, headers map[string]string, body []byte) ([]byte, error)
  • func (c *Client) PostJson(url string, headers map[string]string, body []byte) ([]byte, error)
  • func (c *Client) PostJsonWithAuthorize(url string, headers map[string]string, auth func(r *http.Request) error, ...) ([]byte, error)
  • func (c *Client) PostReader(url, contentType string, headers map[string]string, ...) ([]byte, error)
• type ClientOption
  • func WithDisableKeepAlives(disableKeepAlives bool) ClientOption
  • func WithIdleConnTimeout(idleConnTimeout time.Duration) ClientOption
  • func WithLogger(l *log.Logger) ClientOption
  • func WithMaxIdleConns(maxIdleConns int) ClientOption
  • func WithResonseHeaderTimeout(responseHeaderTimeout time.Duration) ClientOption
  • func WithTimeout(timeout time.Duration) ClientOption
• type ClientOptionFunc
• type EmptyClientOption
• type EmptyHandlerChainOption
• type EmptyHandlerInterceptorOption
• type HandlerChain
  • func NewHandlerChain(opts ...HandlerChainOption) *HandlerChain
  • func (o *HandlerChain) ApplyOptions(options ...HandlerChainOption) *HandlerChain
  • func (c *HandlerChain) WrapH(next http.Handler) http.Handler
• type HandlerChainOption
• type HandlerChainOptionFunc
• type HandlerInterceptor
  • func NewHandlerInterceptor(opts ...HandlerInterceptorOption) *HandlerInterceptor
  • func (o *HandlerInterceptor) ApplyOptions(options ...HandlerInterceptorOption) *HandlerInterceptor
• type HandlerInterceptorOption
• type HandlerInterceptorOptionFunc
• type ResponseWriterWrapper
  • func NewResponseWriterWrapper(w http.ResponseWriter) *ResponseWriterWrapper
  • func (rww *ResponseWriterWrapper) Header() http.Header
  • func (rww *ResponseWriterWrapper) String() string
  • func (rww *ResponseWriterWrapper) Write(buf []byte) (int, error)
  • func (rww *ResponseWriterWrapper) WriteHeader(statusCode int)

Functions

func CloneMultipartFileHeader

func CloneMultipartFileHeader(fh *multipart.FileHeader) *multipart.FileHeader

func CloneMultipartForm

func CloneMultipartForm(f *multipart.Form) *multipart.Form

func CloneOrMakeHeader

func CloneOrMakeHeader(hdr http.Header) http.Header

CloneOrMakeHeader invokes Header.Clone but if the result is nil, it'll instead make and return a non-nil Header.

func CloneURL

func CloneURL(u *url.URL) *url.URL

func CloneURLValues

func CloneURLValues(v url.Values) url.Values

func GetIPFromRequest

func GetIPFromRequest(r *http.Request) (net.IP, error)

returns IP address from request. It will lookup IP in X-Forwarded-For and X-Real-IP headers.

Types

type Client

type Client struct {
	http.Client
	// contains filtered or unexported fields
}

func NewClient

func NewClient(options ...ClientOption) (*Client, error)

func (*Client) ApplyOptions

func (o *Client) ApplyOptions(options ...ClientOption) *Client

func (*Client) Get

func (c *Client) Get(url string) ([]byte, error)

func (*Client) Post

func (c *Client) Post(
	url, contentType string,
	headers map[string]string,
	body []byte,
) ([]byte, error)

func (*Client) PostJson

func (c *Client) PostJson(
	url string,
	headers map[string]string,
	body []byte,
) ([]byte, error)

func (*Client) PostJsonWithAuthorize

func (c *Client) PostJsonWithAuthorize(
	url string,
	headers map[string]string,
	auth func(r *http.Request) error,
	body []byte,
) ([]byte, error)

func (*Client) PostReader

func (c *Client) PostReader(
	url, contentType string,
	headers map[string]string,
	auth func(r *http.Request) error,
	body io.Reader,
) ([]byte, error)

type ClientOption

type ClientOption interface {
	// contains filtered or unexported methods
}

A ClientOption sets options.

func WithDisableKeepAlives

func WithDisableKeepAlives(disableKeepAlives bool) ClientOption

func WithIdleConnTimeout

func WithIdleConnTimeout(idleConnTimeout time.Duration) ClientOption

func WithLogger

func WithLogger(l *log.Logger) ClientOption

WithLogger

func WithMaxIdleConns

func WithMaxIdleConns(maxIdleConns int) ClientOption

func WithResonseHeaderTimeout

func WithResonseHeaderTimeout(responseHeaderTimeout time.Duration) ClientOption

func WithTimeout

func WithTimeout(timeout time.Duration) ClientOption

type ClientOptionFunc

type ClientOptionFunc func(*Client)

ClientOptionFunc wraps a function that modifies Client into an implementation of the ClientOption interface.

type EmptyClientOption

type EmptyClientOption struct{}

EmptyClientOption does not alter the configuration. It can be embedded in another structure to build custom options.

This API is EXPERIMENTAL.

type EmptyHandlerChainOption

type EmptyHandlerChainOption struct{}

EmptyHandlerChainOption does not alter the configuration. It can be embedded in another structure to build custom options.

This API is EXPERIMENTAL.

type EmptyHandlerInterceptorOption

type EmptyHandlerInterceptorOption struct{}

EmptyHandlerInterceptorOption does not alter the configuration. It can be embedded in another structure to build custom options.

This API is EXPERIMENTAL.

type HandlerChain

type HandlerChain struct {
	//invoke before http handler
	PreHandlers []func(w http.ResponseWriter, r *http.Request) error
	Handlers    []HandlerInterceptor
	//invoke after http handler
	PostHandlers []func(w http.ResponseWriter, r *http.Request)
}

func NewHandlerChain

func NewHandlerChain(opts ...HandlerChainOption) *HandlerChain

func (*HandlerChain) ApplyOptions

func (o *HandlerChain) ApplyOptions(options ...HandlerChainOption) *HandlerChain

func (*HandlerChain) WrapH

func (c *HandlerChain) WrapH(next http.Handler) http.Handler

type HandlerChainOption

type HandlerChainOption interface {
	// contains filtered or unexported methods
}

A HandlerChainOption sets options.

type HandlerChainOptionFunc

type HandlerChainOptionFunc func(*HandlerChain)

HandlerChainOptionFunc wraps a function that modifies HandlerChain into an implementation of the HandlerChainOption interface.

type HandlerInterceptor

type HandlerInterceptor struct {
	//http middleware
	Interceptor func(h http.Handler) http.Handler
}

func NewHandlerInterceptor

func NewHandlerInterceptor(opts ...HandlerInterceptorOption) *HandlerInterceptor

func (*HandlerInterceptor) ApplyOptions

func (o *HandlerInterceptor) ApplyOptions(options ...HandlerInterceptorOption) *HandlerInterceptor

type HandlerInterceptorOption

type HandlerInterceptorOption interface {
	// contains filtered or unexported methods
}

A HandlerInterceptorOption sets options.

type HandlerInterceptorOptionFunc

type HandlerInterceptorOptionFunc func(*HandlerInterceptor)

HandlerInterceptorOptionFunc wraps a function that modifies HandlerInterceptor into an implementation of the HandlerInterceptorOption interface.

type ResponseWriterWrapper

type ResponseWriterWrapper struct {
	// contains filtered or unexported fields
}

ResponseWriterWrapper

func NewResponseWriterWrapper

func NewResponseWriterWrapper(w http.ResponseWriter) *ResponseWriterWrapper

func (*ResponseWriterWrapper) Header

func (rww *ResponseWriterWrapper) Header() http.Header

Header function overwrites the http.ResponseWriter Header() function

func (*ResponseWriterWrapper) String

func (rww *ResponseWriterWrapper) String() string

String function pack respose header, http status code and body

func (*ResponseWriterWrapper) Write

func (rww *ResponseWriterWrapper) Write(buf []byte) (int, error)

func (*ResponseWriterWrapper) WriteHeader

func (rww *ResponseWriterWrapper) WriteHeader(statusCode int)

WriteHeader function overwrites the http.ResponseWriter WriteHeader() function