Java Records - A WebFlux and Spring Data Example

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

Please read Java Records: A WebFlux and Spring Data Example to see how it was created.

Prerequisites:

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

Okta has Authentication and User Management APIs that reduce development time with instant-on, scalable user infrastructure. Okta's intuitive API and expert support make it easy for developers to authenticate, manage, and secure users and roles in any application.

• Getting Started
• Links
• Help
• License

Getting started

To install this example, first clone this repository:

git clone https://github.com/oktadev/okta-java-records-example.git

Configure Okta authentication

cd java-records

Using the Okta CLI, 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 Okta CLI 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
   }
]

Links

This example uses the following open source libraries:

• Open JDK
• Okta Spring Boot Starter
• Spring Boot
• Spring Data
• MongoDB

Help

Please post any questions as comments on the blog post, or visit our Okta Developer Forums.

License

Apache 2.0, see LICENSE.