Selenium RC Beispiel: Test eines JSF Spiels "Hangman"

JSF Projekt "Hangman" einrichten:

Das zu testende Projekt muss angelegt werden und auf einem Anwendungsserver (z.B. Tomcat 7 oder Glassfish 3) laufen.
Für Tests mit Selenium Werkzeugen spielt es keine Rolle, ob das Projekt von einer IDE wie Eclipse oder Netbeans aus auf dem Server installiert oder z.B. in Form eines "Web Archive" (.WAR) manuell auf dem Server installiert wird.
Das Beispielprojekt liegt vor - in Form von ".java" Sourcen für die Beans und ".xhtml" Dateien für die Facelets.
Man sollte darauf achten, den Web-Elementen beim Anlegen der .xhtml Seiten IDs zu vergeben, damit diese beim Anlegen der Tests, identifiziert werden können. Anderenfalls würden den Elementen sonst unleserliche, automatisch generierte IDs zugewiesen werden.

Projektordner

Es muss zunächst ein neues JSF 2.0 Projekt angelegt werden:

Anleitung für Eclipse
Anleitung für NetBeans (Nur erster Schritt "Erstellung eines Web-Projektes")

Anschließend muss der Inhalt des Beispiel "src" Verzeichnisses im Projektordner
in den entsprechenden "src" Ordner des neu angelegten Projektes kopiert werden.
Der Inhalt des Beispiel "web" Verzeichnisses, muss in den entsprechenden "web" (NetBeans) bzw. "WebContent" (Eclipse) Ordner des neu angelegten Projektes kopiert werden.
Danach kann das Projekt gestartet werden.
Wenn die Servereinstellungen (Host, Port usw.) nicht verändert wurden, kann das "Hangman" Spiel aus einem Webbrowser mit der URL "http://localhost:8080/Projektname/faces/index.xhtml" ("Projektname" durch den tatsächlichen Projektnamen austauschen) aufgerufen werden, andernfalls muss die URL entsprechend angepasst werden.

Selenium Testprojekt einrichten:

Ein neues Selenium Testprojekt kann entsprechend dieses Beispiels angelegt werden.
Anschließend können folgende Testfälle implementiert oder in den entsprechenden Source-Ordner für Tests kopiert werden.

package test;

import com.thoughtworks.selenium.DefaultSelenium;
import com.thoughtworks.selenium.Selenium;
import junit.framework.Assert;
import org.junit.AfterClass;
import org.junit.BeforeClass;
import org.junit.Ignore;
import org.junit.Test;

/**
 *
 * @author Andre Heidt
 */
public class HangmanTestsRC {

    public HangmanTestsRC() {
    }
    static Selenium selenium;

    @BeforeClass
    public static void setUp() {
        // Paramter: Host, Port, Browser, URL
        selenium = new DefaultSelenium("localhost", 4444, "*firefox",
                "http://localhost:8080/MyJSFProject/faces/index.xhtml");
        selenium.start(); // Session Start
    }

    @AfterClass
    public static void tearDown() {
        //beendet Browser
        selenium.stop();
    }

    @Test
    public void WortAnlegen1() {
        selenium.open("http://localhost:8080/MyJSFProject/faces/index.xhtml");
        selenium.click("id=homeform:eingabe");
        selenium.type("id=eingabeform:eingabetext", "RCTestwort1");
        selenium.click("id=eingabeform:eintragen");
        selenium.open("http://localhost:8080/MyJSFProject/faces/uebersicht.xhtml");
        Assert.assertTrue(selenium.isTextPresent("Testwort1"));
    }

    @Ignore("Fall tritt bei manueller Benutzung nicht ein")
    @Test
    public void WortAnlegen2() {
        selenium.open("http://localhost:8080/MyJSFProject/faces/index.xhtml");
        selenium.click("id=homeform:eingabe");
        selenium.type("id=eingabeform:eingabetext", "RCTestwort2");
        selenium.submit("id=eingabeform:eingabetext");
        selenium.open("http://localhost:8080/MyJSFProject/faces/uebersicht.xhtml");
        Assert.assertTrue(selenium.isTextPresent("RCTestwort2"));
    }

    @Test
    public void WortAnlegen3() {
        selenium.open("http://localhost:8080/MyJSFProject/faces/index.xhtml");
        selenium.click("id=homeform:eingabe");
        selenium.type("id=eingabeform:eingabetext", "RCTestwort3");
        selenium.keyPress("id=eingabeform:eingabetext", "13");
        selenium.open("http://localhost:8080/MyJSFProject/faces/uebersicht.xhtml");
        Assert.assertTrue(selenium.isTextPresent("RCTestwort3"));
    }

    @Test
    public void SpielVersuche1() {
        String erwartet;
        String tatsaechlich;

        selenium.open("http://localhost:8080/MyJSFProject/faces/index.xhtml");
        selenium.click("id=homeform:spiel");
        tatsaechlich = selenium.getTable("id=spielform:spielfeld.1.0");
        erwartet = "0";
        selenium.click("spielform:abbruch");
        Assert.assertEquals(tatsaechlich, erwartet);
    }

