An implementation of GraphQL in Go. Follows the official reference implementation graphql-js.
Supports: queries, mutations & subscriptions.
godoc: https://godoc.org/github.com/graphql-go/graphql
To install the library, run:
go get github.com/graphql-go/graphqlThe following is a simple example which defines a schema with a single hello string-type field and a Resolve method which returns the string world. A GraphQL query is performed against this schema with the resulting output printed in JSON format.
package main
import (
"encoding/json""fmt""log""github.com/graphql-go/graphql"
)
funcmain() {
// Schemafields:= graphql.Fields{
"hello": &graphql.Field{
Type: graphql.String,
Resolve: func(p graphql.ResolveParams) (interface{}, error) {
return"world", nil
},
},
}
rootQuery:= graphql.ObjectConfig{Name: "RootQuery", Fields: fields}
schemaConfig:= graphql.SchemaConfig{Query: graphql.NewObject(rootQuery)}
schema, err:=graphql.NewSchema(schemaConfig)
iferr!=nil {
log.Fatalf("failed to create new schema, error: %v", err)
}
// Queryquery:=` { hello } `params:= graphql.Params{Schema: schema, RequestString: query}
r:=graphql.Do(params)
iflen(r.Errors) >0 {
log.Fatalf("failed to execute graphql operation, errors: %+v", r.Errors)
}
rJSON, _:=json.Marshal(r)
fmt.Printf("%s \n", rJSON) // {"data":{"hello":"world"}}
}For more complex examples, refer to the examples/ directory and graphql_test.go.
| Name | Author | Description |
|---|---|---|
| graphql-go-handler | Hafiz Ismail | Middleware to handle GraphQL queries through HTTP requests. |
| graphql-relay-go | Hafiz Ismail | Lib to construct a graphql-go server supporting react-relay. |
| golang-relay-starter-kit | Hafiz Ismail | Barebones starting point for a Relay application with Golang GraphQL server. |
| dataloader | Nick Randall | DataLoader implementation in Go. |