Procedure

1. Open the generated pom.xml file and review the contents.

   The Maven Surefire plugin, maven-surefire-plugin, runs unit tests during the test phase of the build lifecycle when Quarkus enables the test profile. The plugin generates text and XML test reports.

   <plugin>
       <artifactId>maven-surefire-plugin</artifactId>
       <version>${surefire-plugin.version}</version>
       <configuration>
          <argLine>@{argLine}</argLine>
          <systemPropertyVariables>
            <java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager>
            <maven.home>${maven.home}</maven.home>
          </systemPropertyVariables>
       </configuration>
   </plugin>

   Copy code to clipboard

    

   Note the values of the following properties:

   • The java.util.logging.manager system property is set to ensure that your application uses the correct log manager for the test.
   • The maven.home property is automatically replaced by the location of the Maven home directory.

2. Edit the src/test/java/org/acme/quickstart/GreetingResourceTest.java file to match the following content:

   package org.acme.quickstart;
   
   import io.quarkus.test.junit.QuarkusTest;
   import org.junit.jupiter.api.Test;
   
   import java.util.UUID;
   
   import static io.restassured.RestAssured.given;
   import static org.hamcrest.CoreMatchers.is;
   
   @QuarkusTest
   public class GreetingResourceTest {
   
       @Test
       public void testHelloEndpoint() {
           given()
             .when().get("/hello")
             .then()
                .statusCode(200)
                .body(is("Hello from Quarkus REST"));
       }
   
       @Test
       public void testGreetingEndpoint() {
           String uuid = UUID.randomUUID().toString();
           given()
             .pathParam("name", uuid)
             .when().get("/hello/greeting/{name}")
             .then()
               .statusCode(200)
               .body(is("hello " + uuid));
       }
   
   }

   Copy code to clipboard

    

   Note

   By using the QuarkusTest runner, you instruct JUnit to start the application before starting the tests.

3. Run the tests in one of the following ways:

   • Using Apache Maven:

     mvn test

     Copy code to clipboard

      

   • Using Quarkus CLI:

     quarkus test

     Copy code to clipboard

      

   • Using the Maven wrapper:

     ./mvnw test

     Copy code to clipboard

      

     By default, tests run on port 8081 so they do not conflict with the running application. In Quarkus, the RestAssured dependency is configured to use this port.

     Note

     If you want to use a different client, use the @TestHTTPResource annotation to directly inject the URL of the tested application into a field in the Test class. This field can be of type String, URL, or URI. You can also enter the test path in the @TestHTTPResource annotation. For example, to test a resource exposed to /foo, add the following lines to your test:

     @TestHTTPResource("/foo")
     URL testUrl;

     Copy code to clipboard
4. If necessary, specify the test port in the quarkus.http.test-port configuration property.

Procedure

1. Start your Quarkus application.

   • If you created your Getting Started project by using the This content is not included.code.quarkus.redhat.com application or the Quarkus CLI, the Maven wrapper is provided when you generate the project. Enter the following command from your project directory:

     ./mvnw quarkus:dev

     Copy code to clipboard

      

   • If you created your Getting Started project by using Apache Maven, which is installed on your machine, you can also choose the following command:

     mvn quarkus:dev

     Copy code to clipboard

      

   • If you are running continuous testing in dev mode and are using the Quarkus CLI, enter the following command:

     quarkus dev

     Copy code to clipboard

      

2. View details of the testing status in the generated output log.

   Note

   To view the output log, you might need to scroll to the bottom of the screen.

   • When continuous testing is enabled, the following message is displayed:

     Press [e] to edit command line args (currently ''), [r] to re-run, [o] Toggle test output, [:] for the terminal, [h] for more options>

     Copy code to clipboard

      

   • When continuous testing is paused, the following message is displayed:

     Press [e] to edit command line args (currently ''), [r] to resume testing, [o] Toggle test output, [:] for the terminal, [h] for more options>

     Copy code to clipboard

      

     Note

     By default, when continuous testing is enabled, testing is paused after you start the application. To view the keyboard commands that are available for controlling how you run your tests, see Commands for controlling continuous testing.

3. To start running the tests, press r on your keyboard.

4. View the updated output log to monitor the test status and test results, check test statistics, and get guidance for follow-up actions. For example:

   All 2 tests are passing (0 skipped), 2 tests were run in 2094ms. Tests completed at 14:45:11.
   Press [e] to edit command line args (currently ''), [r] to re-run, [o] Toggle test output, [:] for the terminal, [h] for more options>

   Copy code to clipboard

    

Verification

1. Make a code change. For example, in a text editor, open the src/main/java/org/acme/quickstart/GreetingsResource.java file.

2. Change the "hello" endpoint to return "Hello world" and save the file.

   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 world";
       }
   }

   Copy code to clipboard

    

3. Verify that Quarkus immediately re-runs the test to test the changed code.

4. View the output log to check the test results. In this example, the test checks whether the changed string contains the value "Hello from Quarkus REST". The test fails because the string was changed to "Hello world".

   2025-09-26 11:05:45,911 ERROR [io.qua.test] (Test runner thread) Test GreetingResourceTest#testHelloEndpoint() failed: java.lang.AssertionError: 1 expectation failed.
   Response body doesn't match expectation.
   Expected: is "Hello from Quarkus REST"
     Actual: Hello world
           at io.restassured.internal.ValidatableResponseOptionsImpl.body(ValidatableResponseOptionsImpl.java:238)
           at org.acme.quickstart.GreetingResourceTest.testHelloEndpoint(GreetingResourceTest.java:20)
   --
   1 test failed (1 passing, 0 skipped), 2 tests were run in 2076ms. Tests completed at 15:03:45.
   Press [e] to edit command line args (currently ''), [r] to re-run, [o] Toggle test output, [:] for the terminal, [h] for more options>

   Copy code to clipboard

    

5. To exit continuous testing, press Ctrl-C or q on your keyboard.