Chapter 4. Testing an application deployed on JBoss EAP

Procedure

1. Define the following properties in the pom.xml configuration file:

   <properties>
       ...
       <version.plugin.failsafe>3.2.2</version.plugin.failsafe>
   </properties>

   Copy to Clipboard

2. Add the dependency required for tests.

   <project>
       ...
       <dependencies>
           ...
           <dependency>
              <groupId>junit</groupId>
              <artifactId>junit</artifactId>
              <scope>test</scope>
           </dependency>
       </dependencies>
   </project>

   Copy to Clipboard

3. Define a profile to add the plug-ins required for integration tests.

   <project>
       ...
       <profiles>
       ...
           <profile>
               <id>integration-testing</id>
               <build>
                   <plugins>
                       <plugin>
                           <groupId>org.apache.maven.plugins</groupId>
                           <artifactId>maven-failsafe-plugin</artifactId> 

   1

   
                           <version>${version.plugin.failsafe}</version>
                           <configuration>
                               <includes>
                                   <include>**/HelloWorldServletIT</include>       

   2

   
                               </includes>
                           </configuration>
                           <executions>
                               <execution>
                                  <goals>
                                      <goal>integration-test</goal>
                                      <goal>verify</goal>
                                  </goals>
                               </execution>
                           </executions>
                       </plugin>
                   </plugins>
               </build>
           </profile>
       </profiles>
   </project>

   Copy to Clipboard

   1

   Maven plug-in for running integration tests.

   2

   The name of the Java class that tests the application.

Procedure

1. Navigate to the <application_home> directory.

2. Create a directory to store the test class.

   $ mkdir -p src/test/java/org/jboss/as/quickstarts/helloworld

   Copy to Clipboard

3. Navigate to the new directory.

   $ cd src/test/java/org/jboss/as/quickstarts/helloworld

   Copy to Clipboard

4. Create a Java class HelloWorldServletIT.java that tests the deployment.

   package org.jboss.as.quickstarts.helloworld;
   
   import org.junit.Test;
   import java.io.IOException;
   import java.net.URI;
   import java.net.URISyntaxException;
   import java.net.http.HttpClient;
   import java.net.http.HttpRequest;
   import java.net.http.HttpResponse;
   import java.time.Duration;
   import static org.junit.Assert.assertEquals;
   
   public class HelloWorldServletIT {
   
       private static final String DEFAULT_SERVER_HOST = "http://localhost:8080/helloworld";                

   1

   
   
       @Test
       public void testHTTPEndpointIsAvailable() throws IOException, InterruptedException, URISyntaxException {
           String serverHost = System.getProperty("server.host");
           if (serverHost == null) {
               serverHost = DEFAULT_SERVER_HOST;
           }
           final HttpRequest request = HttpRequest.newBuilder()
                   .uri(new URI(serverHost+"/HelloWorld"))
                   .GET()
                   .build();                                                                                 

   2

   
           final HttpClient client = HttpClient.newBuilder()
                   .followRedirects(HttpClient.Redirect.ALWAYS)
                   .connectTimeout(Duration.ofMinutes(1))
                   .build();                                                                                 

   3

   
           final HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); 

   4

   
           assertEquals(200, response.statusCode());                                                         

   5

   
       }
   }

   Copy to Clipboard

   1

   The URL at which the application is running. This value is used if sever.host is undefined.

   2

   Create an HttpRequest instance for the application URI.

   3

   Create an HttpClient to send requests to and receive response from the application.

   4

   Get response from the application.

   5

   Test that the response revieved from the application is "200" indicating that the application is rechable.

Procedure

1. Navigate to the <application_home> directory.

2. Run the integration test by using the verify command with the integration-testing profile.

   $ mvn verify -Pintegration-testing

   Copy to Clipboard

   Example output

   [INFO]
   [INFO] Results:
   [INFO]
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
   [INFO]
   [INFO]
   [INFO] --- maven-failsafe-plugin:3.2.2:verify (default) @ helloworld ---
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  9.982 s
   [INFO] Finished at: 2023-11-22T14:53:54+05:30
   [INFO] ------------------------------------------------------------------------

   Copy to Clipboard

Procedure

1. Push the changes to your Git repository.
2. Navigate to the <application_home> directory.

3. Run the test by using the verify command, activating the integration-testing profile and specifying the URL to the application.

   $ mvn verify -Pintegration-testing -Dserver.host=https://$(oc get route helloworld --template='{{ .spec.host }}')

   Copy to Clipboard
   Note

   The tests use SSL/TLS to connect to the deployed application. Therefore, you need the certificates to be trusted by the machine the tests are run from.

   To trust the certificates, you must add it to a Java trust store.

   Example

   $ keytool -trustcacerts -keystore _<path-to-java-truststore>_ -storepass _<trust-store-password>_ -importcert -alias _<alias-for-the-certificate>_ -file _<path-to-certificate>_/_<certificate-name>_

   Copy to Clipboard

   Example output

   [INFO] Running org.jboss.as.quickstarts.helloworld.HelloWorldServletIT
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.345 s -- in org.jboss.as.quickstarts.helloworld.HelloWorldServletIT
   [INFO]
   [INFO] Results:
   [INFO]
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
   [INFO]
   [INFO]
   [INFO] --- maven-failsafe-plugin:3.2.2:verify (default) @ helloworld ---
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  2.984 s
   [INFO] Finished at: 2023-11-30T15:51:22+05:30
   [INFO] ------------------------------------------------------------------------

   Copy to Clipboard