akka-http-graphql

License	MIT
Categories	Akka Container Microservices Reactive libraries
GroupId	com.github.sebruck
ArtifactId	akka-http-graphql_2.12
Last Version	0.2.0
Release Date	Dec 8, 2019
Type	jar
Description	akka-http-graphql akka-http-graphql
Project URL	https://github.com/Sebruck/akka-http-graphql/
Project Organization	sebruck
Source Code Management	https://github.com/Sebruck/akka-http-graphql/

Download akka-http-graphql_2.12

Filename	Size
akka-http-graphql_2.12-0.2.0.pom
akka-http-graphql_2.12-0.2.0.jar	24 KB
akka-http-graphql_2.12-0.2.0-sources.jar	3 KB
akka-http-graphql_2.12-0.2.0-javadoc.jar	1 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.sebruck/akka-http-graphql_2.12/ -->
<dependency>
    <groupId>com.github.sebruck</groupId>
    <artifactId>akka-http-graphql_2.12</artifactId>
    <version>0.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.sebruck/akka-http-graphql_2.12/
implementation 'com.github.sebruck:akka-http-graphql_2.12:0.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.sebruck/akka-http-graphql_2.12/
implementation ("com.github.sebruck:akka-http-graphql_2.12:0.2.0")

Apache Buildr

'com.github.sebruck:akka-http-graphql_2.12:jar:0.2.0'

Apache Ivy

<dependency org="com.github.sebruck" name="akka-http-graphql_2.12" rev="0.2.0">
  <artifact name="akka-http-graphql_2.12" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.sebruck', module='akka-http-graphql_2.12', version='0.2.0')
)

Scala SBT

libraryDependencies += "com.github.sebruck" % "akka-http-graphql_2.12" % "0.2.0"

Leiningen

[com.github.sebruck/akka-http-graphql_2.12 "0.2.0"]

Dependencies

compile (10)

Group / Artifact	Type	Version
org.scala-lang : scala-library	jar	2.12.10
com.typesafe.akka : akka-http_2.12	jar	10.1.11
de.heikoseeberger : akka-http-circe_2.12	jar	1.29.1
io.circe : circe-core_2.12	jar	0.12.3
io.circe : circe-generic_2.12	jar	0.12.3
io.circe : circe-parser_2.12	jar	0.12.3
io.circe : circe-optics_2.12	jar	0.12.0
org.sangria-graphql : sangria_2.12	jar	2.0.0-M1
org.sangria-graphql : sangria-circe_2.12	jar	1.3.0
org.sangria-graphql : sangria-slowlog_2.12	jar	2.0.0-M1

test (3)

Group / Artifact	Type	Version
org.scalatest : scalatest_2.12	jar	3.1.0
com.typesafe.akka : akka-http-testkit_2.12	jar	10.1.11
com.typesafe.akka : akka-stream-testkit_2.12	jar	2.6.1

Project Modules

There are no modules declared in this project.

Akka HTTP ➕ Sangria GraphQL ➕ circe ＝ 💖

This library allows to easily create a Sangria GraphQL server based on Akka HTTP and circe.

Supported Scala Versions

The library is published for scala 2.12 and 2.13.

Features

• executing GraphQL queries via GET & POST
• Anti CORS measures:
  • Decline mutations via GET
  • POST requests accept only content types application/json and application/graphql
• Serve playground.html (if configured) on GET with Accepts: text/html

Usage

Add the following dependency to your sbt project

"com.github.sebruck" %% "akka-http-graphql" % "0.2.0"

  import akka.actor.ActorSystem
  import akka.http.scaladsl.Http
  import akka.stream.ActorMaterializer
  import com.sebruck.akka.http.graphql.GraphEndpoint
  import sangria.execution.deferred.DeferredResolver
  import sangria.schema._

  import scala.concurrent.ExecutionContextExecutor
  import scala.util.{Failure, Success}

  implicit val actorSystem: ActorSystem     = ActorSystem()
  implicit val mat: ActorMaterializer       = ActorMaterializer()
  implicit val ec: ExecutionContextExecutor = actorSystem.dispatcher

  // Define Schema
  val Query = ObjectType(
    "Query",
    fields[Unit, Unit](
      Field("test", StringType, resolve = _ => "Hello!")
    )
  )

  val MySchema = Schema(Query)

  // Initialise Akka Http Endpoint
  val endpoint = GraphEndpoint(schema = MySchema,
                               context = (),
                               deferredResolver = DeferredResolver.empty,
                               graphQLPath = "graphql",
                               graphQLPlaygroundResourcePath = Some("playground.html"))

  // Start server
  Http().bindAndHandle(endpoint.route, "127.0.0.1", 8080).onComplete {
    case Success(binding) =>
      println(s"Bound to $binding")
    case Failure(exception) => throw exception
  }

If you have the GraphQL Playground in your resources directory, you can now open http://localhost:8080/graphql in your browser and play with your freshly created GraphQL API!

Contributing

Contributions are very welcome!

Versions

Version
0.2.0 Dec 8, 2019
0.1.1 Nov 21, 2019
0.1.0 Oct 25, 2019