oktadev / native-java-examples

Native Java Apps with Micronaut, Quarkus, and Spring Boot

Native Java Examples: Micronaut, Quarkus, Spring Boot, and Helidon

This repository contains example OAuth 2.0 resource servers built with Micronaut, Quarkus, and Spring Boot. If you'd like to see how they were built, please read Build Native Java Apps with Micronaut, Quarkus, and Spring Boot.

This project also contains a Helidon example. You can read about how it was built and how it compares in Build REST APIs and Native Java Apps with Helidon.

Prerequisites: Java 17 with GraalVM, HTTPie, and Docker (optional).

• Getting Started
• Links
• Help
• License

Getting Started

First, clone this repository:

git clone https://github.com/oktadev/native-java-examples.git

You will need a JDK with GraalVM and its native-image compiler. Using SDKMAN, run the following command and set it as the default:

sdk install java 22.3.r17-grl

Next, you'll need a free Okta developer account. Install the Okta CLI and run okta register to sign up for a new account. If you already have an account, run okta login. Then, run okta apps create. Select the default app name, or change it as you see fit. Choose Single-Page App and press Enter.

Use https://oidcdebugger.com/debug for the Redirect URI and accept the default Logout Redirect URI of https://oidcdebugger.com/.

Take note of the clientId and issuer values. You'll need those to get an access token and to configure each framework for JWT authentication.

Change the following files for each framework to match your Okta domain:

• Micronaut: micronaut/src/main/resources/application.yml
• Quarkus: quarkus/src/main/resources/application.properties
• Spring Boot: spring-boot/src/main/resources/application.properties
• Helidon: helidon/src/main/resources/META-INF/microprofile-config.properties

You can start each app using Maven. Note that you will only be able to start one at a time since they all run on port 8080.

• Micronaut: ./mvnw mn:run
• Quarkus: ./mvnw quarkus:dev
• Spring Boot: ./mvnw spring-boot:run
• Helidon: mvn package && java -jar target/helidon.jar

Then, you can test them with an access token and HTTPie.

You can generate an access token using OpenID Connect Debugger. First, you must configure your application on Okta to use OpenID Connect's implicit flow.

Run okta login and open the resulting URL in your browser. Go to the Applications section and select the application you created with the CLI. Edit its General Settings and add Implicit (Hybrid) as an allowed grant type, with access token enabled. Click Save and copy the client ID for the next step.

Now, navigate to the OpenID Connect Debugger website. Fill in your client ID, and use https://{yourOktaDomain}/oauth2/default/v1/authorize for the Authorize URI. The state field must be filled but can contain any characters. Select token for the response type. Click Send Request to continue.

Once you have an access token, set it as a TOKEN environment variable in a terminal window.

TOKEN=eyJraWQiOiJYa2pXdjMzTDRBYU1ZSzNGM...

Use HTTPie to pass the JWT in as a bearer token in the Authorization header.

http :8080/hello Authorization:"Bearer $TOKEN"

You should see your email address printed to your terminal.

You can also build and run each example as a native app.

• Micronaut: ./mvnw package -Dpackaging=native-image
• Quarkus: ./mvnw package -Pnative
• Spring Boot: ./mvnw package -Pnative (if you'd rather use Docker: ./mvnw spring-boot:build-image)
• Helidon: mvn package -Pnative-image

Then, start each app as a native executable.

• Micronaut: ./target/app
• Quarkus: ./target/quarkus-1.0.0-SNAPSHOT-runner
• Spring Boot: ./target/demo (if Docker: docker run -p 8080:8080 demo:0.0.1-SNAPSHOT)
• Helidon: ./target/helidon

Please read Build Native Java Apps with Micronaut, Quarkus, and Spring Boot for performance numbers and analysis. To see how Helidon compares, see Build REST APIs and Native Java Apps with Helidon.

Links

This example uses the following open source libraries:

• Micronaut
• Quarkus
• Spring Boot
• Helidon

Help

Please post any questions as comments on this example's blog post, or on the Okta Developer Forums.

License

Apache 2.0, see LICENSE.

native-java-examples's Issues

Upgrade to Micronaut 3.5.0 and remove `clean` command

Tested it works w/o clean and it works.

Guidance for Spring Boot 3.0 GA update

Hey @mraible,

As we are about to release Spring Boot 3.0 GA, I would like to share some feedback on the Spring Boot 3 sample.

For an optimized footprint, I still recommend using the tomcat-embed-programmatic artifact with Spring Boot 3 that I contributed via #12, any chance you could you restore this optimization and related documentation in your next run? That will also avoid you to be impacted by apache/tomcat#569 expected to be fixed only in Tomcat 10.1.3 (to be probably shipped with Spring Boot 3.0.1)

This additional Buildpacks configuration is not needed anymore.

We discovered a huge memory consumption issue in Jackson 2.14, it should be fixed in Spring Boot 3 GA via FasterXML/jackson-databind#3665. We did also several optimizations in Spring Framework 6.0.1 which will be used in Spring Boot 3 GA.

This one has a smaller impact, but you can change @SpringBootApplication to @SpringBootApplication(proxyBeanMethods = false) since that will totally skip proxies even if they are now created at build-time.
https://github.com/oktadev/native-java-examples/blob/main/spring-boot/src/main/java/com/okta/rest/Application.java#L6

Spring Boot 3 GA should be released this Thursday, Nov 24th.