restxml

Documentation

Overview

Package restxml provides RESTful XML serialization of AWS requests and responses.

Index

• Variables
• func Build(r *request.Request)
• func Unmarshal(r *request.Request)
• func UnmarshalError(r *request.Request)
• func UnmarshalMeta(r *request.Request)
• type Encoder
  • func NewEncoder(req *http.Request) *Encoder
  • func (e *Encoder) Encode() (*http.Request, io.ReadSeeker, error)
  • func (e *Encoder) SetFields(t protocol.Target, k string, m protocol.FieldMarshaler, meta protocol.Metadata)
  • func (e *Encoder) SetList(t protocol.Target, k string, fn func(le protocol.ListEncoder), ...)
  • func (e *Encoder) SetMap(t protocol.Target, k string, fn func(me protocol.MapEncoder), ...)
  • func (e *Encoder) SetStream(t protocol.Target, k string, v protocol.StreamMarshaler, ...)
  • func (e *Encoder) SetValue(t protocol.Target, k string, v protocol.ValueMarshaler, meta protocol.Metadata)

Variables

var BuildHandler = request.NamedHandler{Name: "awssdk.restxml.Build", Fn: Build}

BuildHandler is a named request handler for building restxml protocol requests

var UnmarshalErrorHandler = request.NamedHandler{Name: "awssdk.restxml.UnmarshalError", Fn: UnmarshalError}

UnmarshalErrorHandler is a named request handler for unmarshaling restxml protocol request errors

var UnmarshalHandler = request.NamedHandler{Name: "awssdk.restxml.Unmarshal", Fn: Unmarshal}

UnmarshalHandler is a named request handler for unmarshaling restxml protocol requests

var UnmarshalMetaHandler = request.NamedHandler{Name: "awssdk.restxml.UnmarshalMeta", Fn: UnmarshalMeta}

UnmarshalMetaHandler is a named request handler for unmarshaling restxml protocol request metadata

Functions

func Build

func Build(r *request.Request)

Build builds a request payload for the REST XML protocol.

func Unmarshal

func Unmarshal(r *request.Request)

Unmarshal unmarshals a payload response for the REST XML protocol.

func UnmarshalError

func UnmarshalError(r *request.Request)

UnmarshalError unmarshals a response error for the REST XML protocol.

func UnmarshalMeta

func UnmarshalMeta(r *request.Request)

UnmarshalMeta unmarshals response headers for the REST XML protocol.

Types

type Encoder

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

An Encoder provides encoding of the AWS RESTXML protocol. This encoder combindes the XML and REST encoders deligating to them for their associated targets.

It is invalid to set a XML and stream payload on the same encoder.

func NewEncoder

func NewEncoder(req *http.Request) *Encoder

NewEncoder creates a new encoder for encoding the AWS RESTXML protocol. The request passed in will be the base the path, query, and headers encoded will be set on top of.

func (*Encoder) Encode

func (e *Encoder) Encode() (*http.Request, io.ReadSeeker, error)

Encode returns the encoded request, and body payload. If no payload body was set nil will be returned. If an error occurred while encoding the API an error will be returned.

func (*Encoder) SetFields

func (e *Encoder) SetFields(t protocol.Target, k string, m protocol.FieldMarshaler, meta protocol.Metadata)

SetFields will set the nested type's fields to the body.

func (*Encoder) SetList

func (e *Encoder) SetList(t protocol.Target, k string, fn func(le protocol.ListEncoder), meta protocol.Metadata)

SetList will set the nested list values to the header, query, or body.

func (*Encoder) SetMap

func (e *Encoder) SetMap(t protocol.Target, k string, fn func(me protocol.MapEncoder), meta protocol.Metadata)

SetMap will set the nested map values to the header, query, or body.

func (*Encoder) SetStream

func (e *Encoder) SetStream(t protocol.Target, k string, v protocol.StreamMarshaler, meta protocol.Metadata)

SetStream will set the stream to the payload of the request.

func (*Encoder) SetValue

func (e *Encoder) SetValue(t protocol.Target, k string, v protocol.ValueMarshaler, meta protocol.Metadata)

SetValue will set a value to the header, path, query, or body.

If the request's method is GET all BodyTarget values will be written to the query string.