http

Nov 14, 2023

Changes in this version

+ const WarnDisconnectedOperation

+ const WarnHeuristicExpiration

+ const WarnMiscellaneousPersistentWarning

+ const WarnMiscellaneousWarning

+ const WarnResponseIsStale

+ const WarnRevalidationFailed

+ const WarnTransformationApplied

+ func WarnText(code int) string

+ type Warn struct

+ Agent string

+ Date time.Time

+ Warn string

+ WarnCode int

+ func (r Warn) String() string

+ func (r Warn) Write(w io.Writer) error

Aug 17, 2023

Changes in this version

+ func NewRecordResponseWriter(rw http.ResponseWriter) http.ResponseWriter

Jan 5, 2023

Changes in this version

+ var DefaultClientWithDynamicHost = &http.Client

+ var DefaultClientWithDynamicHostAndProxy = &http.Client

+ var DefaultTransportWithDynamicHost = RoundTripperWithTarget(http.DefaultTransport)

+ var DefaultTransportWithDynamicHostAndProxy = RoundTripperWithTarget(DefaultTransportWithDynamicProxy)

+ func HostFuncFromContext(req *http.Request) error

+ func RequestWithHostTarget(req *http.Request, target *httphost.Host) *http.Request

type Client

+ Host *httphost.Host

Dec 6, 2022

Changes in this version

+ var DefaultClientWithDynamicProxy = &http.Client

+ var DefaultTransportWithDynamicProxy http.RoundTripper = &http.Transport

+ func ProxyFuncFromContextOrEnvironment(req *http.Request) (*url.URL, error)

+ func RequestWithProxyTarget(req *http.Request, proxy *httpproxy.Proxy) *http.Request

type Client

+ Proxy *httpproxy.Proxy

+ Target string

May 27, 2022

Changes in this version

type Client

+ func NewClientWithProxy(proxyUrl string, proxyTarget string) *Client

type DoWithBackoffOption

+ func WithDoWithBackoffOptionTarget(target string) DoWithBackoffOption

Apr 21, 2022

Changes in this version

+ type HandlerDecorator interface

+ WrapHandler func(rt http.Handler) http.Handler

+ type HandlerDecorators []HandlerDecorator

+ func (chain HandlerDecorators) WrapHandler(next http.Handler) http.Handler

+ type RoundTripDecorator interface

+ WrapRoundTrip func(rt http.RoundTripper) http.RoundTripper

+ type RoundTripDecorators []RoundTripDecorator

+ func (chain RoundTripDecorators) WrapRoundTrip(next http.RoundTripper) http.RoundTripper

Apr 11, 2022

Changes in this version

+ var DefaultCipherSuites = []uint16

+ var DefaultClientDoRetryHandler = func(req *http.Request, retry int) (*http.Response, error)

+ var DefaultCurvePreferences = []tls.CurveID

+ var DefaultIdleTimeout = 120 * time.Second

+ var DefaultMinVersion uint16 = tls.VersionTLS12

+ var DefaultReadTimeout = 5 * time.Second

+ var DefaultTransportDoRetryHandler = func(req *http.Request, retry int) (*http.Response, error)

+ var DefaultWriteTimeout = 10 * time.Second

+ var DefaultXRequestIDKey = "X-Request-ID"

+ var ErrBodyNotRewindable = errors.New("body not rewindable")

+ var Methods = []string

+ func BodyRewindableWithFile(file *os.File) (body io.ReadCloser, getBody func() (io.ReadCloser, error), err error)

+ func BodyRewindableWithFilePosition(name string, offset int64, whence int) (body io.ReadCloser, getBody func() (io.ReadCloser, error), err error)

+ func ClientIP(req *http.Request) string

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

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

+ func CloneOrMakeHeader(hdr http.Header) http.Header

+ func CloneTLSConfig(cfg *tls.Config) *tls.Config

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

