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 IBuildInfo z getInvocationContext() .

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 invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults ()

Zwróć scaloną kolekcję wyników dla wszystkich przebiegów w różnych próbach.

IInvocationContext getModuleContextForRunResult (String testRunName)

Zwraca IInvocationContext modułu skojarzonego z wynikami.

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 invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

getRunResults ()

Ta metoda jest przestarzała. Użyj funkcji getMergedTestRunResults()

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

Zwróć TestRunResult dla pojedynczej próby.

int getTestRunAttemptCount (String testRunName)

Zwraca liczbę prób dla danej nazwy uruchomienia testu.

getTestRunAttempts (String testRunName)

Pobiera wszystkie próby dla TestRunResult danego przebiegu testu.

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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) wywołanie zwrotne nie jest możliwe.

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 MergeStrategy do użycia podczas scalania wyników.

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 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) gdzie możemy bezpośrednio określić czas zakończenia.

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 FailureDescription .

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 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 .

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

public  getMergedTestRunResults ()

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

public  getRunResults ()

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

public  getTestRunAttempts (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

public  getTestRunForAttempts (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

public  getTestRunNames ()

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 : pary klucz-wartość zgłaszane na koniec przebiegu testu z 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