ZbieranieTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener , ILogSaverListener

java.lang.Object
com.android.tradefed.result.ZbieranieTestListener


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

Konstruktorzy publiczni

CollectingTestListener ()

Metody publiczne

IBuildInfo getBuildInfo ()

Ta metoda jest przestarzała. polegać na IBuildInfo z getInvocationContext() .

TestRunResult getCurrentRunResults ()

Pobiera wyniki dla bieżącego przebiegu testowego.

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óć scalony zbiór 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ącej wszystkie zarejestrowane pliki powiązane z modułem

MultiMap <String, LogFile > getNonAssociatedLogFiles ()

Zwraca kopię mapy zawierającej wszystkie zarejestrowane pliki, które nie są skojarzone z przebiegiem testowym lub modułem.

int getNumAllFailedTestRuns ()

Zwraca całkowitą liczbę przebiegów testowych w stanie awarii

int getNumAllFailedTests ()

Zwraca całkowitą liczbę testów w stanie niepowodzenia (tylko niepowodzenie, błędy założenia nie wliczają się 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óć informacje o podstawowej kompilacji, które zostały zgłoszone za pośrednictwem invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

getRunResults ()

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

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

Zwróć TestRunResult dla jednej próby.

int getTestRunAttemptCount (String testRunName)

Zwraca liczbę prób dla danej nazwy przebiegu testowego.

getTestRunAttempts (String testRunName)

Pobiera wszystkie próby 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 zakończyło się niepowodzeniem lub założenie nie powiodło się.

boolean hasTestRunResultsForName (String testRunName)

Zwraca czy dana nazwa przebiegu testowego ma jakiekolwiek wyniki.

void invocationEnded (long elapsedTime)

Informuje, ż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 jakiegoś błędu.

void invocationStarted ( IInvocationContext context)

Zgłasza początek wywołania testowego.

void logAssociation (String dataName, LogFile logFile)

W niektórych przypadkach dziennik musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego w bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) nie jest możliwe.

void setBuildInfo ( IBuildInfo buildInfo)

Ta metoda jest przestarzała. Nie jest już konieczne do testowania.

void setMergeStrategy ( MergeStrategy strategy)

Ustawia MergeStrategy do użycia podczas scalania wyników.

void testAssumptionFailure ( TestDescription test, String trace)

Wywoływane, gdy atomowy test zaznaczy, że przyjmuje warunek, który jest fałszywy

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Wywoływane, gdy atomowy test zaznaczy, że przyjmuje 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)

Raportuje zakończenie wykonywania 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, 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 działania modułu.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Raportuje koniec uruchomienia testowego.