+ func CloneURLValues(v url.Values) url.Values

+ func ContentType(r io.Reader, name string) (ctype string, bufferedContent io.Reader, err error)

+ func DoJson(httpReq *http.Request, req, resp interface{}) error

+ func DoJsonWithBackoff(httpReq *http.Request, req, resp interface{}, opts ...DoWithBackoffOption) error

+ func DoWithBackoff(httpReq *http.Request, opts ...DoWithBackoffOption) (*http.Response, error)

+ func DoesRequestSatisfyTlsTermination(r *http.Request, whitelistedPaths []string, allowedTLSCIDRs []string) error

+ func FromHTTPContext(r *http.Request, keys ...interface{}) string

+ func Get(url string) (resp *http.Response, err error)

+ func GetProxySchemeAndHost(r *http.Request, allowForwarded bool) (scheme, host string)

+ func GetWithBackoff(ctx context.Context, url string, opts ...DoWithBackoffOption) (*http.Response, error)

+ func Head(url string) (resp *http.Response, err error)

+ func HeadWithBackoff(ctx context.Context, url string, opts ...DoWithBackoffOption) (*http.Response, error)

+ func Post(url, contentType string, body io.Reader) (resp *http.Response, err error)

+ func PostForm(url string, data url.Values) (resp *http.Response, err error)

+ func PostFormWithBackoff(ctx context.Context, url string, data url.Values, opts ...DoWithBackoffOption) (resp *http.Response, err error)

+ func PostWithBackoff(ctx context.Context, url, contentType string, body io.Reader, ...) (resp *http.Response, err error)

+ func ProxyFuncWithTargetOrDefault(target string, def func(req *http.Request) (*url.URL, error)) func(req *http.Request) (*url.URL, error)

+ func PutWithBackoff(ctx context.Context, url, contentType string, body io.Reader, ...) (resp *http.Response, err error)

+ func Recover(writer io.Writer, req *http.Request, ...) interface

+ func RecoveryServerInterceptor(next http.Handler, out io.Writer, ...) http.Handler

+ func RejectInsecureServerInterceptor(next http.Handler, opts ...RejectInsecureOption) *rejectInsecure

+ func ReplaceHttpRequestBody(req *http.Request, body io.Reader)

+ func ReplacePath(path string, h http.Handler) http.Handler

+ func RequestIDFromContext(ctx context.Context) string

+ func RequestRewindableWithFileName(name string) (body io.ReadCloser, getBody func() (io.ReadCloser, error), err error)

+ func RequestWithBodyRewindable(req *http.Request) error

+ func RequestWithTarget(req *http.Request, target string, replaceHostInRequest bool) error

+ func ResolveProxyUrl(u *url.URL, r *http.Request, allowForwarded bool) *url.URL

+ func RetryAfter(resp *http.Response, err error, defaultBackoff time.Duration) (backoff time.Duration, retry bool)

+ func RoundTripperWithBackoff(rt http.RoundTripper, opts ...DoWithBackoffOption) http.RoundTripper

+ func RoundTripperWithTarget(rt http.RoundTripper, target string, replaceHostInRequest bool) http.RoundTripper

+ func ServeContent(w http.ResponseWriter, r *http.Request, name string, modtime time.Time, ...)

+ func ServerWithDefaults(srv *http.Server) *http.Server

+ func SetInOutMetadata(ctx context.Context, w http.ResponseWriter, r *http.Request, requestID string) context.Context

+ func TransportWithProxyTarget(t *http.Transport, target string) *http.Transport

+ type Client struct

+ func NewClient(u, target string, targetAsProxy bool) (*Client, error)

+ func NewClientWithTarget(target string, targetAsProxy bool) *Client

+ func NewClientWithUnixDisableCompression(u string) (*Client, error)

+ func (c *Client) Do(req *http.Request) (*http.Response, error)

+ func (c *Client) Get(url string) (resp *http.Response, err error)

