Package: github.com/aws/aws-sdk-go/private/protocol/xml/xmlutil

package xmlutil Import Path github.com/aws/aws-sdk-go/private/protocol/xml/xmlutil (on go.dev) Dependency Relation imports 12 packages, and imported by one package

Involved Source Files d➜ build.go Package xmlutil provides XML serialization of AWS requests and responses. sort.go unmarshal.go xml_to_struct.go

Package-Level Type Names (total 3, in which 1 are exported)

/* sort exporteds by: alphabet | popularity */

type XMLNode (struct) A XMLNode contains the values to be encoded or decoded. Fields (total 6, in which 4 are exported) Attr []xml.Attr Children map[string][]*XMLNode Name xml.Name Text string /* 2 unexporteds ... *//* 2 unexporteds: */ namespaces map[string]string parent *XMLNode Methods (total 3, in which 1 are exported) (*T) AddChild(child *XMLNode) AddChild adds child to the XMLNode. /* 2 unexporteds ... *//* 2 unexporteds: */ (*T) findElem(name string) (string, bool) (*T) findNamespaces() As Outputs Of (at least 2, both are exported) func NewXMLElement(name xml.Name) *XMLNode func XMLToStruct(d *xml.Decoder, s *xml.StartElement) (*XMLNode, error) As Inputs Of (at least 8, in which 2 are exported) func StructToXML(e *xml.Encoder, node *XMLNode, sorted bool) error func (*XMLNode).AddChild(child *XMLNode) /* 6+ unexporteds ... *//* 6+ unexporteds: */ func parse(r reflect.Value, node *XMLNode, tag reflect.StructTag) error func parseList(r reflect.Value, node *XMLNode, tag reflect.StructTag) error func parseMap(r reflect.Value, node *XMLNode, tag reflect.StructTag) error func parseMapEntry(r reflect.Value, node *XMLNode, tag reflect.StructTag) error func parseScalar(r reflect.Value, node *XMLNode, tag reflect.StructTag) error func parseStruct(r reflect.Value, node *XMLNode, tag reflect.StructTag) error

/* 2 unexporteds ... *//* 2 unexporteds: */

type xmlAttrSlice ([]T) Methods (total 3, all are exported) ( T) Len() int ( T) Less(i, j int) bool ( T) Swap(i, j int) Implements (at least 2, in which 1 are exported) T : sort.Interface /* at least one unexported ... *//* at least one unexported: */ T : github.com/aws/aws-sdk-go/aws/corehandlers.lener

type xmlBuilder (struct) A xmlBuilder serializes values from Go code to XML Fields (total 2, neither is exported) /* 2 unexporteds ... *//* 2 unexporteds: */ encoder *xml.Encoder namespaces map[string]string Methods (total 5, none are exported) /* 5 unexporteds ... *//* 5 unexporteds: */ (*T) buildList(value reflect.Value, current *XMLNode, tag reflect.StructTag) error buildList adds the value's list items to the current XMLNode as children nodes. All nested values in the list are converted to XMLNodes also. (*T) buildMap(value reflect.Value, current *XMLNode, tag reflect.StructTag) error buildMap adds the value's key/value pairs to the current XMLNode as children nodes. All nested values in the map are converted to XMLNodes also. Error will be returned if it is unable to build the map's values into XMLNodes (*T) buildScalar(value reflect.Value, current *XMLNode, tag reflect.StructTag) error buildScalar will convert the value into a string and append it as a attribute or child of the current XMLNode. The value will be added as an attribute if tag contains a "xmlAttribute" attribute value. Error will be returned if the value type is unsupported. (*T) buildStruct(value reflect.Value, current *XMLNode, tag reflect.StructTag) error buildStruct adds a struct and its fields to the current XMLNode. All fields and any nested types are converted to XMLNodes also. (*T) buildValue(value reflect.Value, current *XMLNode, tag reflect.StructTag) error buildValue generic XMLNode builder for any type. Will build value for their specific type struct, list, map, scalar. Also takes a "type" tag value to set what type a value should be converted to XMLNode as. If type is not provided reflect will be used to determine the value's type.

Package-Level Functions (total 14, in which 6 are exported)

func BuildXML(params interface{}, e *xml.Encoder) error BuildXML will serialize params into an xml.Encoder. Error will be returned if the serialization of any of the params or nested values fails.

func NewXMLElement(name xml.Name) *XMLNode NewXMLElement returns a pointer to a new XMLNode initialized to default values.

func StructToXML(e *xml.Encoder, node *XMLNode, sorted bool) error StructToXML writes an XMLNode to a xml.Encoder as tokens.

func UnmarshalXML(v interface{}, d *xml.Decoder, wrapper string) error UnmarshalXML deserializes an xml.Decoder into the container v. V needs to match the shape of the XML expected to be decoded. If the shape doesn't match unmarshaling will fail.

func UnmarshalXMLError(v interface{}, stream io.Reader) error UnmarshalXMLError unmarshals the XML error from the stream into the value type specified. The value must be a pointer. If the message fails to unmarshal, the message content will be included in the returned error as a awserr.UnmarshalError.

func XMLToStruct(d *xml.Decoder, s *xml.StartElement) (*XMLNode, error) XMLToStruct converts a xml.Decoder stream to XMLNode with nested values.

/* 8 unexporteds ... *//* 8 unexporteds: */

func buildXML(params interface{}, e *xml.Encoder, sorted bool) error

func elemOf(value reflect.Value) reflect.Value Returns the reflection element of a value, if it is a pointer.

func parse(r reflect.Value, node *XMLNode, tag reflect.StructTag) error parse deserializes any value from the XMLNode. The type tag is used to infer the type, or reflect will be used to determine the type from r.

func parseList(r reflect.Value, node *XMLNode, tag reflect.StructTag) error parseList deserializes a list of values from an XML node. Each list entry will also be deserialized.

func parseMap(r reflect.Value, node *XMLNode, tag reflect.StructTag) error parseMap deserializes a map from an XMLNode. The direct children of the XMLNode will also be deserialized as map entries.

func parseMapEntry(r reflect.Value, node *XMLNode, tag reflect.StructTag) error parseMapEntry deserializes a map entry from a XML node.

func parseScalar(r reflect.Value, node *XMLNode, tag reflect.StructTag) error parseScaller deserializes an XMLNode value into a concrete type based on the interface type of r. Error is returned if the deserialization fails due to invalid type conversion, or unsupported interface type.

func parseStruct(r reflect.Value, node *XMLNode, tag reflect.StructTag) error parseStruct deserializes a structure and its fields from an XMLNode. Any nested types in the structure will also be deserialized.