This provides GraphQL routing via http (queries/mutations only), and via the Atom-based WebSocket protocol (all). This project will probably become a part of the Clue project, which provides a GraphQL client for the above protocols.
libraryDependencies += "edu.gemini" %% "lucuma-graphql-routes-sangria" % <version> // Sangria libraryDependencies += "edu.gemini" %% "lucuma-graphql-routes-grackle" % <version> // Grackle
HttpRoutes provided by this library will delegate GraphQL operation to a
GraphQLService which is computed on a per-request basis. This allows the application to select a different schema based on credentials in the request, for example.
So first, write a method that constructs a
GraphQLService based on the incoming
Authorization header (if any).
def mkService(auth: Option[Authorization]): F[Option[GraphQLService[F]]] = // Yield None to deny access (403 Forbidden), or a GraphQLService if it's // ok to service the request.
There are two constructors for
GraphQLService, depending on the back end you're using.
new SangriaGraphQLService[F](mySchema, userData, exceptionHandler) // Sangria new GrackleGraphQLService[F](myMapping) // Grackle
Next construct the
HttpRoutes, passing the method defined above.
Routes.forService(mkService) // HttpRoutes[F]
HttpRoutes will serve the following endpoints:
Root / "graphql"using the Serving over HTTP specification.
Root / "ws"using the GraphQL over WebSocket Protocol specification.
Root / "playground.html"serving the GraphQL Playground HTML application.
"playground.html" segments are defaults; you can specify different values when you call