Reactive Graphql

Simple Spring WebFlux Project (see Help.md) with:

• Classic Annotation Based REST
• WebFlux.Fn / coRouter REST

• Moved from graphql-kotlin to spring-graphql
• For graphql-kotlin impl. with Spring Boot 2.x.x use #811dcc2

Kotlin

This project uses ktlint

ktlint

• brew install ktlint
• ktlint --apply-to-idea or ktlint --apply-to-idea-project
• ktlint --install-git-pre-commit-hook
• ktlint -F "src/**/*.kt" "*.kts"

Build & Run

• Open build.gradle.kts with IntelliJ
• Run Application via IntelliJ or ./gradlew bootRun

Graphql

• graphql Endpoints
  • graphql
  • graphiql
  • subscription
  • schema

Use graphiql to execute queries and browse schema or js-graphql

Query

#default value
query default {
  hello {
    greeting
    time
  }
}
#with input
query rob {
  hello(name: "Rob") {
    greeting
    time
  }
}

Note The following examples are not migrated from graphql-kotlin yet, for working examples use #811dcc2

• Partial Results / Errors

query hello {
  hello(name: "Rob") {
    greeting
  }
  partialBroken {
    greeting
  }
}

Subscription

subscription {
  hello(name: "Rob") {
    greeting
    time
  }
}

Employee Example

subscription employees {
  employees {
    firstName
    team {
      name
    }
  }
}

mutation newEmployee {
  newEmployee(
    newEmployee: { firstName: "Tim", lastName: "Test", teamName: "Dev" }
  ) {
    firstName
    team {
      employees {
        firstName
      }
    }
  }
}

REST

• OpenAPI v3 API
• Swagger-ui

API

• Annotation based:
  • GET Hello (Default)
  • GET Hello (Custom)
  • GET Hello (SSE)
• Functional:
  • GET Hello (Default)

GitHub

• Dependabot

Actions

• self-approving Dependabot PRs

CI / CD

• GitHub Actions + ArgoCD

CI GitHub Actions

• See Releases for current released versions
• See Packages for current published helm chart as OCI

CD ArgoCD

• See Deployments
• See Cluster Repo
• To deploy, change the version in the argocd repo and create a PR (you can also manually change the version in argocd for testing (!)):
• services/graphql-reactive