Go Graphql Starter

This project aims to use neelance/graphql-go to build a starter web application. This project would be continuously under development. Pull request is welcome.

RoadMap:

• Integrated with sqlx
• Integrated with graphql-go
• Use go-bindata to generate Go code from .graphql file
• Use psql
• Integrated with dataloader
• Add authentication & authorization
• Add unit test cases
• Support subscription
• Support web-socket notification and messaging

Usage:

1. Install go-bindata

   go get -u github.com/jteeuwen/go-bindata/...
   

2. Setup GOPATH

   For example: MacOS

   export GOPATH=/Users/${username}/go
   export PATH=$PATH:$GOPATH/bin
   

3. Run the following command at root directory to generate Go code from .graphql file

   go-bindata -ignore=\.go -pkg=schema -o=schema/bindata.go schema/...
   

   There would be bindata.go generated under schema folder

4. Start the server

   go build server.go
   

Graphql Example:

Test in graphiql by the following endpoint

localhost:3000

Basically there are two graphql queries and one mutation

Query:

1. Get an user by email
2. Get user list by cursor pagination

Mutation:

1. Create an user

For user list query, you need to be authenticated in order to use it. Authentication is not required for other operations.

In order to perform authentication/login, you need to create a user by graphql mutation first

Then you could submit your email and password by Basic Authorization Header with the following endpoint using POST method

localhost:3000/login

After that, you would get an access token(jwt) You can change the Authorization of request header in graphiql.html and restart the server to see the effect of authentication using token

Web-socket Example:

You could use the notificationHub to broadcast message to specific target

Demo Code:

notificationHub := ctx.Value("notificationHub").(*model.NotificationHub)
noti := &model.Notification{From: 1, To: 9, Message: "1234222"}
notificationHub.BroadcastMessage(noti)

Test:

• Run Unit Tests

  go test
  

Reference

-neelance/graphql-go

-tonyghita/graphql-go-example