Tutorial: Java Records - A WebFlux and Spring Data example

This repository contains all the code for the Java Records tutorial, illustrating how records can be used for building REST APIs and database queries.

Prerequisites:

• Java 14+
• Okta CLI
• Docker
• Docker Compose

Getting started

To install this example, first clone this repository:

git clone https://github.com/indiepopart/java-records.git

Configure Okta authentication

cd java-records

With OktaCLI, register for a free developer account:

okta register

Provide the required information. Once you complete the registration, create a client application with the following command:

okta apps create

You will be prompted to select the following options:

• Application name: java-records
• Type of Application: Web
• Type of Application: Okta Spring Boot Starter
• Redirect URI: Default
• Post Logout Redirect URI: Default

The OktaCLI will create the client application and configure the issuer, clientId and clientSecret in src/main/resources/application.properties. Update the issuer, client-id and client-secret in application.yml. Delete application.properties.

okta:
  oauth2:
    issuer: https://{yourOktaDomain}/oauth2/default
    client-id: {clientId}
    client-secret: {clientSecret}

Run with Docker Compose

In the project root, generate the application container image with the following Maven command:

./mvnw spring-boot:build-image

Go to the docker folder and run the services with Docker Compose:

cd docker
docker-compose up

Once the services are up, go to http://localhost:8080/mentalStateAverageDamage, and you should see the Okta login page. Sign in with your Okta credentials, and if successful, it will redirect to the /mentalStateAverageDamage endpoint, and you should see a response body like the following:

[
   {
      "mentalState":"sober",
      "damageToPlayers":604.3777777777777,
      "damageToStructures":3373.511111111111,
      "damageTaken":246.46666666666667
   },
   {
      "mentalState":"high",
      "damageToPlayers":557.547619047619,
      "damageToStructures":2953.8571428571427,
      "damageTaken":241.71428571428572
   }
]