diff --git a/quarkus-modules/pom.xml b/quarkus-modules/pom.xml index 7036688711..d4811deef5 100644 --- a/quarkus-modules/pom.xml +++ b/quarkus-modules/pom.xml @@ -19,6 +19,7 @@ quarkus-jandex quarkus-vs-springboot quarkus-funqy + \ No newline at end of file diff --git a/quarkus-modules/quarkus-virtual-threads/.dockerignore b/quarkus-modules/quarkus-virtual-threads/.dockerignore new file mode 100644 index 0000000000..b86c7ac340 --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/.dockerignore @@ -0,0 +1,4 @@ +* +!target/*-runner +!target/*-runner.jar +!target/lib/* \ No newline at end of file diff --git a/quarkus-modules/quarkus-virtual-threads/README.md b/quarkus-modules/quarkus-virtual-threads/README.md new file mode 100644 index 0000000000..e69de29bb2 diff --git a/quarkus-modules/quarkus-virtual-threads/pom.xml b/quarkus-modules/quarkus-virtual-threads/pom.xml new file mode 100644 index 0000000000..0c40f0c80e --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/pom.xml @@ -0,0 +1,160 @@ + + + 4.0.0 + com.baeldung.quarkus + quarkus-virtual-threads + 1.0-SNAPSHOT + + + + com.baeldung + quarkus-modules + 1.0.0-SNAPSHOT + + + + + + ${quarkus.platform.group-id} + ${quarkus.platform.artifact-id} + ${quarkus.platform.version} + pom + import + + + + + + 3.11.0 + 21 + UTF-8 + UTF-8 + quarkus-bom + io.quarkus.platform + 3.4.3 + 3.0.0 + 0.3.0 + 3.6.0 + 3.11.2 + + + + + io.quarkus + quarkus-hibernate-validator + + + io.quarkus + quarkus-jdbc-postgresql + + + io.quarkus + quarkus-hibernate-orm-panache + + + io.quarkus + quarkus-resteasy-reactive-jackson + + + io.quarkus + quarkus-rest-client-reactive-jackson + + + io.quarkus + quarkus-arc + + + + io.rest-assured + rest-assured + test + + + me.escoffier.loom + loom-unit + ${loom-unit.version} + test + + + + io.quarkus + quarkus-junit5 + test + + + io.quarkus + quarkus-panache-common-deployment + ${panache-common-deployment.version} + test + + + org.mockito + mockito-core + ${mockito-core.version} + test + + + io.quarkus + quarkus-panache-mock + ${panache-common-deployment.version} + test + + + + + + + ${quarkus.platform.group-id} + quarkus-maven-plugin + ${quarkus.platform.version} + true + + + + build + generate-code + generate-code-tests + + + + + + org.apache.maven.plugins + maven-compiler-plugin + ${compiler-plugin.version} + + + -parameters + + + + + org.apache.maven.plugins + maven-surefire-plugin + ${surefire-plugin.version} + + + org.jboss.logmanager.LogManager + ${maven.home} + + + + + + + + + native + + + native + + + + native + + + + \ No newline at end of file diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.jvm b/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.jvm new file mode 100644 index 0000000000..90f0ffc1e6 --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.jvm @@ -0,0 +1,97 @@ +#### +# This Dockerfile is used in order to build a container that runs the Quarkus application in JVM mode +# +# Before building the container image run: +# +# ./mvnw package +# +# Then, build the image with: +# +# docker build -f src/main/docker/Dockerfile.jvm -t quarkus/virtual-threads-jvm . +# +# Then run the container using: +# +# docker run -i --rm -p 8080:8080 quarkus/virtual-threads-jvm +# +# If you want to include the debug port into your docker image +# you will have to expose the debug port (default 5005 being the default) like this : EXPOSE 8080 5005. +# Additionally you will have to set -e JAVA_DEBUG=true and -e JAVA_DEBUG_PORT=*:5005 +# when running the container +# +# Then run the container using : +# +# docker run -i --rm -p 8080:8080 quarkus/virtual-threads-jvm +# +# This image uses the `run-java.sh` script to run the application. +# This scripts computes the command line to execute your Java application, and +# includes memory/GC tuning. +# You can configure the behavior using the following environment properties: +# - JAVA_OPTS: JVM options passed to the `java` command (example: "-verbose:class") +# - JAVA_OPTS_APPEND: User specified Java options to be appended to generated options +# in JAVA_OPTS (example: "-Dsome.property=foo") +# - JAVA_MAX_MEM_RATIO: Is used when no `-Xmx` option is given in JAVA_OPTS. This is +# used to calculate a default maximal heap memory based on a containers restriction. +# If used in a container without any memory constraints for the container then this +# option has no effect. If there is a memory constraint then `-Xmx` is set to a ratio +# of the container available memory as set here. The default is `50` which means 50% +# of the available memory is used as an upper boundary. You can skip this mechanism by +# setting this value to `0` in which case no `-Xmx` option is added. +# - JAVA_INITIAL_MEM_RATIO: Is used when no `-Xms` option is given in JAVA_OPTS. This +# is used to calculate a default initial heap memory based on the maximum heap memory. +# If used in a container without any memory constraints for the container then this +# option has no effect. If there is a memory constraint then `-Xms` is set to a ratio +# of the `-Xmx` memory as set here. The default is `25` which means 25% of the `-Xmx` +# is used as the initial heap size. You can skip this mechanism by setting this value +# to `0` in which case no `-Xms` option is added (example: "25") +# - JAVA_MAX_INITIAL_MEM: Is used when no `-Xms` option is given in JAVA_OPTS. +# This is used to calculate the maximum value of the initial heap memory. If used in +# a container without any memory constraints for the container then this option has +# no effect. If there is a memory constraint then `-Xms` is limited to the value set +# here. The default is 4096MB which means the calculated value of `-Xms` never will +# be greater than 4096MB. The value of this variable is expressed in MB (example: "4096") +# - JAVA_DIAGNOSTICS: Set this to get some diagnostics information to standard output +# when things are happening. This option, if set to true, will set +# `-XX:+UnlockDiagnosticVMOptions`. Disabled by default (example: "true"). +# - JAVA_DEBUG: If set remote debugging will be switched on. Disabled by default (example: +# true"). +# - JAVA_DEBUG_PORT: Port used for remote debugging. Defaults to 5005 (example: "8787"). +# - CONTAINER_CORE_LIMIT: A calculated core limit as described in +# https://www.kernel.org/doc/Documentation/scheduler/sched-bwc.txt. (example: "2") +# - CONTAINER_MAX_MEMORY: Memory limit given to the container (example: "1024"). +# - GC_MIN_HEAP_FREE_RATIO: Minimum percentage of heap free after GC to avoid expansion. +# (example: "20") +# - GC_MAX_HEAP_FREE_RATIO: Maximum percentage of heap free after GC to avoid shrinking. +# (example: "40") +# - GC_TIME_RATIO: Specifies the ratio of the time spent outside the garbage collection. +# (example: "4") +# - GC_ADAPTIVE_SIZE_POLICY_WEIGHT: The weighting given to the current GC time versus +# previous GC times. (example: "90") +# - GC_METASPACE_SIZE: The initial metaspace size. (example: "20") +# - GC_MAX_METASPACE_SIZE: The maximum metaspace size. (example: "100") +# - GC_CONTAINER_OPTIONS: Specify Java GC to use. The value of this variable should +# contain the necessary JRE command-line options to specify the required GC, which +# will override the default of `-XX:+UseParallelGC` (example: -XX:+UseG1GC). +# - HTTPS_PROXY: The location of the https proxy. (example: "myuser@127.0.0.1:8080") +# - HTTP_PROXY: The location of the http proxy. (example: "myuser@127.0.0.1:8080") +# - NO_PROXY: A comma separated lists of hosts, IP addresses or domains that can be +# accessed directly. (example: "foo.example.com,bar.example.com") +# +### +FROM registry.access.redhat.com/ubi8/openjdk-21:1.18 + +ENV LANGUAGE='en_US:en' + + +# We make four distinct layers so if there are application changes the library layers can be re-used +COPY --chown=185 target/quarkus-app/lib/ /deployments/lib/ +COPY --chown=185 target/quarkus-app/*.jar /deployments/ +COPY --chown=185 target/quarkus-app/app/ /deployments/app/ +COPY --chown=185 target/quarkus-app/quarkus/ /deployments/quarkus/ + +EXPOSE 8080 +USER 185 +ENV JAVA_OPTS_APPEND="-Dquarkus.http.host=0.0.0.0 -Djava.util.logging.manager=org.jboss.logmanager.LogManager" +ENV JAVA_APP_JAR="/deployments/quarkus-run.jar" + +ENTRYPOINT [ "/opt/jboss/container/java/run/run-java.sh" ] + diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.legacy-jar b/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.legacy-jar new file mode 100644 index 0000000000..586751c951 --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.legacy-jar @@ -0,0 +1,93 @@ +#### +# This Dockerfile is used in order to build a container that runs the Quarkus application in JVM mode +# +# Before building the container image run: +# +# ./mvnw package -Dquarkus.package.type=legacy-jar +# +# Then, build the image with: +# +# docker build -f src/main/docker/Dockerfile.legacy-jar -t quarkus/virtual-threads-legacy-jar . +# +# Then run the container using: +# +# docker run -i --rm -p 8080:8080 quarkus/virtual-threads-legacy-jar +# +# If you want to include the debug port into your docker image +# you will have to expose the debug port (default 5005 being the default) like this : EXPOSE 8080 5005. +# Additionally you will have to set -e JAVA_DEBUG=true and -e JAVA_DEBUG_PORT=*:5005 +# when running the container +# +# Then run the container using : +# +# docker run -i --rm -p 8080:8080 quarkus/virtual-threads-legacy-jar +# +# This image uses the `run-java.sh` script to run the application. +# This scripts computes the command line to execute your Java application, and +# includes memory/GC tuning. +# You can configure the behavior using the following environment properties: +# - JAVA_OPTS: JVM options passed to the `java` command (example: "-verbose:class") +# - JAVA_OPTS_APPEND: User specified Java options to be appended to generated options +# in JAVA_OPTS (example: "-Dsome.property=foo") +# - JAVA_MAX_MEM_RATIO: Is used when no `-Xmx` option is given in JAVA_OPTS. This is +# used to calculate a default maximal heap memory based on a containers restriction. +# If used in a container without any memory constraints for the container then this +# option has no effect. If there is a memory constraint then `-Xmx` is set to a ratio +# of the container available memory as set here. The default is `50` which means 50% +# of the available memory is used as an upper boundary. You can skip this mechanism by +# setting this value to `0` in which case no `-Xmx` option is added. +# - JAVA_INITIAL_MEM_RATIO: Is used when no `-Xms` option is given in JAVA_OPTS. This +# is used to calculate a default initial heap memory based on the maximum heap memory. +# If used in a container without any memory constraints for the container then this +# option has no effect. If there is a memory constraint then `-Xms` is set to a ratio +# of the `-Xmx` memory as set here. The default is `25` which means 25% of the `-Xmx` +# is used as the initial heap size. You can skip this mechanism by setting this value +# to `0` in which case no `-Xms` option is added (example: "25") +# - JAVA_MAX_INITIAL_MEM: Is used when no `-Xms` option is given in JAVA_OPTS. +# This is used to calculate the maximum value of the initial heap memory. If used in +# a container without any memory constraints for the container then this option has +# no effect. If there is a memory constraint then `-Xms` is limited to the value set +# here. The default is 4096MB which means the calculated value of `-Xms` never will +# be greater than 4096MB. The value of this variable is expressed in MB (example: "4096") +# - JAVA_DIAGNOSTICS: Set this to get some diagnostics information to standard output +# when things are happening. This option, if set to true, will set +# `-XX:+UnlockDiagnosticVMOptions`. Disabled by default (example: "true"). +# - JAVA_DEBUG: If set remote debugging will be switched on. Disabled by default (example: +# true"). +# - JAVA_DEBUG_PORT: Port used for remote debugging. Defaults to 5005 (example: "8787"). +# - CONTAINER_CORE_LIMIT: A calculated core limit as described in +# https://www.kernel.org/doc/Documentation/scheduler/sched-bwc.txt. (example: "2") +# - CONTAINER_MAX_MEMORY: Memory limit given to the container (example: "1024"). +# - GC_MIN_HEAP_FREE_RATIO: Minimum percentage of heap free after GC to avoid expansion. +# (example: "20") +# - GC_MAX_HEAP_FREE_RATIO: Maximum percentage of heap free after GC to avoid shrinking. +# (example: "40") +# - GC_TIME_RATIO: Specifies the ratio of the time spent outside the garbage collection. +# (example: "4") +# - GC_ADAPTIVE_SIZE_POLICY_WEIGHT: The weighting given to the current GC time versus +# previous GC times. (example: "90") +# - GC_METASPACE_SIZE: The initial metaspace size. (example: "20") +# - GC_MAX_METASPACE_SIZE: The maximum metaspace size. (example: "100") +# - GC_CONTAINER_OPTIONS: Specify Java GC to use. The value of this variable should +# contain the necessary JRE command-line options to specify the required GC, which +# will override the default of `-XX:+UseParallelGC` (example: -XX:+UseG1GC). +# - HTTPS_PROXY: The location of the https proxy. (example: "myuser@127.0.0.1:8080") +# - HTTP_PROXY: The location of the http proxy. (example: "myuser@127.0.0.1:8080") +# - NO_PROXY: A comma separated lists of hosts, IP addresses or domains that can be +# accessed directly. (example: "foo.example.com,bar.example.com") +# +### +FROM registry.access.redhat.com/ubi8/openjdk-21:1.18 + +ENV LANGUAGE='en_US:en' + + +COPY target/lib/* /deployments/lib/ +COPY target/*-runner.jar /deployments/quarkus-run.jar + +EXPOSE 8080 +USER 185 +ENV JAVA_OPTS_APPEND="-Dquarkus.http.host=0.0.0.0 -Djava.util.logging.manager=org.jboss.logmanager.LogManager" +ENV JAVA_APP_JAR="/deployments/quarkus-run.jar" + +ENTRYPOINT [ "/opt/jboss/container/java/run/run-java.sh" ] diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.native b/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.native new file mode 100644 index 0000000000..39dc236ba1 --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.native @@ -0,0 +1,27 @@ +#### +# This Dockerfile is used in order to build a container that runs the Quarkus application in native (no JVM) mode. +# +# Before building the container image run: +# +# ./mvnw package -Dnative +# +# Then, build the image with: +# +# docker build -f src/main/docker/Dockerfile.native -t quarkus/virtual-threads . +# +# Then run the container using: +# +# docker run -i --rm -p 8080:8080 quarkus/virtual-threads +# +### +FROM registry.access.redhat.com/ubi8/ubi-minimal:8.9 +WORKDIR /work/ +RUN chown 1001 /work \ + && chmod "g+rwX" /work \ + && chown 1001:root /work +COPY --chown=1001:root target/*-runner /work/application + +EXPOSE 8080 +USER 1001 + +ENTRYPOINT ["./application", "-Dquarkus.http.host=0.0.0.0"] diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.native-micro b/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.native-micro new file mode 100644 index 0000000000..1a158f6ed3 --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/docker/Dockerfile.native-micro @@ -0,0 +1,30 @@ +#### +# This Dockerfile is used in order to build a container that runs the Quarkus application in native (no JVM) mode. +# It uses a micro base image, tuned for Quarkus native executables. +# It reduces the size of the resulting container image. +# Check https://quarkus.io/guides/quarkus-runtime-base-image for further information about this image. +# +# Before building the container image run: +# +# ./mvnw package -Dnative +# +# Then, build the image with: +# +# docker build -f src/main/docker/Dockerfile.native-micro -t quarkus/virtual-threads . +# +# Then run the container using: +# +# docker run -i --rm -p 8080:8080 quarkus/virtual-threads +# +### +FROM quay.io/quarkus/quarkus-micro-image:2.0 +WORKDIR /work/ +RUN chown 1001 /work \ + && chmod "g+rwX" /work \ + && chown 1001:root /work +COPY --chown=1001:root target/*-runner /work/application + +EXPOSE 8080 +USER 1001 + +ENTRYPOINT ["./application", "-Dquarkus.http.host=0.0.0.0"] diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/GreetingResource.java b/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/GreetingResource.java new file mode 100644 index 0000000000..0ce2e25e1f --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/GreetingResource.java @@ -0,0 +1,16 @@ +package com.baeldung.quarkus; + +import jakarta.ws.rs.GET; +import jakarta.ws.rs.Path; +import jakarta.ws.rs.Produces; +import jakarta.ws.rs.core.MediaType; + +@Path("/hello") +public class GreetingResource { + + @GET + @Produces(MediaType.TEXT_PLAIN) + public String hello() { + return "Hello from RESTEasy Reactive"; + } +} diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/rest/RemoteService.java b/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/rest/RemoteService.java new file mode 100644 index 0000000000..92896c76a2 --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/rest/RemoteService.java @@ -0,0 +1,14 @@ +package com.baeldung.quarkus.rest; + +import jakarta.ws.rs.GET; +import jakarta.ws.rs.Path; +import org.eclipse.microprofile.rest.client.inject.RegisterRestClient; + +@RegisterRestClient(configKey = "remote-service") +public interface RemoteService { + @GET + @Path("/greetings") + default String greetings(){ + return "Mocked Greeting"; + }; +} \ No newline at end of file diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/rest/VirtualThreadApp.java b/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/rest/VirtualThreadApp.java new file mode 100644 index 0000000000..f0e84ca34c --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/java/com/baeldung/quarkus/rest/VirtualThreadApp.java @@ -0,0 +1,16 @@ +package com.baeldung.quarkus.rest; + +import io.smallrye.common.annotation.RunOnVirtualThread; +import jakarta.ws.rs.GET; +import jakarta.ws.rs.Path; +import org.eclipse.microprofile.rest.client.inject.RestClient; + +@Path("/greetings") +public class VirtualThreadApp { + @RestClient RemoteService service; + @GET @RunOnVirtualThread + public String process() { + var response = service.greetings(); + return response.toUpperCase(); + } +} \ No newline at end of file diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/resources/META-INF/resources/index.html b/quarkus-modules/quarkus-virtual-threads/src/main/resources/META-INF/resources/index.html new file mode 100644 index 0000000000..f68b9f696a --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/resources/META-INF/resources/index.html @@ -0,0 +1,279 @@ + + + + + quarkus-virtual-threads - 1.0.0-SNAPSHOT + + + +
+
+
+ + + + + quarkus_logo_horizontal_rgb_1280px_reverse + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
+

You just made a Quarkus application.

+

This page is served by Quarkus.

+ Visit the Dev UI +

This page: src/main/resources/META-INF/resources/index.html

+

App configuration: src/main/resources/application.properties

+

Static assets: src/main/resources/META-INF/resources/

+

Code: src/main/java

+

Generated starter code:

+
    +
  • + RESTEasy Reactive Easily start your Reactive RESTful Web Services +
    › @Path: /hello +
    › Related guide +
    • + +
+
+
+
Documentation
+

Practical step-by-step guides to help you achieve a specific goal. Use them to help get your work + done.

+
Set up your IDE
+

Everyone has a favorite IDE they like to use to code. Learn how to configure yours to maximize your + Quarkus productivity.

+
+
+
+ + diff --git a/quarkus-modules/quarkus-virtual-threads/src/main/resources/application.properties b/quarkus-modules/quarkus-virtual-threads/src/main/resources/application.properties new file mode 100644 index 0000000000..b9c09044a1 --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/main/resources/application.properties @@ -0,0 +1 @@ +remote-service/mp-rest/url=http://localhost:8080 \ No newline at end of file diff --git a/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/GreetingResource.java b/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/GreetingResource.java new file mode 100644 index 0000000000..0ce2e25e1f --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/GreetingResource.java @@ -0,0 +1,16 @@ +package com.baeldung.quarkus; + +import jakarta.ws.rs.GET; +import jakarta.ws.rs.Path; +import jakarta.ws.rs.Produces; +import jakarta.ws.rs.core.MediaType; + +@Path("/hello") +public class GreetingResource { + + @GET + @Produces(MediaType.TEXT_PLAIN) + public String hello() { + return "Hello from RESTEasy Reactive"; + } +} diff --git a/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/rest/RemoteService.java b/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/rest/RemoteService.java new file mode 100644 index 0000000000..92896c76a2 --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/rest/RemoteService.java @@ -0,0 +1,14 @@ +package com.baeldung.quarkus.rest; + +import jakarta.ws.rs.GET; +import jakarta.ws.rs.Path; +import org.eclipse.microprofile.rest.client.inject.RegisterRestClient; + +@RegisterRestClient(configKey = "remote-service") +public interface RemoteService { + @GET + @Path("/greetings") + default String greetings(){ + return "Mocked Greeting"; + }; +} \ No newline at end of file diff --git a/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/rest/VirtualThreadApp.java b/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/rest/VirtualThreadApp.java new file mode 100644 index 0000000000..f0e84ca34c --- /dev/null +++ b/quarkus-modules/quarkus-virtual-threads/src/test/java/com/baeldung/quarkus/rest/VirtualThreadApp.java @@ -0,0 +1,16 @@ +package com.baeldung.quarkus.rest; + +import io.smallrye.common.annotation.RunOnVirtualThread; +import jakarta.ws.rs.GET; +import jakarta.ws.rs.Path; +import org.eclipse.microprofile.rest.client.inject.RestClient; + +@Path("/greetings") +public class VirtualThreadApp { + @RestClient RemoteService service; + @GET @RunOnVirtualThread + public String process() { + var response = service.greetings(); + return response.toUpperCase(); + } +} \ No newline at end of file