    @Test
    public void SpielVersuche2() {

        String erwartet;
        String tatsaechlich;


        selenium.open("http://localhost:8080/MyJSFProject/faces/index.xhtml");
        //klick auf Button "Spielen"
        selenium.click("id=homeform:spiel");


        for (int i = 0; i < 10; i++) {
            selenium.click("id=spielform:veruschen");
        }
        tatsaechlich = selenium.getTable("id=spielform:spielfeld.1.0");
        erwartet = "10";
        selenium.click("spielform:abbruch");

        Assert.assertEquals(tatsaechlich, erwartet);
    }

    @Test
    public void SpielVersuche3() {
        String erwartet;
        String tatsaechlich;

        selenium.open("http://localhost:8080/MyJSFProject/faces/index.xhtml");
        //klick auf Button "Spielen"
        selenium.click("id=homeform:spiel");

        for (int i = 0; i < 10; i++) {
            selenium.keyPress("id=spielform:entry", "13");
        }
        tatsaechlich = selenium.getTable("id=spielform:spielfeld.1.0");
        erwartet = "10";
        selenium.click("spielform:abbruch");

        Assert.assertEquals(tatsaechlich, erwartet);
    }

    @Test
    public void SpielVersuche4() {

        String erwartet;
        String tatsaechlich;


        selenium.open("http://localhost:8080/MyJSFProject/faces/index.xhtml");
        //klick auf Button "Spielen"
        selenium.click("id=homeform:spiel");

        for (int i = 0; i < 10; i++) {
            //versuch mit Browserfunktion "zurueck" Anzahl Versuche zu beeinflussen
            if (i == 5) {
                selenium.goBack();
            }
            selenium.click("id=spielform:veruschen");
        }
        tatsaechlich = selenium.getTable("id=spielform:spielfeld.1.0");
        erwartet = "10";
        selenium.click("spielform:abbruch");

        Assert.assertEquals(tatsaechlich, erwartet);
    }

    @Test
    public void SpielGewinn1() {

        StringBuilder versuch;
        Boolean sieg = false;
        int i = -1;
        selenium.open("http://localhost:8080/MyJSFProject/faces/index.xhtml");
        //klick auf Button "Spielen"
        selenium.click("id=homeform:spiel");

        try {
            //versuche 1 mal mehr als Woerter im Wortspeicher
            //bei sieg, wird eingabefeld nicht mehr gefunden
            //und die exception geworfen
            for (i = 0; i < 4; i++) {
                versuch = new StringBuilder("RCTestwort");
                versuch.append(Integer.toString(i + 1));
                selenium.type("id=spielform:entry", versuch.toString());
                selenium.keyPress("id=spielform:entry", "13");
            }
        } catch (Exception expected) {
            sieg = true;
        }

        if (sieg && i > -1) {
            //vergleich angezeigte Anzahl Versuche mit tatsaechlich benoetigten
            String versuche = selenium.getTable("id=spielform:siegfeld.1.0");
            Assert.assertEquals(Integer.toString(i), versuche);
        } else {
            Assert.fail("Testwort konnte nicht erraten werden");
        }
    }
}

Das Hangman Spiel

Bei dem Spiel können Wörter eingegeben werden, die später, per Zufall ausgewählt, erraten werden müssen. Das Spiel zählt die Anzahl der gebrauchten Versuche und zeigt richtig erratene Teile des Lösungsworts. Eine "geheime" Seite "uebersicht.xhtml", die nicht über die Spieloberfläche erreichbar ist, gibt eine Übersicht über alle im Wortspeicher vorhandenen Wörter.

Absichten der Testfälle

Testfälle WortAnlegen1 bis 3 testen das Anlegen von neuen Wörtern für das Ratespiel "Hangman". Mit Hilfe der Seite "uebersicht.xhtml", wird darauf hin überprüft, ob das Wort auch tatsächlich in den Wortspeicher eingefügt wurde.

WortAnlegen1 testet das Bestätigen der Worteingabe per Mausklick.

WortAnlegen2 testet das Bestätigen der Worteingabe mit Hilfe der Selenium eigenen "Submit"-Funktion, die das Ende des Formulars sucht und es absendet.

WortAnlegen3 testet das Bestätigen der Worteingabe per Druck der "Enter" Taste.

Testfälle SpielVersuche1 bis 4 testen den Zähler für benötigte Rateversuche.

SpielVersuche1 testet darauf, dass beim Spielstart "0" Versuche angezeigt werden.

SpielVersuche2 testet die Anzeige der Spielversuche bei Absenden von (leeren) Versuchen per Mausklick.

SpielVersuche3 testet die Anzeige der Spielversuche bei Absenden von (leeren) Versuchen per "Enter" Taste.

SpielVersuche4 testet die Anzeige der Spielversuche bei Absenden von (leeren) Versuchen bei Störung des Ablaufs durch Browser-Funktion "zurück".

Testfall SpielGewinn1 testet darauf, dass das Wort tatsächlich erraten werden kann und in der Gewinnbenachrichtigung die korrekte Anzahl der benötigten Versuche angezeigt wird.

Zurück zur Werkzeugübersicht
Zurück zur CSI-Hauptseite