jsonrpc2

type Client ¶

type Client struct {
	*rpc.Client
	// contains filtered or unexported fields
}

Client represents a JSON RPC 2.0 Client. There may be multiple outstanding Calls associated with a single Client, and a Client may be used by multiple goroutines simultaneously.

It also provides all methods of net/rpc Client.

func Dial(network, address string) (*Client, error)

func NewClient(conn io.ReadWriteCloser) *Client

func NewClientWithCodec(codec rpc.ClientCodec) *Client

func NewCustomHTTPClient(url string, doer Doer) *Client

func NewHTTPClient(url string) *Client

func (c Client) Notify(serviceMethod string, args interface{}) error

type Ctx ¶

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

Ctx can be embedded into your struct with RPC method parameters (if that method parameters type is a struct) to make it implement WithContext interface and thus have access to request context.

func (c *Ctx) Context() context.Context

func (c *Ctx) SetContext(ctx context.Context)

type Doer ¶

type Doer interface {
	Do(req *http.Request) (resp *http.Response, err error)
}

Doer is an interface for doing HTTP requests.

type DoerFunc ¶

type DoerFunc func(req *http.Request) (resp *http.Response, err error)

The DoerFunc type is an adapter to allow the use of ordinary functions as HTTP clients. If f is a function with the appropriate signature, DoerFunc(f) is a client that calls f.

func (f DoerFunc) Do(req *http.Request) (resp *http.Response, err error)

type Error ¶

type Error struct {
	Code    int         `json:"code"`
	Message string      `json:"message"`
	Data    interface{} `json:"data,omitempty"`
}

Error represent JSON-RPC 2.0 "Error object".

func NewError(code int, message string) *Error

func ServerError(rpcerr error) *Error

func (e *Error) Error() string

type WithContext ¶

type WithContext interface {
	Context() context.Context
	SetContext(ctx context.Context)
}

WithContext is an interface which should be implemented by RPC method parameters type if you need access to request context in RPC method.

Request context will be same as was provided to corresponding ServeConnContext/NewServerCodecContext or context.Background otherwise.