http

Mar 16, 2025

Changes in this version

+ const DefaultErrorHandlerName

+ const ErrDscAssert

+ const ErrDscIO

+ const ErrDscParseMime

+ const ErrDscRegexp

+ const ErrPkg

+ const ErrTypeChain

+ const ErrTypeErrHandler

+ const ErrTypeMime

+ var ErrBadGateway error = NewHTTPError(nil, http.StatusBadGateway)

+ var ErrBadRequest error = NewHTTPError(nil, http.StatusBadRequest)

+ var ErrConflict error = NewHTTPError(nil, http.StatusConflict)

+ var ErrForbidden error = NewHTTPError(nil, http.StatusForbidden)

+ var ErrGatewayTimeout error = NewHTTPError(nil, http.StatusGatewayTimeout)

+ var ErrGone error = NewHTTPError(nil, http.StatusGone)

+ var ErrInternalServerError error = NewHTTPError(nil, http.StatusInternalServerError)

+ var ErrLengthRequired error = NewHTTPError(nil, http.StatusLengthRequired)

+ var ErrLoggingOnly error = NewHTTPError(nil, -1)

+ var ErrMethodNotAllowed error = NewHTTPError(nil, http.StatusMethodNotAllowed)

+ var ErrNotAcceptable error = NewHTTPError(nil, http.StatusNotAcceptable)

+ var ErrNotFound error = NewHTTPError(nil, http.StatusNotFound)

+ var ErrNotImplemented error = NewHTTPError(nil, http.StatusNotImplemented)

+ var ErrPaymentRequired error = NewHTTPError(nil, http.StatusPaymentRequired)

+ var ErrPreconditionFailed error = NewHTTPError(nil, http.StatusPreconditionFailed)

+ var ErrProxyAuthRequired error = NewHTTPError(nil, http.StatusProxyAuthRequired)

+ var ErrRequestEntityTooLarge error = NewHTTPError(nil, http.StatusRequestEntityTooLarge)

+ var ErrRequestHeaderFieldsTooLarge error = NewHTTPError(nil, http.StatusRequestHeaderFieldsTooLarge)

+ var ErrRequestTimeout error = NewHTTPError(nil, http.StatusRequestTimeout)

+ var ErrRequestURITooLong error = NewHTTPError(nil, http.StatusRequestURITooLong)

+ var ErrServiceUnavailable error = NewHTTPError(nil, http.StatusServiceUnavailable)

+ var ErrTooManyRequests error = NewHTTPError(nil, http.StatusTooManyRequests)

+ var ErrUnauthorized error = NewHTTPError(nil, http.StatusUnauthorized)

+ var ErrUnsupportedMediaType error = NewHTTPError(nil, http.StatusUnsupportedMediaType)

+ var HTTPMethods = map[v1.HTTPMethod]string

+ func ContextWithPreProxyHook(ctx context.Context, h func(r *http.Request) error) context.Context

+ func ContextWithProxyHeader(ctx context.Context, h http.Header) context.Context

+ func CookieNames(cks []*http.Cookie) []string

+ func DeleteCookie(w http.ResponseWriter, cookieNames []string, prefix string)

+ func ErrorHandler(a api.API[*api.Request, *api.Response], ref *k.Reference) (core.ErrorHandler, error)

+ func GetCookie(key string, cks []*http.Cookie) string

+ func GlobalErrorHandler(name string) core.ErrorHandler

+ func Handler(a api.API[*api.Request, *api.Response], spec *v1.HTTPHandlerSpec) (methods []string, patterns []string, h http.Handler, err error)

+ func Methods(methods []v1.HTTPMethod) []string

+ func MiddlewareChain(middleware []core.Middleware, terminator http.Handler) http.Handler

+ func PreProxyHookFromContext(ctx context.Context) []func(r *http.Request) error

+ func ProxyHeaderFromContext(ctx context.Context) http.Header

+ func SetCookie(w http.ResponseWriter, cookieNames []string, c core.CookieCreator, ...)

+ func SetGlobalErrorHandler(name string, handler core.ErrorHandler)

+ func TripperwareChain(tripperware []core.Tripperware, terminator http.RoundTripper) http.RoundTripper

+ type CookieCreator struct

+ Domain string

+ ExpiresIn time.Duration

+ HTTPOnly bool

+ MaxAge int

+ Name string

+ Path string

+ SameSite http.SameSite

+ Secure bool

+ Value string

+ func DefaultCookieCreator() *CookieCreator

+ func NewCookieCreator(spec *v1.CookieSpec) *CookieCreator

+ func (c *CookieCreator) NewCookie() *http.Cookie

+ type DefaultErrorHandler struct

+ LG log.Logger

+ Msgs []*ErrorMessage

+ StackAlways bool

+ func (h *DefaultErrorHandler) ServeHTTPError(w http.ResponseWriter, r *http.Request, err error)

+ type ErrorElem struct

+ Code string

+ Detail string

+ Message string

+ XMLName xml.Name

+ type ErrorElems struct

+ Errors []*ErrorElem

+ Status int

+ StatusText string

+ XMLName xml.Name

+ type ErrorMessage struct

+ func NewErrorMessage(spec *v1.ErrorMessageSpec) (*ErrorMessage, error)

+ func (m *ErrorMessage) Content(accept string) *MIMEContent

+ func (m *ErrorMessage) Match(code, kind string, msg []byte) bool

+ type HTTPError struct

+ func NewHTTPError(err error, status int) *HTTPError

+ func (e *HTTPError) AddError(err *ErrorElem)

+ func (e *HTTPError) Content(accept string) (string, []byte)

+ func (e *HTTPError) Error() string

+ func (e *HTTPError) Header() http.Header

+ func (e *HTTPError) StatusCode() int

+ func (e *HTTPError) Unwrap() error

+ type HandlerBase struct

+ AcceptMethods []string

+ AcceptPatterns []string

+ func (h *HandlerBase) Methods() []string

+ func (h *HandlerBase) Patterns() []string

+ type MIMEContent struct

+ Header http.Header

+ MIMEType string

+ StatusCode int

+ func NewMIMEContent(spec *v1.MIMEContentSpec) (*MIMEContent, error)

+ type WrappedWriter struct

+ func (w *WrappedWriter) ContentLength() int64

+ func (w *WrappedWriter) Flush()

+ func (w *WrappedWriter) StatusCode() int

+ func (w *WrappedWriter) Unwrap() http.ResponseWriter

+ func (w *WrappedWriter) Write(b []byte) (int, error)

+ func (w *WrappedWriter) WriteHeader(statusCode int)

+ func (w *WrappedWriter) Written() bool

+ type Writer interface

+ ContentLength func() int64

+ StatusCode func() int

+ Written func() bool

+ func WrapWriter(w http.ResponseWriter) Writer