go-hpc
HPC is a Gorilla RPC v2 Codec that allows you to perform RPC-like requests using the pathname for the service and method, leaving the bodies for requests and responses.
This differs from JSON-RPC which uses a JSON body envelope. This package also hides the "Go-isms" by transforming snake-case to camel-case, for example "/files/list_all" would invoke Files.ListAll().
Example
Service:
package hpc_test
import (
"log"
"net/http"
"strings"
"github.com/gorilla/rpc/v2"
"github.com/tj/go-hpc"
)
type Users struct {
users []string
}
type ListInput struct {
Prefix string `json:"prefix"`
}
type ListOutput struct {
Names []string `json:"names"`
}
func (u *Users) List(r *http.Request, in *ListInput, out *ListOutput) error {
out.Names = []string{}
for _, name := range u.users {
if strings.HasPrefix(name, in.Prefix) {
out.Names = append(out.Names, name)
}
}
return nil
}
func Example() {
users := []string{"Tobi", "Loki", "Jane"}
r := rpc.NewServer()
r.RegisterCodec(hpc.NewCodec(), "application/json")
r.RegisterService(&Users{users}, "")
http.Handle("/", r)
log.Fatalln(http.ListenAndServe(":3000", nil))
}Request:
$ curl -d '{ "prefix": "T" }' -H "Content-Type: application/json" http://localhost:3000/users/list
{
"names": ["Tobi"]
}
License
MIT