xmlrpc

Documentation

Overview

Package xmlrpc provide an implementation of XML-RPC specification, http://xmlrpc.com/spec.md.

Index

• type Client
  • func NewClient(url *url.URL, timeout time.Duration) (client *Client, err error)
  • func (cl *Client) Close() (err error)
  • func (cl *Client) Send(req Request) (resp Response, err error)
• type Kind
• type Member
  • func (m Member) String() string
• type Request
  • func NewRequest(methodName string, params []interface{}) (req Request, err error)
  • func (req Request) MarshalText() (out []byte, err error)
• type Response
  • func (resp *Response) UnmarshalText(text []byte) (err error)
• type Value
  • func NewValue(in interface{}) (out *Value)
  • func (v Value) GetFieldAsFloat(key string) float64
  • func (v Value) GetFieldAsInteger(key string) int32
  • func (v Value) GetFieldAsString(key string) string
  • func (v Value) String() string

Types

type Client

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

Client for XML-RPC.

func NewClient

func NewClient(url *url.URL, timeout time.Duration) (client *Client, err error)

NewClient create and initialize new connection to RPC server.

func (*Client) Close

func (cl *Client) Close() (err error)

Close the client connection.

func (*Client) Send

func (cl *Client) Send(req Request) (resp Response, err error)

Send the RPC method with parameters to the server.

type Kind

type Kind int

Kind define the known type in Value.

This is looks like the reflect.Kind but limited only to specific types defined in XML-RPC.

const (
	Unset    Kind = iota
	String        // represent Go string type.
	Boolean       // represent Go bool type.
	Integer       // represent Go int8, int16, int32, uint8, and uint16 types.
	Double        // represent Go int64, uint8, uint16, uint32, uint64, float32, and float64 types.
	DateTime      // represent Go time.Time type.
	Base64        // represent Go string type.
	Struct        // represent Go struct type.
	Array         // represent Go array and slice types.
)

type Member

type Member struct {
	Name  string
	Value Value
}

Member represent member element, as sub-item of struct element.

func (Member) String

func (m Member) String() string

type Request

type Request struct {
	MethodName string
	Params     []Value
}

func NewRequest

func NewRequest(methodName string, params []interface{}) (req Request, err error)

NewRequest create and initialize new request.

func (Request) MarshalText

func (req Request) MarshalText() (out []byte, err error)

MarshalText implement the encoding.TextMarshaler interface.

type Response

type Response struct {
	Param        Value
	FaultMessage string
	FaultCode    int32
	IsFault      bool
}

func (*Response) UnmarshalText

func (resp *Response) UnmarshalText(text []byte) (err error)

type Value

type Value struct {
	Kind Kind
	// In contains scalar value for Base64, Boolean, Double, Integer,
	// String, and DateTime.
	// It would be nil for Kind of Array and Struct.
	In      interface{}
	Members []Member // List of struct's member.
	Values  []Value  // List of array's items.
}

Value represent dynamic value of XML-RPC type.

func NewValue

func NewValue(in interface{}) (out *Value)

NewValue convert Go type data into XML-RPC value.

func (Value) GetFieldAsFloat

func (v Value) GetFieldAsFloat(key string) float64

GetFieldAsFloat get struct's field value by name as float64.

func (Value) GetFieldAsInteger

func (v Value) GetFieldAsInteger(key string) int32

GetFieldAsInteger get struct's field value by name as int32.

func (Value) GetFieldAsString

func (v Value) GetFieldAsString(key string) string

GetFieldAsString get struct's field value by name as string.

func (Value) String

func (v Value) String() string