|
void addTestRunListener(DaemonTestRunListener listener, boolean synchronous, long timeout) |
|
Parameter |
listener | Der zu registrierende Listener. |
synchronous |
Legt fest, ob der Listener synchron benachrichtigt werden soll. In diesem Fall wird
der Testlauf blockiert, bis der Listener den Event verarbeitet hat.
|
timeout |
Wartezeit in Millisekunden für Aufrufe des Listeners. Falls der Listener nicht
innerhalb dieser Zeitspanne antwortet, wird er automatisch deregistriert, um weitere
Probleme zu vermeiden. Im Fall eines synchronen Listeners läuft dann auch der Test
weiter. Ein Wert von 0 bedeutet kein Timeout, was nicht ungefährlich ist, aber
nützlich sein kann.
|
|
|
boolean callProcedure(String procedure, Properties bindings=None) |
|
Parameter |
procedure |
Die Prozedur, die ausgeführt werden soll, in der Form Suite#Procedure ,
wobei Procedure der vollständige Name einer 'Prozedur' sein muss.
|
bindings |
Ein optionaler Satz von Variablendefinitionen. Diese binden stärker als die globalen
Variablen und als alle Definitionen auf dem sekundären Stapel.
|
Rückgabewert |
True falls der Prozeduraufruf gestartet wurde, false wenn die Suite oder die
Prozedur nicht gefunden werden konnten.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
IllegalStateException |
Falls im gegenwärtigen Status kein Test gestartet werden kann, der Status also weder
STATE_IDLE noch STATE_FINISHED ist.
|
|
void clearGlobals() |
|
|
Exceptions |
RemoteException |
If something RMI specific goes wrong.
|
|
void clearTestRunListeners() |
|
|
|
String getGlobal(String name) |
|
Parameter |
name | Der Name der Variable. |
Rückgabewert |
Der Wert der Variable oder null falls nicht definiert.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
Properties getGlobals() |
|
Rückgabewert |
Die globalen Variablen.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
String getIdentifier() |
|
Rückgabewert |
Der Name des DaemonRunContexts.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
String getLastTest() |
|
Rückgabewert |
Der Name des aktuellen bzw. zuletzt ausgeführten Tests.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
int getNumThreads() |
|
Rückgabewert |
Die Zahl der Threads der Gruppe des DaemonRunContext.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
Properties getProperties(String group) |
|
Parameter |
name | Der Name der Property oder Ressource Gruppe. |
Rückgabewert |
Die Properties oder null falls die Gruppe nicht existiert.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
String getProperty(String group, String name) |
|
Parameter |
name | Der Name der Property oder Ressource Gruppe. |
name | Der Name der Property. |
Rückgabewert |
Der Wert der Property oder null falls nicht definiert.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
int getResult() |
|
Rückgabewert |
Das Ergebnis des Testlaufs, einer der Werte RESULT_OK, RESULT_WARNING, RESULT_ERROR oder RESULT_EXCEPTION.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
IllegalStateException |
Wenn der Laufzustand ungleich STATE_FINISHED ist.
|
|
byte[] getRunLog() |
|
Rückgabewert |
Das Protokoll in Form eines byte array.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
IllegalStateException |
Wenn der Laufzustand ungleich STATE_FINISHED ist.
|
|
int getRunState() |
|
Rückgabewert |
Der aktuelle Laufzustand des Runcontext, einer von STATE_IDLE, STATE_SCHEDULED, STATE_RUNNING,
STATE_PAUSED oder STATE_FINISHED.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
TestRunDaemon getTestRunDaemon() |
|
Rückgabewert |
Der TestRunDaemon des DaemonRunContext.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
int getThreadNum() |
|
Parameter |
| |
Rückgabewert |
Der Thread-Index des DaemonRunContext.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
void release() |
|
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
IllegalStateException |
Wenn kein DaemonRunContext angelegt war.
|
|
void removeTestRunListener(DaemonTestRunListener listener) |
|
Parameter |
listener | Der zu entfernende Listener. |
|
|
void rollbackDependencies() |
|
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
IllegalStateException |
Falls im gegenwärtigen Status kein Test gestartet werden kann, der Status also weder
STATE_IDLE noch STATE_FINISHED ist.
|
|
boolean runTest(String test, Properties bindings=None) |
|
Parameter |
test |
Der Test, der ausgeführt werden soll, in der Form Suite#Test , wobei
#Test optional ist und Test der vollständige Name eines
Testfallsatzes oder Testfalls oder ein "." sein kann. Letzteres ist äquivalent zur
Angabe von Suite alleine und bewirkt das Ausführen der ganzen
Testsuite.
Beispiele:
MySuite | | Führt die ganze Testsuite MySuite aus. | MySuite#. | | Führt die ganze Testsuite MySuite aus. | MySuite#MyTestSet | | Führt den Testfallsatz MyTestSet in der Testsuite MySuite
aus. | MySuite#MyTestSet.MyTestCase | | Führt den Testfall MyTestCase aus, der sich im Testfallsatz
MyTestSet in der Testsuite MySuite befindet. |
|
bindings |
Ein optionaler Satz von Variablendefinitionen. Diese binden stärker als die globalen
Variablen und als alle Definitionen auf dem sekundären Stapel.
|
Rückgabewert |
True falls der Test gestartet wurde, false wenn die Suite oder der Test nicht
gefunden werden konnten.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
IllegalStateException |
Falls im gegenwärtigen Status kein Test gestartet werden kann, der Status also weder
STATE_IDLE noch STATE_FINISHED ist.
|
|
void setIdentifier(String identifier) |
|
Parameter |
identifier |
Der zu setzende Name.
|
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
void setGlobals(Properties globals) |
|
Parameter |
globals |
Die zu setzende globalen Variablen.
|
|
Exceptions |
RemoteException |
If something RMI specific goes wrong.
|
|
void setRootDirectory(String directory) |
|
Parameter |
directory |
Das neue Wurzelverzeichnis.
|
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|
void stopRun() |
|
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
IllegalStateException |
Wenn kein Testlauf angestoßen war.
|
|
boolean waitForRunState(int state, long timeout) |
|
Parameter |
state |
Der Zustand auf den gewartet werden soll.
|
timeout |
Maximale Wartezeit im Millisekunden.
|
Rückgabewert |
True falls der Zustand erreicht wurde, false wenn die Wartezeit verstrichen ist und der Zustand bis dahin nicht erreicht wurde.
|
Exceptions |
RemoteException |
Wenn etwas RMI-Spezifisches schief geht.
|
|