void testRunFailed ( FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

void testRunStarted (String name, int numTests, int attemptNumber)

Raportuje początek uruchomienia testowego.

void testRunStarted (String name, int numTests)

Raportuje początek uruchomienia testowego.

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

Raportuje początek uruchomienia testowego.

void testRunStopped (long elapsedTime)

Raporty, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

void testStarted ( TestDescription test, long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, 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 indywidualnego przypadku testowego.

Metody chronione

final void clearModuleLogFiles ()

Umożliwia czyszczenie pliku modułu, dzięki czemu unikamy przenoszenia ich zbyt długo.

final void clearResultsForName (String testRunName)

Pozwala wyczyścić wyniki dla danej nazwy biegu.

void setIsAggregrateMetrics (boolean aggregate)

Przełącz opcję „zagregowane dane”

Konstruktorzy publiczni

ZbieranieTestListener

public CollectingTestListener ()

Metody publiczne

getBuildInfo

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

Pamiętaj, że wyniki mogą nie być kompletne. Zaleca się przetestowanie wartości TestRunResult.isRunComplete() i/lub (@link TestRunResult#isRunFailure()} odpowiednio przed przetworzeniem wyników.

Zwroty
TestRunResult TestRunResult reprezentujący dane zebrane podczas ostatniego uruchomienia testu

Pobierz oczekiwane testy

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óć scalony zbiór wyników dla wszystkich przebiegów w różnych próbach.

Jeśli istnieje wiele wyników, każdy przebieg testowy jest scalany, a najnowszy wynik testu zastępuje wyniki poprzednich przebiegów. Przebiegi testowe są uporządkowane według numeru próby.

Dane dotyczące 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 skojarzonego z wynikami.

Parametry
testRunName String : nazwa nadana przez { testRunStarted(String, int) .

Zwroty
IInvocationContext IInvocationContext modułu dla danej nazwy przebiegu testowego null , jeśli nie ma wyników dla tej nazwy.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Zwraca kopię mapy zawierającej wszystkie zarejestrowane pliki powiązane z modułem

Zwroty
MultiMap <String, LogFile >

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Zwraca kopię mapy zawierającej wszystkie zarejestrowane pliki, które nie są skojarzone z przebiegiem testowym lub modułem.

Zwroty
MultiMap <String, LogFile >

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Zwraca całkowitą liczbę przebiegów testowych w stanie awarii

Zwroty
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Zwraca całkowitą liczbę testów w stanie niepowodzenia (tylko niepowodzenie, błędy założenia nie wliczają się 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

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Zwróć informacje o podstawowej kompilacji, które zostały 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 (brak kompilacji do przypadku testowego).

Zwroty
IBuildInfo

getRunResults

public  getRunResults ()

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

Zwraca wyniki dla wszystkich przebiegów testowych.

Zwroty

getTestRunAtempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Zwróć TestRunResult dla jednej próby.

Parametry
testRunName String : nazwa nadana 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 przebiegu testowego.

Parametry
testRunName String : nazwa nadana przez { testRunStarted(String, int) .

Zwroty
int

GetTestRunPróby

public  getTestRunAttempts (String testRunName)

Pobiera wszystkie próby TestRunResult danego przebiegu testu.

Parametry
testRunName String : nazwa nadana przez { testRunStarted(String, int) .

Zwroty
Wszystkie TestRunResult dla danego przebiegu testu, uporządkowane według prób.

PobierzTestRunForPróby

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 być uruchamiane wiele razy z różnymi próbami.

Zwroty

Testy zakończyły się niepowodzeniem

public boolean hasFailedTests ()

Zwraca, jeśli wywołanie zakończyło się niepowodzeniem lub założenie nie powiodło się.

Zwroty
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Zwraca czy dana nazwa przebiegu testowego ma jakiekolwiek wyniki.

Parametry
testRunName String : nazwa nadana przez { testRunStarted(String, int) .

Zwroty
boolean

inwokacjaZakończona

public void invocationEnded (long elapsedTime)

Informuje, ż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 trwania wywołania w ms

wywołanie nie powiodło się

public void invocationFailed (Throwable cause)

Zgłasza niekompletne wywołanie z powodu jakiegoś błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
cause Throwable : Throwable przyczyna niepowodzenia

wywołanieRozpoczęto

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ć zgłaszanie wielu urządzeń.

Parametry
context IInvocationContext : informacje o wywołaniu

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach dziennik musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego w bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) nie jest możliwe. W ten sposób to wywołanie zwrotne umożliwia jawne zapewnienie silnego skojarzenia.

Parametry
dataName String : nazwa danych

logFile LogFile : 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 testowania.

Ustaw informacje o kompilacji. Powinien być używany tylko do testowania.

Parametry
buildInfo IBuildInfo

setMergeStrategy

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ływane, gdy atomowy test zaznaczy, że przyjmuje 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ływane, gdy atomowy test zaznaczy, że przyjmuje warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego 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)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten 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.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

Test nieudany

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testIgnorowane

public void testIgnored (TestDescription test)

Wywoływane, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

Parametry
test TestDescription : identyfikuje test

testModułZakończony

public void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

testModułUruchomiony

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 używa modułów: biegaczy opartych na pakiecie.

Parametry
moduleContext IInvocationContext : IInvocationContext modułu.

TestUruchomionyZakończony

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Raportuje koniec uruchomienia testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> o różnych typach, więc musimy tutaj użyć HashMap.

Parametry
elapsedTime long : urządzenie zgłosiło czas, który upłynął, w milisekundach

runMetrics : pary klucz-wartość zgłoszone na koniec testu z Metric .

TestUruchomie się nie powiódł

public void testRunFailed (FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

Parametry
failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

TestUruchomie się nie powiódł

public void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

Parametry
errorMessage String : String opisujący przyczynę niepowodzenia uruchomienia.

testUruchomiony

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

Raportuje początek uruchomienia testowego.

Parametry
name String : nazwa uruchomienia testowego

numTests int : całkowita liczba testów w przebiegu testowym

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego 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 powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

testUruchomiony

public void testRunStarted (String name, 
                int numTests)

Raportuje początek uruchomienia testowego.

Parametry
name String : nazwa uruchomienia testowego

numTests int : całkowita liczba testów w przebiegu testowym

testUruchomiony

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Raportuje początek uruchomienia testowego.

Parametry
name String : nazwa uruchomienia testowego

numTests int : całkowita liczba testów w przebiegu testowym

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego 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 powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

startTime long : czas rozpoczęcia biegu, mierzony za pomocą System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Raporty, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

TODO: obecnie nieużywane, rozważ usunięcie

Parametry
elapsedTime long : urządzenie zgłosiło czas, który upłynął, w milisekundach

testRozpoczęto

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, 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ą System.currentTimeMillis()

testRozpoczęto

public void testStarted (TestDescription test)

Raportuje początek indywidualnego 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

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Umożliwia czyszczenie pliku modułu, dzięki czemu unikamy przenoszenia ich zbyt długo.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Pozwala wyczyścić wyniki dla danej nazwy biegu. Powinien być używany tylko w niektórych przypadkach, takich jak agregator wyników.

Parametry
testRunName String

setIsAggregateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Przełącz opcję „zagregowane dane”

Parametry
aggregate boolean