+ func (c *Client) Head(url string) (resp *http.Response, err error)

+ func (c *Client) Post(url string, contentType string, body io.Reader) (resp *http.Response, err error)

+ func (c *Client) PostForm(url string, data url.Values) (resp *http.Response, err error)

+ func (c *Client) Use(h ...RoundTripHandler) *Client

+ type ClientInterceptor func(req *http.Request, retry int, invoker ClientInvoker, ...) (resp *http.Response, err error)

+ type ClientInvoker func(req *http.Request, retry int) (*http.Response, error)

+ type DoRetryHandler = ClientInvoker

+ type DoWithBackoffOption interface

+ func WithDoWithBackoffOptionChainUnaryInterceptor(interceptors ...ClientInterceptor) DoWithBackoffOption

+ func WithDoWithBackoffOptionDoRetryHandler(f DoRetryHandler) DoWithBackoffOption

+ func WithDoWithBackoffOptionExponentialBackOffOption(opts ...time_.ExponentialBackOffOption) DoWithBackoffOption

+ func WithDoWithBackoffOptionGrpcBackOff(retries int) DoWithBackoffOption

+ func WithDoWithBackoffOptionMaxRetries(retries int) DoWithBackoffOption

+ func WithDoWithBackoffOptionProxy(proxyUsed string, targetAsProxy bool) DoWithBackoffOption

+ func WithDoWithBackoffOptionRetryAfter(f RetryAfterHandler) DoWithBackoffOption

+ func WithDoWithBackoffOptionRoundTripper(rt http.RoundTripper) DoWithBackoffOption

+ type DoWithBackoffOptionFunc func(*doWithBackoff)

+ type EmptyDoWithBackoffOption struct

+ type EmptyHandlerInterceptorChainOption struct

+ type EmptyRejectInsecureOption struct

+ type HandlerInterceptorChain struct

+ func NewHandlerInterceptorChain(opts ...HandlerInterceptorChainOption) *HandlerInterceptorChain

+ func (chain HandlerInterceptorChain) InjectHttpHandler(next http.Handler) http.Handler

+ func (o *HandlerInterceptorChain) ApplyOptions(options ...HandlerInterceptorChainOption) *HandlerInterceptorChain

+ type HandlerInterceptorChainOption interface

+ func WithHandlerInterceptor(preHandle func(w http.ResponseWriter, r *http.Request) error, ...) HandlerInterceptorChainOption

+ type HandlerInterceptorChainOptionFunc func(*HandlerInterceptorChain)

+ type RejectInsecureOption interface

+ func RejectInsecureWithAllowedTlsCidrs(allowedTLSCIDRs []string) RejectInsecureOption

+ func RejectInsecureWithErrorLog(l *log.Logger) RejectInsecureOption

+ func RejectInsecureWithForceHttp(forceHttp bool) RejectInsecureOption

+ func RejectInsecureWithWhitelistedPaths(whitelistedPaths []string) RejectInsecureOption

+ type RejectInsecureOptionFunc func(*rejectInsecure)

+ type RetryAfterHandler func(resp *http.Response, err error, defaultBackoff time.Duration) (backoff time.Duration, retry bool)

+ type RoundTripFunc func(req *http.Request) (resp *http.Response, err error)

+ func (f RoundTripFunc) RoundTrip(req *http.Request) (resp *http.Response, err error)

+ type RoundTripHandler = http.RoundTripper

+ func RecoveryClientInterceptor(next RoundTripHandler, out io.Writer, ...) RoundTripHandler

+ type Transport struct

+ Base http.RoundTripper

+ func (t *Transport) Abort()

+ func (t *Transport) CancelRequest(req *http.Request)

+ func (t *Transport) IsAborted() bool

+ func (t *Transport) Next(req *http.Request) (resp *http.Response, err error)

+ func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)

+ func (t *Transport) Use(h ...RoundTripHandler) *Transport