ZbieranieTestListener
public class CollectingTestListener
extends Object
implements ITestInvocationListener , ILogSaverListener , IDisableable
java.lang.Obiekt | |
↳ | com.android.tradefed.result.CollectingTestListener |
ITestInvocationListener
, który zbierze wszystkie wyniki testów.
Chociaż struktury danych używane w tym obiekcie są bezpieczne wątkowo, wywołania zwrotne ITestInvocationListener
muszą być wywoływane we właściwej kolejności.
Streszczenie
Konstruktory publiczne | |
---|---|
CollectingTestListener () |
Metody publiczne | |
---|---|
IBuildInfo | getBuildInfo () Ta metoda jest przestarzała. polegać na |
TestRunResult | getCurrentRunResults () Pobiera wyniki dla bieżącego przebiegu testu. |
int | getExpectedTests () Zwraca liczbę oczekiwanych testów. |
IInvocationContext | getInvocationContext () Zwróć kontekst wywołania, który został zgłoszony przez |
getMergedTestRunResults () Zwróć scaloną kolekcję 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ą wszystkie zarejestrowane pliki powiązane z modułem |
MultiMap <String, LogFile > | getNonAssociatedLogFiles () Zwraca kopię mapy zawierającą wszystkie zarejestrowane pliki niezwiązane z uruchomieniem testu lub modułem. |
int | getNumAllFailedTestRuns () Zwraca całkowitą liczbę przebiegów testu w stanie niepowodzenia |
int | getNumAllFailedTests () Zwraca całkowitą liczbę testów w stanie niepowodzenia (tylko nieudane, awarie założenia nie są wliczane do tego stanu). |
int | getNumTestsInState (TestResult.TestStatus status) Zwraca liczbę testów w danym stanie dla tego przebiegu. |
int | getNumTotalTests () Zwraca łączną liczbę pełnych testów dla wszystkich przebiegów. |
IBuildInfo | getPrimaryBuildInfo () Zwróć podstawowe informacje o kompilacji, które zostały zgłoszone przez |
getRunResults () Ta metoda jest przestarzała. Użyj funkcji | |
TestRunResult | getTestRunAtAttempt (String testRunName, int attempt) Zwróć |
int | getTestRunAttemptCount (String testRunName) Zwraca liczbę prób dla danej nazwy uruchomienia testu. |
getTestRunAttempts (String testRunName) Pobiera wszystkie próby dla | |
getTestRunForAttempts (int attempt) Pobiera wszystkie wyniki dla danej próby. | |
getTestRunNames () Zwróć wszystkie nazwy dla wszystkich przebiegów testowych. | |
boolean | hasFailedTests () Zwraca, jeśli wywołanie miało jakiekolwiek testy zakończone niepowodzeniem lub przy założeniu, że zakończyły się niepowodzeniem. |
boolean | hasTestRunResultsForName (String testRunName) Zwraca, czy dana nazwa przebiegu testu ma jakieś wyniki. |
void | invocationEnded (long elapsedTime) Zgłasza, że wywołanie zakończyło się 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 testowego. |
boolean | isDisabled () Zwraca True, jeśli cały obiekt jest wyłączony (pomiń zarówno konfigurację, jak i demontaż). |
void | logAssociation (String dataName, LogFile logFile) W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego na bezpośrednim |
void | setBuildInfo ( IBuildInfo buildInfo) Ta metoda jest przestarzała. Nie jest już potrzebny 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 oznacza, że zakłada warunek, który jest fałszywy |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Wywoływana, gdy test atomowy oznacza, ż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 awarię pojedynczego przypadku testowego. |
void | testFailed ( TestDescription test, String trace) Zgłasza awarię pojedynczego przypadku testowego. |
void | testIgnored ( TestDescription test) Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore. |
void | testModuleEnded () Zgłasza koniec uruchomienia modułu. |
void | testModuleStarted ( IInvocationContext moduleContext) Zgłasza początek uruchomionego modułu. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Zgłasza koniec przebiegu testowego. |
void | testRunFailed ( FailureDescription failure) Przebieg testu raportów nie został ukończony z powodu błędu opisanego przez |
void | testRunFailed (String errorMessage) Testowanie raportów nie zostało ukończone z powodu błędu krytycznego. |
void | testRunStarted (String name, int numTests, int attemptNumber) Zgłasza początek przebiegu testowego. |
void | testRunStarted (String name, int numTests) Zgłasza początek przebiegu testowego. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Zgłasza początek przebiegu testowego. |
void | testRunStopped (long elapsedTime) Przebieg testu raportów został zatrzymany przed zakończeniem z powodu żądania użytkownika. |
void | testStarted ( TestDescription test, long startTime) Alternatywa dla |
void | testStarted ( TestDescription test) Raportuje początek pojedynczego przypadku testowego. |
Metody chronione | |
---|---|
final void | clearModuleLogFiles () Umożliwia wyczyszczenie pliku modułów, dzięki czemu unikniemy ich noszenia zbyt długo. |
final void | clearResultsForName (String testRunName) Pozwala wyczyścić wyniki dla podanej nazwy biegu. |
void | setIsAggregrateMetrics (boolean aggregate) Przełącz opcję „zagreguj dane”. |
Konstruktory publiczne
ZbieranieTestListener
public CollectingTestListener ()
Metody publiczne
pobierz informacje o kompilacji
public IBuildInfo getBuildInfo ()
Ta metoda jest przestarzała.
polegać na IBuildInfo
z getInvocationContext()
.
Zwraca informacje o kompilacji.
Zwroty | |
---|---|
IBuildInfo |
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
Pobiera wyniki dla bieżącego przebiegu testu.
Uwaga: wyniki mogą nie być kompletne. Zaleca się przetestowanie wartości TestRunResult.isRunComplete()
i/lub (@link TestRunResult#isRunFailure()} przed przetworzeniem wyników.
Zwroty | |
---|---|
TestRunResult | TestRunResult reprezentujący dane zebrane podczas ostatniego uruchomienia 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 |
getInvocationContext
public IInvocationContext getInvocationContext ()
Zwróć kontekst wywołania, który został zgłoszony przez invocationStarted(com.android.tradefed.invoker.IInvocationContext)
Zwroty | |
---|---|
IInvocationContext |
getMergedTestRunResults
publicgetMergedTestRunResults ()
Zwróć scaloną kolekcję wyników dla wszystkich przebiegów w różnych próbach.
Jeśli istnieje wiele wyników, każdy przebieg testu jest scalany, 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ą połączone na podstawie preferencji ustawionej przez aggregate-metrics
. Ostateczne metryki będą metrykami ostatniej próby.
Zwroty | |
---|---|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Zwraca IInvocationContext
modułu skojarzonego z wynikami.
Parametry | |
---|---|
testRunName | String : Nazwa podana 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ą wszystkie zarejestrowane pliki powiązane 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 testu lub modułem.
Zwroty | |
---|---|
MultiMap <String, LogFile > |
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Zwraca całkowitą liczbę przebiegów testu w stanie niepowodzenia
Zwroty | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Zwraca całkowitą liczbę testów w stanie niepowodzenia (tylko nieudane, awarie założenia nie są wliczane do tego stanu).
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 łączną liczbę pełnych testów dla wszystkich przebiegów.
Zwroty | |
---|---|
int |
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
Zwróć podstawowe informacje o kompilacji, które zostały zgłoszone przez 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 (brak kompilacji do przypadku testowego).
Zwroty | |
---|---|
IBuildInfo |
getRunResults
publicgetRunResults ()
Ta metoda jest przestarzała.
Użyj funkcji 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 podana przez { testRunStarted(String, int) . |
attempt | int : Identyfikator próby. |
Zwroty | |
---|---|
TestRunResult | TestRunResult dla podanej nazwy i identyfikator próby lub null , jeśli nie istnieje. |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Zwraca liczbę prób dla danej nazwy uruchomienia testu.
Parametry | |
---|---|
testRunName | String : Nazwa podana przez { testRunStarted(String, int) . |
Zwroty | |
---|---|
int |
getTestRunPróby
publicgetTestRunAttempts (String testRunName)
Pobiera wszystkie próby dla TestRunResult
danego przebiegu testu.
Parametry | |
---|---|
testRunName | String : Nazwa podana przez { testRunStarted(String, int) . |
Zwroty | |
---|---|
Wszystkie TestRunResult dla danego przebiegu testu, 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 dla wszystkich przebiegów testowych.
Te przebiegi testowe mogły zostać uruchomione wiele razy z różnymi próbami.
Zwroty | |
---|---|
manieudanetesty
public boolean hasFailedTests ()
Zwraca, jeśli wywołanie miało jakiekolwiek testy zakończone niepowodzeniem lub przy założeniu, że zakończyły się niepowodzeniem.
Zwroty | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Zwraca, czy dana nazwa przebiegu testu ma jakieś wyniki.
Parametry | |
---|---|
testRunName | String : Nazwa podana przez { testRunStarted(String, int) . |
Zwroty | |
---|---|
boolean |
wywołanie zakończone
public void invocationEnded (long elapsedTime)
Zgłasza, że wywołanie zakończyło się pomyślnie lub z powodu błędu.
Zostanie automatycznie wywołany przez platformę TradeFederation.Parametry | |
---|---|
elapsedTime | long : czas, który upłynął od wywołania 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 : przyczyna niepowodzenia ERROR(/Throwable) |
wywołanie rozpoczęte
public void invocationStarted (IInvocationContext context)
Zgłasza początek wywołania testowego.
Zostanie automatycznie wywołany przez platformę TradeFederation. Reporterzy muszą zastąpić tę metodę, aby obsługiwać raportowanie wielu urządzeń.
Parametry | |
---|---|
context | IInvocationContext : informacje o wywołaniu |
jest niepełnosprawny
public boolean isDisabled ()
Zwraca True, jeśli cały obiekt jest wyłączony (pomiń zarówno konfigurację, jak i demontaż). Fałsz inaczej.
Zwroty | |
---|---|
boolean |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego na bezpośrednim 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 jawnie zapewnić silne powiązanie.
Parametry | |
---|---|
dataName | String : nazwa danych |
logFile | LogFile : LogFile , który był wcześniej rejestrowany i powinien być powiązany z przypadkiem testowym. |
ustaw informacje o kompilacji
public void setBuildInfo (IBuildInfo buildInfo)
Ta metoda jest przestarzała.
Nie jest już potrzebny do testów.
Ustaw informacje o kompilacji. Powinien być używany tylko do testów.
Parametry | |
---|---|
buildInfo | IBuildInfo |
ustaw Wyłącz
public void setDisable (boolean isDisabled)
Ustawia, czy obiekt powinien być wyłączony. Wyłączona oznacza, że należy pominąć kroki konfiguracji i demontażu. Można użyć do domyślnego wyłączenia obiektu w domyślnym konstruktorze.
Parametry | |
---|---|
isDisabled | boolean : stan, w którym obiekt powinien zostać umieszczony. |
ustaw strategię scalania
public void setMergeStrategy (MergeStrategy strategy)
Ustawia MergeStrategy
do użycia podczas scalania wyników.
Parametry | |
---|---|
strategy | MergeStrategy |
testZałożenieNiepowodzenie
public void testAssumptionFailure (TestDescription test, String trace)
Wywoływana, gdy test atomowy oznacza, ż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 oznacza, że zakłada warunek, który jest fałszywy
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
failure | FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
test zakoń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ą ERROR(/System#currentTimeMillis()) |
testMetrics | ERROR(/Map) emitowanych metryk |
test zakończony
public void testEnded (TestDescription test,testMetrics)
Zgłasza koniec wykonania pojedynczego przypadku testowego.
Jeśli testFailed(TestDescription, FailureDescription)
nie został wywołany, ten test zakończył się pomyślnie. Zwraca również wszelkie metryki klucza/wartości, 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 awarię pojedynczego przypadku testowego.
Zostanie wywołany między testStarted a testEnded.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
failure | FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
Test nieudany
public void testFailed (TestDescription test, String trace)
Zgłasza awarię pojedynczego przypadku testowego.
Zostanie wywołany między testStarted a testEnded.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
trace | String : ślad stosu awarii |
zignorowano test
public void testIgnored (TestDescription test)
Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
testModuleEnd
public void testModuleEnded ()
Zgłasza koniec uruchomienia modułu.
moduł testowyrozpoczęty
public void testModuleStarted (IInvocationContext moduleContext)
Zgłasza początek uruchomionego modułu. To wywołanie zwrotne jest powiązane z testModuleEnded()
i jest opcjonalne w sekwencji. Jest używany tylko podczas biegu, który korzysta z modułów: biegaczy opartych na pakietach.
Parametry | |
---|---|
moduleContext | IInvocationContext : IInvocationContext modułu. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Zgłasza koniec przebiegu testowego. FIXME: Nie możemy mieć dwóch różnych interfejsów Map<>, więc musimy tutaj użyć HashMap.
Parametry | |
---|---|
elapsedTime | long : czas, który upłynął od urządzenia, w milisekundach |
runMetrics | Metric . |
testRunNie powiodło się
public void testRunFailed (FailureDescription failure)
Przebieg testu raportów nie został ukończony z powodu błędu opisanego przez FailureDescription
.
Parametry | |
---|---|
failure | FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
testRunNie powiodło się
public void testRunFailed (String errorMessage)
Testowanie raportów nie zostało ukończone z powodu błędu krytycznego.
Parametry | |
---|---|
errorMessage | String : ERROR(/String) opisujący przyczynę niepowodzenia uruchomienia. |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber)
Zgłasza początek przebiegu testowego.
Parametry | |
---|---|
name | String : nazwa uruchomienia testu |
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 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest ponawiany 3 razy w trybie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3. |
testRunStarted
public void testRunStarted (String name, int numTests)
Zgłasza początek przebiegu testowego.
Parametry | |
---|---|
name | String : nazwa uruchomienia testu |
numTests | int : całkowita liczba testów w przebiegu testu |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Zgłasza początek przebiegu testowego.
Parametry | |
---|---|
name | String : nazwa uruchomienia testu |
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 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest ponawiany 3 razy w trybie granularnym, powinien mieć łącznie 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ą ERROR(/System#currentTimeMillis()) |
testRunZatrzymany
public void testRunStopped (long elapsedTime)
Przebieg testu raportów został zatrzymany przed zakończeniem z powodu żądania użytkownika.
DO ZROBIENIA: obecnie nieużywane, rozważ usunięcie
Parametry | |
---|---|
elapsedTime | long : czas, który upłynął od urządzenia, w milisekundach |
testRozpoczęty
public void testStarted (TestDescription test, long startTime)
Alternatywa dla testStarted(com.android.tradefed.result.TestDescription)
, gdzie również określamy kiedy test został uruchomiony, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
dla dokładnego pomiaru .
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
startTime | long : czas rozpoczęcia testu, mierzony za pomocą ERROR(/System#currentTimeMillis()) |
testRozpoczęty
public void testStarted (TestDescription test)
Raportuje początek pojedynczego przypadku testowego. Starszy interfejs powinien używać testStarted(com.android.tradefed.result.TestDescription)
gdy tylko jest to możliwe.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
Metody chronione
wyczyść pliki dziennika modułów
protected final void clearModuleLogFiles ()
Umożliwia wyczyszczenie pliku modułów, dzięki czemu unikniemy ich noszenia zbyt długo.
wyczyśćResultsForName
protected final void clearResultsForName (String testRunName)
Pozwala wyczyścić wyniki dla podanej nazwy biegu. Powinien być używany tylko w niektórych przypadkach, jak agregator wyników.
Parametry | |
---|---|
testRunName | String |
setIsAgggrerateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Przełącz opcję „zagreguj dane”.
Parametry | |
---|---|
aggregate | boolean |