encoding

Documentation

Index

• Variables
• type Codec
• type Codecs
  • func (c *Codecs) Register(codec Codec)
• type Decoder
  • func ContentTypeDecoder(r io.Reader, contentTypeHeader string, codecs Codecs) Decoder
• type EditMode
• type Encoder
  • func AcceptEncoder(w http.ResponseWriter, acceptHeader string, edit EditMode, codecs Codecs) Encoder

Variables

var ErrNoEncoderAvailable = errors.New("codec not available")

ErrNoEncoderAvailable communicates that a codec is not available.

Types

type Codec

type Codec struct {
	NewEncoder func(w io.Writer) Encoder
	NewDecoder func(r io.Reader) Decoder
	MimeTypes  []string
}

Codec combines an encoder, a decoder and a list of mime types.

type Codecs

type Codecs struct {
	Codecs           map[string]Codec
	OrderedMimeTypes []string
}

Codecs is a registry of codecs usually related to a route option.

func (*Codecs) Register

func (c *Codecs) Register(codec Codec)

Register registers a new codec to the codec registry.

type Decoder

type Decoder interface {
	// Decode decodes encoded value from the input stream into v.
	Decode(v interface{}) error
}

Decoder decodes encoded value from a input stream.

func ContentTypeDecoder

func ContentTypeDecoder(r io.Reader, contentTypeHeader string, codecs Codecs) Decoder

ContentTypeDecoder decodes the encoded data from r based on the Content-Type header value and the codecs that are available. If no codec is found, it falls back to JSON. FIXME: use another fallback, maybe an error is better

type EditMode

type EditMode bool

EditMode allows to select an editable version of a codec. eg. HTML Forms for HTML codec

const (
	// EditOff indicates that the data is requested as read-only data.
	EditOff EditMode = false

	// EditOn indicates that the data is requested as editable data.
	EditOn EditMode = true
)

type Encoder

type Encoder interface {
	// Encode writes the codec data of v to the output stream.
	Encode(v interface{}) error
}

Encoder writes encoded value to an output stream.

func AcceptEncoder

func AcceptEncoder(w http.ResponseWriter, acceptHeader string, edit EditMode, codecs Codecs) Encoder

AcceptEncoder creates an new encoder for w based on the acceptHeader, the edit mode and the codecs that are available.