© kabzarchyk/Shutterstock.com
SWTBot-Erweiterung für den Test von NatTable-Elementen

Automatisierte UI-Tests


In Zeiten von Continuous Delivery ist ein hohes Maß an Testautomatisierung unabdingbar. Für oberflächenzentrierte Anwendungen auf Basis der Eclipse Rich Client Platform sollte hierbei auch Funktionalität der Benutzeroberfläche automatisiert getestet werden. Für diesen Zweck gibt es bereits ausgereifte Frameworks oder Toolsets, die jedoch meist auf die Standardoberflächenelemente beschränkt sind. Dieser Artikel zeigt am Beispiel des Frameworks SWTBot, wie mit verhältnismäßig wenig Code und etwas Hintergrundwissen eine Erweiterung umgesetzt wurde, mit der Nebula-NatTable-Instanzen im Rahmen eigener Rich-Client-Anwendungen komfortabel getestet werden können.

SWTBot [1] ist ein Open Source Java-basiertes Tool für UI und funktionale Tests von SWT und Eclipse-basierten Anwendungen. Ziel ist eine möglichst einfache Entwicklung von automatisierten Tests durch Bereitstellung eines intuitiv bedienbaren API, das technische Details von SWT oder Eclipse weitgehend abstrahiert. SWTBot kann sowohl direkt aus der Eclipse Workbench, als auch über Ant oder Maven Tycho im Rahmen automatisierter Build- oder Deployment-Prozesse verwendet werden. Die Bibliothek bringt die Unterstützung der gängigen SWT Controls wie Formularelemente (Buttons, Combos, Checkboxen etc.), Menüs, Tables oder Tree-Elemente mit. Native Dialoge wie Dateiauswahl werden leider nicht unterstützt. Für die Anbindung eigener SWT Controls können verschiedene generische abstrakte Klassen erweitert werden. Dies wird in diesem Artikel am Beispiel eines NatTa­ble-Tabellen-Controls gezeigt.

NatTable [2] ist ein Framework, um komplexe, hochperformante Tabellen, Grids und Trees zu erstellen. Es ist seit Anfang des Jahres als Stable Release innerhalb des Eclipse-Nebula-Projekts verfügbar [3]. NatTable bietet vor allem bezüglich Darstellung, Editiermöglichkeiten und Benutzeroptionen deutlich mehr Flexibilität und Optionen als das Standard SWT Table Control. Aus diesem Grund werden über NatTable Controls in Rich-Client-Anwendungen oft kritische Anwendungsfälle oder Benutzerinteraktionen realisiert, die auch in automatisierten Tests abgebildet sein sollten.

Im Folgenden wird gezeigt, wie ein automatisierter UI-Test für NatTable Controls mit dem SWTBotNatTable, einer SWTBot-Erweiterung mit Operationen und nützlichen Hilfsmethoden zur automatisierten Bedienung einer NatTable-Instanz realisiert wurde. Anhand eines einfachen Beispiels wird zunächst verdeutlicht, wie ein Testfall mit der Lösung aussieht. Im Anschluss werden die allgemeinen Erweiterungspunkte von SWTBot und die Implementierung und Benutzung des SWTBot­NatTable beleuchtet. Abschließend wird auf die Ausführung von SWTBot-Tests innerhalb der Eclipse-IDE und Möglichkeiten zur Integration in einen automatisierten Build-Prozess eingegangen.

Beispielanwendung und Testfall

Als Beispiel und Anschauungsobjekt für den automatisierten Test der NatTable mit dem SWTBotNatTable wird eine einfache Eclipse-Rich-Client-Anwendung verwendet. Diese beinhaltet eine View mit einem Button zum Hinzufügen neuer Tabellenzeilen, sowie einem Tabellen-Grid mit Zeilen- und Spaltenheadern auf Basis der NatTable (Abb. 1). Die Zellen der Tabelle sind über typische Eingabemöglichkeiten wie die direkte Eingabe von Integerzahlen und Text per Tastatur sowie die Auswahl aus einer ComboBox und das Ankreuzen einer Checkbox editierbar. In der Spalte „Level“ ist eine bedingte Formatierung hinterlegt. Mit Klick auf den Button wird eine neue Zeile mit Dummyeinträgen der Tabelle hinzugefügt, nach Rechtsklick auf den Header der Zeile erscheint ein Kontextmenü, über das sich der Eintrag löschen lässt. Für die Zellen im Spaltenheader und Body-Bereich ist ein Tooltip gesetzt, der jeweils eine String-Ausgabe des aktuellen Zellenwerts anzeigt.

buchwald_abb1.tif_fmt1.jpgAbb. 1: Zu testende Beispiel-Eclipse-RCP-Anwendung

Listing 1

@Test
public void testSampleTable() throws Exception {
  // Load SWTBotNatTable instance
  SWTBotNatTable botNatTable = new SWTBotNatTable(
    bot.widget(widgetOfType(NatTable.class)));
  // Verify number of rows and columns
  assertEquals(2, botNatTable.getBodyRowCount());
  assertEquals(5, botNatTable.getBodyColumnCount());
  
  // Add new element, wait for number of rows to increase
  bot.button("Add new table element").click();
  bot.waitUntil(botNatTable.getBodyRowCountCondition(3));
  
  // Set values of new entry
  botNatTable.setBodyValue(2, 1, "Vogel");
  botNatTable.setBodyValue(2, 2, "Lars");
  
  // Verify values
  assertEquals("Lars", botNatTable.getBodyValue(2, 2));
  assertEquals("beginner", botNatTable.getBodyValue(2, 3));
  assertEquals(false, botNatTable.getBodyValue(2, 4));
  // no label set for level column
  assertFalse(botNatTable.hasBodyCellLabel(2, 3, View.EXPERT_LABEL));
  // verify tooltip of 3rd column in second row:
  // hover for 100ms more than the default delay of 0,5 sec
  botNatTable.hoverBodyCell(1, 2, 600);
  assertEquals("Dirk", botNatTable.getDefaultTooltipText(bot));
  
  // Select 3rd value (expert) in combo box
  botNatTable.selectBodyComboBoxValue(2, 3, 2);
  
  // assert new value
  assertEquals("expert", botNatTable.getBodyValue(2, 3));
  // now label is set for level column
  assertTrue(botNatTable.hasBodyCellLabel(2, 3, View.EXPERT_LABEL));
  
  // Click (and thus check) the checkbox in the 5th column
  botNatTable.clickBodyCell(...

headline from sands settings