httpencoding: vimagination.zapto.org/httpencoding Index | Files

package httpencoding

import "vimagination.zapto.org/httpencoding"

Package httpencoding provides a function to deal with the Accept-Encoding header.

Index

Package Files

encoding.go

func ClearEncoding Uses

func ClearEncoding(r *http.Request)

ClearEncoding removes the Accept-Encoding header so that any further attempts to establish an encoding will simply used the default, plain text, encoding.

Useful when you don't want a handler down the chain to also handle encoding

func HandleEncoding Uses

func HandleEncoding(r *http.Request, h Handler) bool

HandleEncoding will process the Accept-Encoding header and calls the given handler for each encoding until the handler returns true.

This function returns true when the Handler returns true, false otherwise

For the identity (plain text) encoding the encoding string will be the empty string.

The wildcard encoding (*) is currently treated as identity when there is no independent identity encoding specified; otherwise, it is ignored.

func InvalidEncoding Uses

func InvalidEncoding(w http.ResponseWriter)

InvalidEncoding writes the 406 header

type Encoding Uses

type Encoding string

Encoding represents an encoding string as used by the client. Examples are gzip, br and deflate.

type Handler Uses

type Handler interface {
    Handle(encoding Encoding) bool
}

Handler provides an interface to handle an encoding.

The encoding string (e.g. gzip, br, deflate) is passed to the handler, which is expected to return true if no more encodings are required and false otherwise.

The empty string "" is used to signify the identity encoding, or plain text

type HandlerFunc Uses

type HandlerFunc func(Encoding) bool

HandlerFunc wraps a func to make it satisfy the Handler interface

func (HandlerFunc) Handle Uses

func (h HandlerFunc) Handle(e Encoding) bool

Handle calls the underlying func

Package httpencoding imports 4 packages (graph) and is imported by 2 packages. Updated 2020-04-06. Refresh now. Tools for package owners.