Beispiel: Unit-Test der Webschicht mit Maven und Arquillian Drone

Inhalt:

Arquillian Drone

Änderungen am Servlet

 
        printWriter.write("Volume = <span name=\"volume\">" + dblVolume + "</span>, Surface = <span name=\"surface\">" + dblSurface + "</span>\r\n" + "<br><br><br>\r\n");

Code des Tests

Analog zum Beispiel "Unit-Test mit Maven und Arquillian" wird hier ein Integrationstest verwendet. D.h. im Webprojekt wird im Unterverzeichnis "src\test" die Klasse de.hsrm.cs.javaee8.statelessmaven.web.test.ServletIT (der Zusatz "IT" markiert sie als Integrationstest) zugefügt:


Sie hat diesen Code:

package de.hsrm.cs.javaee8.statelessmaven.web.test;

import java.net.URL;

import org.jboss.arquillian.container.test.api.RunAsClient;
import org.jboss.arquillian.drone.api.annotation.Drone;
import org.jboss.arquillian.junit.Arquillian;
import org.jboss.arquillian.test.api.ArquillianResource;
import org.junit.Assert;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;

@RunWith(Arquillian.class)
@RunAsClient
public class ServletIT
{
    @Deployment
    public static Archive<?> getEarArchive()
    {
       ...
    }

    @Drone
    private WebDriver browser;
    
    @ArquillianResource()
    private URL deploymentUrl;

    @Test
    public final void browserTest() throws Exception
    {
        System.out.println("Testing client website ... " + deploymentUrl);
        
        //Zur Startseite navigieren:
        browser.get(deploymentUrl.toString() + "servlet/GeometricModelServlet");
        
        //Formular ausfüllen:
        browser.findElement(By.name("a")).sendKeys("7");
        browser.findElement(By.name("b")).sendKeys("8");
        browser.findElement(By.name("c")).sendKeys("9");
        //Formular abschicken:
        browser.findElement(By.name("submit")).click();

        //Ergebnisse auswerten:
        String volume = browser.findElement(By.name("volume")).getText();
        Assert.assertEquals("504.0", volume);
        
        String surface = browser.findElement(By.name("surface")).getText();
        Assert.assertEquals("382.0", surface);
    }
}

Im Detail:

• Die Testklasse erhält zusätzlich die Annotation org.jboss.arquillian.container.test.api.RunAsClient: diese bewirkt, dass die Tests dieser Klasse nicht im Server-Container ausgeführt werden, sondern auf Clientseite.
  
  
• Das Erzeugen des Deployment ist identisch zum Beispiel "Unit-Test mit Maven und Arquillian" und ist deshalb hier nicht enthalten.
  
  
• Der Test greift über einen org.openqa.selenium.WebDriver auf die HTML-Seiten des Servers zu. Eine Instanz dieser Klasse ist als Variable der Testklasse definiert und wird über die Annotation @org.jboss.arquillian.drone.api.annotation.Drone von Arquillian Drone injiziert.
  
  
• Das Servlet wird über browser.get(...) aufgerufen. Hier könnte man die URL des Servlets hartcodiert eintragen:
  

        browser.get("http://localhost:8080/StatelessMaven-web/servlet/GeometricModelServlet");

  
  Besser ist es, die Root-URL der Anwendung von Arquillian injizieren zu lassen. Dazu ist als Klassenmembervariable "deploymentUrl" definiert:
  

      @ArquillianResource()
      private URL deploymentUrl;

  Die Annotation @org.jboss.arquillian.test.api.ArquillianResource sorgt dafür, dass Arquillian die Context Root der Anwendung injiziert, also "http://localhost:8080/StatelessMaven-web", siehe https://arquillian.org/arquillian-core/#arquillian-resource-injection.
  Jetzt kann man so auf das Servlet zugreifen:
  

        browser.get(deploymentUrl.toString() + "servlet/GeometricModelServlet");

  
  
• Nach Aufrufen der Servlet-Startseite wird das Formular ausgefüllt: die Eingabefelder namens "a", "b", "c" werden bestückt und das Formular durch Klick auf den Button "submit" abgeschickt. Die jeweiligen Elemente werden durch Aufruf der Methode "findElement" gefunden. Als Parameter wird eine Instanz der Klasse org.openqa.selenium.By übergeben, mittels der ein HTML-Element z.B. anhand des Namens (Methode name) oder der ID (Methode id) aufgefunden werden kann.
  In ein Eingabefeld können Werte über sendKeys geschrieben werden.
  Der Submit-Button (und damit das Senden des Formulars zum Server) wird durch die Methode "click" ausgelöst.
  
  
• Jetzt navigiert der Browser zur Ergebnisseite. Hier werden die Ergebnisse ausgelesen:

        String volume = browser.findElement(By.name("volume")).getText();

  Ein org.junit.Assert vergleicht die errechneten Werte mit dem erwarteten Wert.
  

	<dependencies>
		...
		<dependency>
			<groupId>org.jboss.arquillian.extension</groupId>
			<artifactId>arquillian-drone-webdriver-depchain</artifactId>
			<type>pom</type>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<dependencyManagement>
		<dependencies>
			...
			
			<dependency>
				<groupId>org.jboss.arquillian.extension</groupId>
				<artifactId>arquillian-drone-bom</artifactId>
				<version>2.5.2</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>
        
		</dependencies>
	</dependencyManagement>

Ausführen des Tests

Ausführen mit Java 17

Typ des verwendeten Browsers

Jan. 16, 2022 12:23:49 NACHM. org.jboss.arquillian.drone.webdriver.factory.AbstractWebDriverFactory createConfiguration
INFO: Property "browser" was not specified, using default value of htmlunit

<arquillian ...>
	<extension qualifier="webdriver">
		<property name="browser">firefox</property>
	</extension>
</arquillian ...>

Drone: downloading geckodriver-v0.23.0-win64.zip from https://github.com/mozilla/geckodriver/releases/download/v0.23.0/geckodriver-v0.23.0-win64.zip to C:\Users\USERHOME\.arquillian\drone\firefox\v0.23.0\geckodriver-v0.23.0-win64.zip 
................................................................................
Okt 15, 2018 8:46:12 PM org.jboss.arquillian.drone.webdriver.binary.BinaryFilesUtils extract
INFORMATION: Extracting zip file: C:\Users\USERHOME\.arquillian\drone\firefox\v0.23.0\geckodriver-v0.23.0-win64.zip to C:\Temp\workspace\StatelessMaven\StatelessMaven-web\target\drone\1458a83f4cb051132fe9a91f30770162