Logo QF-Test

Komplett in zwei Sprachen dokumentiert.
Handbuch = Das QF-Test-Nachschlagewerk

 

Gratis Testen  Download  Kaufen

Uwe Klüh, Senior Sales Manager, QFS

Durchsuchen Sie die gesamte Dokumentation (Handbuch, Tutorial, Mailingliste, Standardbibliothek), indem Sie die Suchfunktion der Homepage nutzen.

Uwe Klüh, Sr. Sales Manager, QFS

Hilfe gibt's direkt in der QF-Test Anwendung

Auf die gesamte Dokumentation können Sie auch über das Hilfe Menü direkt in QF-Test zugreifen.

Handbuch

3.1+42.7
Listener für den aktuellen Testlauf

Einmal beim aktuellen Runcontext via rc.addTestRunListener registriert, wird eine Implementierung des TestRunListener Interfaces benachrichtigt, wenn ein Knoten betreten oder verlassen wird oder wenn Probleme auftreten. Ein illustratives Beispiel finden Sie in der Testsuite TestRunListener.qft im Verzeichnis demo/runlistener Ihrer QF-Test Installation. Am besten deaktivieren Sie den Debugger, bevor Sie diese Testsuite komplett ausführen.

Hinweis Eine Variante des TestRunListener Interfaces namens DaemonTestRunListener kann verwendet werden, um einen Testlauf über das Daemon API zu beobachten. Es wird in Abschnitt 43.2.5 näher beschrieben.

Das API besteht aus den folgenden Klassen:

42.7.1
Das TestRunListener Interface

Das Interface de.qfs.apps.qftest.extensions.qftest.TestRunListener muss implementiert und via rc.addTestRunListener() beim aktuellen Runcontext registriert werden.

Hinweis Zur Implementierung des Interfaces können Sie von der Klasse de.qfs.apps.qftest.extensions.qftest.AbstractTestRunListener ableiten, die für alle Methoden leere Implementierungen bereitstellt, so dass Sie nur die Methoden implementieren müssen, die Sie interessieren.

 
 
void runStarted(TestRunEvent event)
Benachrichtigt den Listener, dass ein Testlauf gestartet wurde.
Parameter
event Der Event mit den Details, in diesem Fall irrelevant.
 
void runStopped(TestRunEvent event)
Benachrichtigt den Listener, dass ein Testlauf beendet wurde.
Parameter
event Der Event mit den Details, in diesem Fall irrelevant.
 
void nodeEntered(TestRunEvent event)
Benachrichtigt den Listener, dass ein Knoten betreten wurde.
Parameter
event Der Event mit den Details.
 
void nodeExited(TestRunEvent event)
Benachrichtigt den Listener, dass ein Knoten verlassen wurde.
Parameter
event Der Event mit den Details.
 
void problemOccurred(TestRunEvent event)
Benachrichtigt den Listener, dass ein Problem aufgetreten ist.
Parameter
event Der Event mit den Details.
 
 
42.7.2
Die Klasse TestRunEvent

Die Klasse de.qfs.apps.qftest.extensions.qftest.TestRunEvent beinhaltet Informationen über die aktuell ausgeführten Knoten und den aktuellen Fehlerzustand. Sie definiert die folgenden Konstanten für Ausführungs- und Fehlerzustände: STATE_NOT_IMPLEMENTED, STATE_SKIPPED, STATE_OK, STATE_WARNING, STATE_ERROR und STATE_EXCEPTION. Die beiden ersten Zustände kommen nur bei 'Testfallsatz' und 'Testfall' Knoten vor.

In der runStopped Methode können Sie auch abfragen, ob der Testlauf normal beendet oder unterbrochen wurde. Hierfür können Sie die Konstanten STATE_RUN_TERMINATED und STATE_RUN_INTERRUPTED verwenden.

 
 
TestSuiteNode getNode()
Liefert den aktuellen Knoten
Rückgabewert Der aktuelle Knoten oder null für runStarted und runStopped.
 
TestSuiteNode[] getPath()
Liefert den gesamten Pfad für den aktuellen Knoten.
Rückgabewert Der Pfad für den aktuellen Knoten aus Sicht des Protokolls, vergleichbar mit dem Ausführungs-Stapel. Null für runStarted und runStopped. Der letzte Knoten im Array ist der aktuelle Knoten.
 
int getState()
Liefert den Status für den aktuellen Knoten.
Rückgabewert Der propagierende Status für den aktuellen Knoten. Dies ist der höchste Fehlerzustand dieses Knotens und all seiner Kinder, möglicherweise beschränkt durch ein Attribut 'Maximaler Fehler'. Verfügbar nur für nodeExited und problemOccurred.
 
int getLocalState()
Liefert den lokalen Status für den aktuellen Knoten.
Rückgabewert Der lokale Status für den aktuellen Knoten. Dies ist der höchste Fehlerzustand dieses Knotens und all seiner Kinder, unabhängig davon ob dieser weiter nach oben propagiert. Verfügbar nur für nodeExited und problemOccurred. Für 'Testfallsatz' und 'Testfall' Knoten kann der lokale Staus auch STATE_SKIPPED oder STATE_NOT_IMPLEMENTED sein.
 
String getMessage()
Liefert die aktuelle Fehlermeldung.
Rückgabewert Die Meldung für die aktuelle Warnung, Fehler oder Exception. Verfügbar nur für problemOccurred.
 
int getExceptions()
Liefert die Zahl der Exceptions für den Knoten.
Rückgabewert Die Gesamtzahl der Exceptions für den gerade verlassenen Knoten. Verfügbar nur für nodeExited.
 
int getErrors()
Liefert die Zahl der Fehler für den Knoten.
Rückgabewert Die Gesamtzahl der Fehler für den gerade verlassenen Knoten. Verfügbar nur für nodeExited.
 
int getWarnings()
Liefert die Zahl der Warnungen für den Knoten.
Rückgabewert Die Gesamtzahl der Warnungen für den gerade verlassenen Knoten. Verfügbar nur für nodeExited.
 
 
42.7.3
Die Klasse TestSuiteNode

Die Klasse de.qfs.apps.qftest.extensions.qftest.TestSuiteNode repräsentiert einen aktuell ausgeführten QF-Test Knoten. Sie beinhaltet Informationen über die Art des Knotens, seinen Namen, Kommentar, etc.

 
 
String getSuite()
Liefert die Testsuite, zu der der Knoten gehört.
RückgabewertDer komplette Pfad der Testsuite, zu der der Knoten gehört.
 
String getType()
Liefert die Art des Knotens.
Rückgabewert Die Art des Knotens. Dies ist der letzte Teil des Namens der Klasse, die diesen Knoten implementiert.
 
String getName()
Liefert den Namen des Knotens.
Rückgabewert Der Name des Knotens oder null, falls dieser kein Attribut 'Name' besitzt.
 
String getReportName()
Liefert den Reportnamen des Knotens.
Rückgabewert Der expandierte Reportname für 'Testfallsatz' und 'Testfall' Knoten. Der normale Name für andere Knoten oder null falls nicht definiert.
 
String getTreeName()
Liefert den "Baumnamen" des Knotens.
Rückgabewert Der Name des Knotens wie er im Baum der Testsuite dargestellt wird.
 
String getId()
Liefert die QF-Test ID des Knotens.
RückgabewertDie QF-Test ID des Knotens.
 
String getComment()
Liefert die Bemerkung des Knotens.
RückgabewertDie expandierte Bemerkung des Knotens.
 
 
Videos Downloads Dokumentation Kaufen Gratis Testen