graphql-plot

A Kotlin GraphQL Client/Server architecture using Lets-Plot inside a Kotlin Multiplatform (JS) environment.

---

This version is not developed anymore in favor of a Kotlin Multiplatform version.

---

Architecture

The GraphQL server makes use of GraphQL Kotlin, which makes possible to define the GraphQL schema dynamically when building the project.

While the server is up and running, the Apollo GraphQL client can introspect the server's schema for generating all the classes which provides type safety at compile time.

While the server is developed and built upon JVM, the client is built inside a Kotlin Multiplatform environment, in particlare, it will be ported to a JS web-based application.

This application will make use of Lets-Plot Kotlin, for displaying in the browser the received data from the server.

In the simple example provided by this applicaiton, the server will generate random 2D Points every 500ms through a graphql subscription. The client that subscribes to this, can specify a number of points to collect, real-time plotting those points in a cartesian plane, and when the collections is finished, drawing a polinomial regression line upon those points collected.

Usage

First of all, run the server with:

./gradlew :server:run

You can also run the server through a docker container (so docker must be installed on the system) running:

./gradlew :server:runDocker

Once the server is started, download the schema with the following Gradle task:

./gradlew :js-app:downloadApolloSchema --endpoint='http://localhost:8080/graphql' \
--schema=./js-app/src/jsMain/resources/graphql/schema.graphqls

Then you can test out the web application using the GrapQL client with:

./gradlew :js-app:jsBrowserRun

If you're making changes to the client application, it could become handy the --continuous flag when running :js-app:jsBrowserRun task, wich let's you recompile and run automatically the web application when you save.