ZbieranieTestListener
public class CollectingTestListener
extends Object
implements ITestInvocationListener , ILogSaverListener , IDisableable
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.result.CollectingTestListener |
ITestInvocationListener
, który będzie zbierał wszystkie wyniki testów.
Chociaż struktury danych użyte w tym obiekcie są bezpieczne dla wątków, wywołania zwrotne ITestInvocationListener
muszą być wywoływane we właściwej kolejności.
Streszczenie
Konstruktorzy publiczni | |
---|---|
CollectingTestListener () |
Metody publiczne | |
---|---|
IBuildInfo | getBuildInfo () Ta metoda jest przestarzała. polegaj na |
TestRunResult | getCurrentRunResults () Pobiera wyniki bieżącego przebiegu testu. |
int | getExpectedTests () Zwraca liczbę oczekiwanych testów. |
IInvocationContext | getInvocationContext () Zwróć kontekst wywołania zgłoszony za pośrednictwem |
getMergedTestRunResults () Zwróć połączony zbiór wyników dla wszystkich przebiegów w różnych próbach. | |
IInvocationContext | getModuleContextForRunResult (String testRunName) Zwraca |
MultiMap <String, LogFile > | getModuleLogFiles () Zwraca kopię mapy zawierającą cały zarejestrowany plik powiązany z modułem |
MultiMap <String, LogFile > | getNonAssociatedLogFiles () Zwraca kopię mapy zawierającą wszystkie zarejestrowane pliki niezwiązane z uruchomieniem testowym lub modułem. |
int | getNumAllFailedTestRuns () Zwraca całkowitą liczbę przebiegów testowych w stanie niepowodzenia |
int | getNumAllFailedTests () Zwraca całkowitą liczbę testów w stanie niepowodzenia (tylko testy zakończone niepowodzeniem, niepowodzenia założeń nie są wliczane do tego). |
int | getNumTestsInState (TestResult.TestStatus status) Zwraca liczbę testów w danym stanie dla tego przebiegu. |
int | getNumTotalTests () Zwraca całkowitą liczbę pełnych testów dla wszystkich przebiegów. |
IBuildInfo | getPrimaryBuildInfo () Zwróć podstawowe informacje o kompilacji zgłoszone za pośrednictwem |
getRunResults () Ta metoda jest przestarzała. Użyj metody | |
TestRunResult | getTestRunAtAttempt (String testRunName, int attempt) Zwróć |
int | getTestRunAttemptCount (String testRunName) Zwraca liczbę prób dla danej nazwy przebiegu testu. |
getTestRunAttempts (String testRunName) Pobiera wszystkie próby | |
getTestRunForAttempts (int attempt) Pobiera wszystkie wyniki dla danej próby. | |
getTestRunNames () Zwróć wszystkie nazwy wszystkich przebiegów testowych. | |
boolean | hasFailedTests () Zwraca, jeśli jakiekolwiek testy wywołania nie powiodły się lub założenia nie powiodły się. |
boolean | hasTestRunResultsForName (String testRunName) Zwraca, czy dana nazwa przebiegu testu ma jakieś wyniki. |
void | invocationEnded (long elapsedTime) Raportuje, że wywołanie zostało zakończone pomyślnie lub z powodu błędu. |
void | invocationFailed (Throwable cause) Zgłasza niekompletne wywołanie z powodu błędu. |
void | invocationStarted ( IInvocationContext context) Zgłasza początek wywołania testu. |
boolean | isDisabled () Zwraca wartość True, jeśli cały obiekt jest wyłączony (pomiń konfigurację i demontaż). |
void | logAssociation (String dataName, LogFile logFile) W niektórych przypadkach log musi być ściśle powiązany z przypadkami testowymi, ale możliwość zrobienia tego bezpośrednio na |
void | setBuildInfo ( IBuildInfo buildInfo) Ta metoda jest przestarzała. Nie jest już konieczne do testów. |
void | setDisable (boolean isDisabled) Ustawia, czy obiekt powinien być wyłączony. |
void | setMergeStrategy ( MergeStrategy strategy) Ustawia |
void | testAssumptionFailure ( TestDescription test, String trace) Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy |
void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternatywa dla |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Zgłasza koniec wykonania pojedynczego przypadku testowego. |
void | testFailed ( TestDescription test, FailureDescription failure) Zgłasza niepowodzenie pojedynczego przypadku testowego. |
void | testFailed ( TestDescription test, String trace) Zgłasza niepowodzenie pojedynczego przypadku testowego. |
void | testIgnored ( TestDescription test) Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore. |
void | testModuleEnded () Zgłasza koniec działania modułu. |
void | testModuleStarted ( IInvocationContext moduleContext) Zgłasza początek działania modułu. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Zgłasza koniec przebiegu testowego. |
void | testRunFailed ( FailureDescription failure) Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w |
void | testRunFailed (String errorMessage) Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego. |
void | testRunStarted (String name, int numTests, int attemptNumber) Zgłasza rozpoczęcie przebiegu testowego. |
void | testRunStarted (String name, int numTests) Zgłasza rozpoczęcie przebiegu testowego. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Zgłasza rozpoczęcie przebiegu testowego. |
void | testRunStopped (long elapsedTime) Raportuje, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika. |
void | testStarted ( TestDescription test, long startTime) Alternatywa dla |
void | testStarted ( TestDescription test) Zgłasza rozpoczęcie pojedynczego przypadku testowego. |
Metody chronione | |
---|---|
final void | clearModuleLogFiles () Umożliwia wyczyszczenie pliku modułu, dzięki czemu unikamy przenoszenia go zbyt długo. |
final void | clearResultsForName (String testRunName) Umożliwia wyczyszczenie wyników dla danej nazwy uruchomienia. |
void | setIsAggregrateMetrics (boolean aggregate) Przełącz opcję „dane zbiorcze”. |
Konstruktorzy publiczni
ZbieranieTestListener
public CollectingTestListener ()
Metody publiczne
pobierz informacje o kompilacji
public IBuildInfo getBuildInfo ()
Ta metoda jest przestarzała.
polegaj na IBuildInfo
z getInvocationContext()
.
Zwraca informacje o kompilacji.
Zwroty | |
---|---|
IBuildInfo |
pobierzCurrentRunResults
public TestRunResult getCurrentRunResults ()
Pobiera wyniki bieżącego przebiegu testu.
Należy pamiętać, że wyniki mogą nie być kompletne. Zaleca się przetestowanie odpowiednio wartości TestRunResult.isRunComplete()
i/lub (@link TestRunResult#isRunFailure()} przed przetworzeniem wyników.
Zwroty | |
---|---|
TestRunResult | TestRunResult reprezentujący dane zebrane podczas ostatniego przebiegu testu |
getExpectedTests
public int getExpectedTests ()
Zwraca liczbę oczekiwanych testów. Może różnić się od getNumTotalTests()
, jeśli niektóre testy nie zostały uruchomione.
Zwroty | |
---|---|
int |
pobierzKontekstInwokacji
public IInvocationContext getInvocationContext ()
Zwróć kontekst wywołania zgłoszony za pośrednictwem invocationStarted(com.android.tradefed.invoker.IInvocationContext)
Zwroty | |
---|---|
IInvocationContext |
getMergedTestRunResults
publicgetMergedTestRunResults ()
Zwróć połączony zbiór wyników dla wszystkich przebiegów w różnych próbach.
Jeśli istnieje wiele wyników, każdy przebieg testu jest łączony, przy czym najnowszy wynik testu zastępuje wyniki poprzednich przebiegów. Przebiegi testowe są uporządkowane według numeru próby.
Metryki dla tej samej próby zostaną scalone na podstawie preferencji ustawionych przez aggregate-metrics
. Ostateczne metryki będą metrykami ostatniej próby.
Zwroty | |
---|---|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Zwraca IInvocationContext
modułu powiązanego z wynikami.
Parametry | |
---|---|
testRunName | String : Nazwa nadana przez { testRunStarted(String, int) . |
Zwroty | |
---|---|
IInvocationContext | IInvocationContext modułu dla danej nazwy przebiegu testu null , jeśli nie ma wyników dla tej nazwy. |
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
Zwraca kopię mapy zawierającą cały zarejestrowany plik powiązany z modułem
Zwroty | |
---|---|
MultiMap <String, LogFile > |
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Zwraca kopię mapy zawierającą wszystkie zarejestrowane pliki niezwiązane z uruchomieniem testowym lub modułem.
Zwroty | |
---|---|
MultiMap <String, LogFile > |
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Zwraca całkowitą liczbę przebiegów testowych w stanie niepowodzenia
Zwroty | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Zwraca całkowitą liczbę testów w stanie niepowodzenia (tylko testy zakończone niepowodzeniem, niepowodzenia założeń nie są wliczane do tego).
Zwroty | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus status)
Zwraca liczbę testów w danym stanie dla tego przebiegu.
Parametry | |
---|---|
status | TestResult.TestStatus |
Zwroty | |
---|---|
int |
getNumTotalTests
public int getNumTotalTests ()
Zwraca całkowitą liczbę pełnych testów dla wszystkich przebiegów.
Zwroty | |
---|---|
int |
pobierzPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
Zwróć podstawowe informacje o kompilacji zgłoszone za pośrednictwem invocationStarted(com.android.tradefed.invoker.IInvocationContext)
. Kompilacja podstawowa to kompilacja zwrócona przez pierwszego dostawcę kompilacji działającej konfiguracji. Zwraca wartość null, jeśli nie ma kontekstu (nie ma kompilacji do przypadku testowego).
Zwroty | |
---|---|
IBuildInfo |
getRunResults
publicgetRunResults ()
Ta metoda jest przestarzała.
Użyj metody getMergedTestRunResults()
Zwraca wyniki dla wszystkich przebiegów testowych.
Zwroty | |
---|---|
getTestRunAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Zwróć TestRunResult
dla pojedynczej próby.
Parametry | |
---|---|
testRunName | String : Nazwa nadana przez { testRunStarted(String, int) . |
attempt | int : Identyfikator próby. |
Zwroty | |
---|---|
TestRunResult | TestRunResult dla podanej nazwy i identyfikatora próby lub null , jeśli nie istnieje. |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Zwraca liczbę prób dla danej nazwy przebiegu testu.
Parametry | |
---|---|
testRunName | String : Nazwa nadana przez { testRunStarted(String, int) . |
Zwroty | |
---|---|
int |
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
Pobiera wszystkie próby TestRunResult
danego przebiegu testowego.
Parametry | |
---|---|
testRunName | String : Nazwa nadana przez { testRunStarted(String, int) . |
Zwroty | |
---|---|
Wszystkie TestRunResult dla danego przebiegu testowego, uporządkowane według prób. |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
Pobiera wszystkie wyniki dla danej próby.
Parametry | |
---|---|
attempt | int : Próba, dla której chcemy uzyskać wyniki. |
Zwroty | |
---|---|
Wszystkie TestRunResult dla danej próby. |
getTestRunNames
publicgetTestRunNames ()
Zwróć wszystkie nazwy wszystkich przebiegów testowych.
Te przebiegi testowe mogły być uruchamiane wiele razy przy różnych próbach.
Zwroty | |
---|---|
ma nieudane testy
public boolean hasFailedTests ()
Zwraca, jeśli jakiekolwiek testy wywołania nie powiodły się lub założenia nie powiodły się.
Zwroty | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Zwraca, czy dana nazwa przebiegu testu ma jakieś wyniki.
Parametry | |
---|---|
testRunName | String : Nazwa nadana przez { testRunStarted(String, int) . |
Zwroty | |
---|---|
boolean |
wywołanieZakończone
public void invocationEnded (long elapsedTime)
Raportuje, że wywołanie zostało zakończone pomyślnie lub z powodu błędu.
Zostanie automatycznie wywołany przez platformę TradeFederation.Parametry | |
---|---|
elapsedTime | long : czas wywołania, który upłynął w ms |
wywołanie nie powiodło się
public void invocationFailed (Throwable cause)
Zgłasza niekompletne wywołanie z powodu błędu.
Zostanie automatycznie wywołany przez platformę TradeFederation.Parametry | |
---|---|
cause | Throwable : Throwable , czyli przyczyna niepowodzenia |
wywołanieRozpoczęte
public void invocationStarted (IInvocationContext context)
Zgłasza początek wywołania testu.
Zostanie automatycznie wywołany przez platformę TradeFederation. Reporterzy muszą zastąpić tę metodę, aby obsługiwać raporty z wielu urządzeń.
Parametry | |
---|---|
context | IInvocationContext : informacja o wywołaniu |
jest niepełnosprawny
public boolean isDisabled ()
Zwraca wartość True, jeśli cały obiekt jest wyłączony (pomiń konfigurację i demontaż). Inaczej nieprawda.
Zwroty | |
---|---|
boolean |
stowarzyszenie log
public void logAssociation (String dataName, LogFile logFile)
W niektórych przypadkach log musi być ściśle powiązany z przypadkami testowymi, ale możliwość zrobienia tego bezpośrednio na testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
wywołanie zwrotne nie jest możliwe. Zatem to wywołanie zwrotne pozwala na wyraźne zapewnienie silnego powiązania.
Parametry | |
---|---|
dataName | String : nazwa danych |
logFile | LogFile : plik LogFile , który został wcześniej zarejestrowany i powinien być powiązany z przypadkiem testowym. |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
Ta metoda jest przestarzała.
Nie jest już konieczne do testów.
Ustaw informacje o kompilacji. Należy używać wyłącznie do celów testowych.
Parametry | |
---|---|
buildInfo | IBuildInfo |
ustawWyłącz
public void setDisable (boolean isDisabled)
Ustawia, czy obiekt powinien być wyłączony. Wyłączone oznacza, że należy pominąć zarówno kroki konfiguracji, jak i usuwania. Można go użyć do domyślnego wyłączenia obiektu w domyślnym konstruktorze.
Parametry | |
---|---|
isDisabled | boolean : stan, w jakim powinien znajdować się obiekt. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Ustawia MergeStrategy
do użycia podczas łączenia wyników.
Parametry | |
---|---|
strategy | MergeStrategy |
testZałożenieNiepowodzenie
public void testAssumptionFailure (TestDescription test, String trace)
Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
trace | String : ślad stosu awarii |
testZałożenieNiepowodzenie
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
failure | FailureDescription : FailureDescription opisujący awarię i jej kontekst. |
testZakończony
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
gdzie możemy bezpośrednio określić czas zakończenia. Połącz z testStarted(com.android.tradefed.result.TestDescription, long)
, aby uzyskać dokładny pomiar.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
endTime | long : czas zakończenia testu mierzony za pomocą System.currentTimeMillis() |
testMetrics | ERROR(/Map) emitowanych metryk |
testZakończony
public void testEnded (TestDescription test,testMetrics)
Zgłasza koniec wykonania pojedynczego przypadku testowego.
Jeśli testFailed(TestDescription, FailureDescription)
nie został wywołany, test zakończył się pomyślnie. Zwraca również wszelkie metryki klucz/wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
testMetrics | ERROR(/Map) emitowanych metryk |
Test nieudany
public void testFailed (TestDescription test, FailureDescription failure)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Będzie wywoływany pomiędzy testStarted i testEnded.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
failure | FailureDescription : FailureDescription opisujący awarię i jej kontekst. |
Test nieudany
public void testFailed (TestDescription test, String trace)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Będzie wywoływany pomiędzy testStarted i testEnded.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
trace | String : ślad stosu awarii |
testIgnorowany
public void testIgnored (TestDescription test)
Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
moduł testowyZakończony
public void testModuleEnded ()
Zgłasza koniec działania modułu.
Uruchomiono moduł testowy
public void testModuleStarted (IInvocationContext moduleContext)
Zgłasza początek działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded()
i jest opcjonalne w sekwencji. Jest używany tylko podczas biegu, który wykorzystuje moduły: biegacze bazujący na pakiecie.
Parametry | |
---|---|
moduleContext | IInvocationContext : IInvocationContext modułu. |
testRunZakończony
public void testRunEnded (long elapsedTime,runMetrics)
Zgłasza koniec przebiegu testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> różnych typów, więc musimy tutaj użyć HashMap.
Parametry | |
---|---|
elapsedTime | long : urządzenie zgłosiło czas, który upłynął, w milisekundach |
runMetrics | Metric . |
testRun nie powiódł się
public void testRunFailed (FailureDescription failure)
Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w FailureDescription
.
Parametry | |
---|---|
failure | FailureDescription : FailureDescription opisujący awarię i jej kontekst. |
testRun nie powiódł się
public void testRunFailed (String errorMessage)
Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.
Parametry | |
---|---|
errorMessage | String : String opisujący przyczynę niepowodzenia uruchomienia. |
Uruchomiono testRun
public void testRunStarted (String name, int numTests, int attemptNumber)
Zgłasza rozpoczęcie przebiegu testowego.
Parametry | |
---|---|
name | String : nazwa przebiegu testowego |
numTests | int : całkowita liczba testów w przebiegu testu |
attemptNumber | int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3. |
Uruchomiono testRun
public void testRunStarted (String name, int numTests)
Zgłasza rozpoczęcie przebiegu testowego.
Parametry | |
---|---|
name | String : nazwa przebiegu testowego |
numTests | int : całkowita liczba testów w przebiegu testu |
Uruchomiono testRun
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Zgłasza rozpoczęcie przebiegu testowego.
Parametry | |
---|---|
name | String : nazwa przebiegu testowego |
numTests | int : całkowita liczba testów w przebiegu testu |
attemptNumber | int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3. |
startTime | long : czas rozpoczęcia przebiegu mierzony za pomocą System.currentTimeMillis() |
testRunZatrzymany
public void testRunStopped (long elapsedTime)
Raportuje, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.
DO ZROBIENIA: obecnie nieużywany, rozważ usunięcie
Parametry | |
---|---|
elapsedTime | long : urządzenie zgłosiło czas, który upłynął, w milisekundach |
test rozpoczęty
public void testStarted (TestDescription test, long startTime)
Alternatywa dla testStarted(com.android.tradefed.result.TestDescription)
, gdzie określamy również, kiedy test został rozpoczęty, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
w celu dokładnego pomiaru .
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
startTime | long : czas rozpoczęcia testu mierzony za pomocą System.currentTimeMillis() |
test rozpoczęty
public void testStarted (TestDescription test)
Zgłasza rozpoczęcie pojedynczego przypadku testowego. Starszy interfejs, jeśli to możliwe, należy używać testStarted(com.android.tradefed.result.TestDescription)
.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
Metody chronione
clearModuleLogFiles
protected final void clearModuleLogFiles ()
Umożliwia wyczyszczenie pliku modułu, dzięki czemu unikamy przenoszenia go zbyt długo.
wyczyśćResultsForName
protected final void clearResultsForName (String testRunName)
Umożliwia wyczyszczenie wyników dla danej nazwy uruchomienia. Należy go używać tylko w niektórych przypadkach, np. agregatora wyników.
Parametry | |
---|---|
testRunName | String |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Przełącz opcję „dane zbiorcze”.
Parametry | |
---|---|
aggregate | boolean |