Implementation of XMLRPC protocol in Go language.
xmlrpc is an implementation of client side part of XMLRPC protocol in Go language.
This project is in minimal maintenance mode with no further development. Bug fixes are accepted, but it might take some time until they will be merged.
To install xmlrpc package run
go get github.com/kolo/xmlrpc. To use it in application add
"github.com/kolo/xmlrpc"string to
importstatement.
client, _ := xmlrpc.NewClient("https://bugzilla.mozilla.org/xmlrpc.cgi", nil) result := struct{ Version string `xmlrpc:"version"` }{} client.Call("Bugzilla.version", nil, &result) fmt.Printf("Version: %s\n", result.Version) // Version: 4.2.7+
Second argument of NewClient function is an object that implements http.RoundTripper interface, it can be used to get more control over connection options. By default it initialized by http.DefaultTransport object.
xmlrpc package supports encoding of native Go data types to method arguments.
Data types encoding rules:
Structs encoded to struct by following rules:
",omitempty", empty values are omitted;
Server method can accept few arguments, to handle this case there is special approach to handle slice of empty interfaces (
[]interface{}). Each value of such slice encoded as separate argument.
Result of remote function is decoded to native Go data type.
Data types decoding rules:
xmlrpc package contains clientCodec type, that implements rpc.ClientCodec interface of net/rpc package.
xmlrpc package works over HTTP protocol, but some internal functions and data type were made public to make it easier to create another implementation of xmlrpc that works over another protocol. To encode request body there is EncodeMethodCall function. To decode server response Response data type can be used.
See project status.
Dmitry Maksimov ([email protected])