JSON-RPC 2.0
Golang implementation of JSON-RPC 2.0 server with generics.
Go 1.18+ required
Features:
- Batch request and responses
- WebSockets
Usage
- Create JSON-RPC 2.0 server:
s := jsonrpc2.New()
- Write handler:
Handler must have exact two arguments (context and input of any json serializable type) and exact two return values (output of any json serializable type and error)
func Multiply(ctx context.Context, args *Args) (int, error) { return args.A * args.B, nil }
- Wrap handler with
jsonrpc2.Wrapmethod and register it in server:s.Register("multiply", jsonrpc2.Wrap(Multiply))
- Use server as common http handler:
http.ListenAndServe(":8000", s)
Complete example
package main
import (
"context"
"net/http"
"github.com/neonxp/jsonrpc2"
)
func main() {
s := jsonrpc2.New()
s.Register("multiply", jsonrpc2.Wrap(Multiply)) // Register handlers
s.Register("divide", jsonrpc2.Wrap(Divide))
http.ListenAndServe(":8000", s)
}
func Multiply(ctx context.Context, args *Args) (int, error) {
//...
}
func Divide(ctx context.Context, args *Args) (*Quotient, error) {
//...
}
type Args struct {
A int `json:"a"`
B int `json:"b"`
}
type Quotient struct {
Quo int `json:"quo"`
Rem int `json:"rem"`
}
