CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener


ITestInvocationListener, który będzie zawierać wszystkie wyniki testu.

Chociaż struktury danych używane w tym obiekcie są bezpieczne dla wątków, wywołania zwrotne ITestInvocationListener muszą być wywoływane w prawidłowej kolejności.

Podsumowanie

Konstruktory publiczne

CollectingTestListener()

Metody publiczne

IBuildInfo getBuildInfo()

Ta metoda została wycofana. polegać na IBuildInfogetInvocationContext().

TestRunResult getCurrentRunResults()

Pobiera wyniki bieżącego uruchomienia testu.

int getExpectedTests()

Zwraca oczekiwaną liczbę testów.

IInvocationContext getInvocationContext()

Zwraca kontekst wywołania, który został zgłoszony za pomocą invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults()

Zwraca złączoną kolekcję wyników wszystkich przebiegów w różnych próbach.

IInvocationContext getModuleContextForRunResult(String testRunName)

Zwraca IInvocationContext modułu powiązanego z wynikami.

MultiMap<String, LogFile> getModuleLogFiles()

Zwraca kopię mapy zawierającą wszystkie pliki z rejestrowanymi zdarzeniami powiązane z modułem.

MultiMap<String, LogFile> getNonAssociatedLogFiles()

Zwraca kopię mapy zawierającą wszystkie pliki z dziennikiem, które nie są powiązane z testem ani z modułem.

int getNumAllFailedTestRuns()

Zwraca łączną liczbę uruchomień testu w stanie niepowodzenia.

int getNumAllFailedTests()

Zwraca łączną liczbę testów w stanie nieudanym (uwzględniane są tylko nieudane testy, a nie błędy w założeniach).

int getNumTestsInState(TestStatus status)

Zwraca liczbę testów w danym stanie w ramach tego uruchomienia.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

Zgodność ze starszymi typami stanu

int getNumTotalTests()

Zwraca łączną liczbę ukończonych testów dla wszystkich przebiegów.

IBuildInfo getPrimaryBuildInfo()

Zwraca główne informacje o kompilacji zgłoszone w usłudze invocationStarted(com.android.tradefed.invoker.IInvocationContext).

getRunResults()

Ta metoda została wycofana. Użyj getMergedTestRunResults().

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

Zwracaj TestRunResult za każdą próbę.

int getTestRunAttemptCount(String testRunName)

Zwraca liczbę prób dla danej nazwy testu.

getTestRunAttempts(String testRunName)

Pobiera wszystkie próby TestRunResult danego przebiegu testu.

getTestRunForAttempts(int attempt)

Pobiera wszystkie wyniki dla danej próby.

getTestRunNames()

Zwraca wszystkie nazwy wszystkich testów.

boolean hasFailedTests()

Zwraca informacje o tym, czy wywołanie miało jakieś nieudane testy lub nieudane testy założeń.

boolean hasTestRunResultsForName(String testRunName)

Zwraca informacje o tym, czy podana nazwa testu zawiera jakieś wyniki.

void invocationEnded(long elapsedTime)

Raport o zakończeniu wywołania (z powodu błędu lub bez błędu).

void invocationFailed(Throwable cause)

Zgłasza niepełne wywołanie z powodu błędu.

void invocationSkipped(SkipReason reason)

zgłasza wywołanie jako pominięte;

void invocationStarted(IInvocationContext context)

Raportuje rozpoczęcie wywołania testu.

boolean isDisabled()

Zwraca wartość Prawda, jeśli cały obiekt jest wyłączony (pomiń zarówno konfigurację, jak i dezaktywację).

void logAssociation(String dataName, LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale nie można tego zrobić bezpośrednio w wywołaniu testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).

void setBuildInfo(IBuildInfo buildInfo)

Ta metoda została wycofana. Nie są już potrzebne do testowania.

void setDisable(boolean isDisabled)

Określa, czy obiekt ma być wyłączony.

void setMergeStrategy(MergeStrategy strategy)

Określa MergeStrategy, który ma być używany podczas łączenia wyników.

void testAssumptionFailure(TestDescription test, String trace)

Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości.

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości.

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.

void testEnded(TestDescription test, testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testu.

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ływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.

void testModuleEnded()

Raportuje zakończenie działania modułu.

void testModuleStarted(IInvocationContext moduleContext)

zgłasza rozpoczęcie działania modułu.

void testRunEnded(long elapsedTime, runMetrics)

Raportuje zakończenie testu.

void testRunFailed(FailureDescription failure)

Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription.

void testRunFailed(String errorMessage)

Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.

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

Raportuje rozpoczęcie testu.

void testRunStarted(String name, int numTests)

Raportuje rozpoczęcie testu.

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

Raportuje rozpoczęcie testu.

void testRunStopped(long elapsedTime)

Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.

void testSkipped(TestDescription test, SkipReason reason)

Wywoływane, gdy test został pominięty i nie został wykonany z przyczyn, które zwykle nie są oczekiwane.

void testStarted(TestDescription test, long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.

void testStarted(TestDescription test)

Raportuje rozpoczęcie indywidualnego przypadku testowego.

Chronione metody

final void clearModuleLogFiles()

Umożliwia czyszczenie pliku modułu, aby nie przechowywać ich zbyt długo.

final void clearResultsForName(String testRunName)

Umożliwia wyczyszczenie wyników dla danego nazwy procesu.

void setIsAggregrateMetrics(boolean aggregate)

Przełącz opcję „Zagregowane wskaźniki”

Konstruktory publiczne

CollectingTestListener

public CollectingTestListener ()

Metody publiczne

getBuildInfo

public IBuildInfo getBuildInfo ()

Ta metoda została wycofana.
korzystają z IBuildInfo z getInvocationContext().

Zwraca informacje o kompilacji.

Zwroty
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Pobiera wyniki bieżącego uruchomienia testu.

Pamiętaj, że wyniki mogą być niepełne. Przed przetworzeniem wyników zalecamy przetestowanie wartości TestRunResult.isRunComplete() lub (@link TestRunResult#isRunFailure()).

Zwroty
TestRunResult TestRunResult reprezentujące dane zebrane podczas ostatniego uruchomienia testu.

getExpectedTests

public int getExpectedTests ()

Zwraca liczbę oczekiwanych testów. Może się różnić od getNumTotalTests(), jeśli niektóre testy nie zostały uruchomione.

Zwroty
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Zwraca kontekst wywołania zgłoszony za pomocą funkcji invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Zwroty
IInvocationContext

getMergedTestRunResults (Wyniki testów)

public  getMergedTestRunResults ()

Zwraca złączoną kolekcję wyników wszystkich przebiegów w różnych próbach.

Jeśli pojawi się wiele wyników, każde uruchomienie testu zostanie scalone, a najnowszy wynik zastąpi wyniki z poprzednich uruchomień. Przebiegi testów są uporządkowane według numeru próby.

Dane dotyczące tej samej próby zostaną scalone na podstawie ustawień preferencji określonych przez aggregate-metrics. Ostateczne dane to dane z ostatniej próby.

Zwroty

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Zwraca IInvocationContext modułu powiązanego z wynikami.

Parametry
testRunName String: nazwa podana przez użytkownika {testRunStarted(String, int).

Zwroty
IInvocationContext IInvocationContextmodułu dla danej nazwy testu nulljeśli nie ma wyników dla tej nazwy.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Zwraca kopię mapy zawierającą wszystkie pliki z rejestrowanymi zdarzeniami powiązane z modułem.

Zwroty
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Zwraca kopię mapy zawierającą wszystkie pliki z dziennikiem, które nie są powiązane z testem ani z modułem.

Zwroty
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Zwraca łączną liczbę uruchomień testu w stanie niepowodzenia.

Zwroty
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Zwraca łączną liczbę testów, w przypadku których wystąpił błąd (tylko nieudane – błędy założeń nie są do niego wliczane).

Zwroty
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Zwraca liczbę testów w danym stanie w ramach tego uruchomienia.

Parametry
status TestStatus

Zwroty
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Zgodność ze starszymi typami stanu

Parametry
ddmlibStatus TestResult.TestStatus

Zwroty
int

getNumTotalTests

public int getNumTotalTests ()

Zwraca łączną liczbę ukończonych testów dla wszystkich przebiegów.

Zwroty
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Zwraca informacje o głównej wersji, które zostały zgłoszone za pomocą invocationStarted(com.android.tradefed.invoker.IInvocationContext). Kompilacja podstawowa to kompilacja zwracana przez pierwszego dostawcę kompilacji dla bieżącej konfiguracji. Zwraca wartość null, jeśli nie ma kontekstu (nie ma kompilacji do testu).

Zwroty
IBuildInfo

getRunResults

public  getRunResults ()

Ta metoda została wycofana.
Użyj getMergedTestRunResults()

Zwraca wyniki wszystkich testów.

Zwroty

getTestRunAtStep

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Zwracaj TestRunResult za każdą próbę.

Parametry
testRunName String: nazwa podana przez użytkownika {testRunStarted(String, int).

attempt int: identyfikator próby.

Zwroty
TestRunResult TestRunResult dla danej nazwy i identyfikatora próby lub null, jeśli nie istnieje.

getTestRunStepCount

public int getTestRunAttemptCount (String testRunName)

Zwraca liczbę prób dla danej nazwy testu.

Parametry
testRunName String: nazwa podana przez użytkownika {testRunStarted(String, int).

Zwroty
int

Próby getTestRun

public  getTestRunAttempts (String testRunName)

Pobiera wszystkie próby TestRunResult danego przebiegu testu.

Parametry
testRunName String: nazwa podana przez użytkownika {testRunStarted(String, int).

Zwroty
Wszystkie TestRunResult dla danego przebiegu testu, posortowane według prób.

getTestRunForMultiples

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 ()

Zwraca wszystkie nazwy wszystkich uruchomień testowych.

Te testy mogły być przeprowadzane wielokrotnie z różnymi próbami.

Zwroty

Testy nieudane

public boolean hasFailedTests ()

Zwraca wyniki, jeśli wywołanie nie zakończyło się niepowodzeniem lub zakończyło się niepowodzeniem.

Zwroty
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Zwraca informacje o tym, czy podana nazwa testu zawiera jakieś wyniki.

Parametry
testRunName String: nazwa podana przez użytkownika {testRunStarted(String, int).

Zwroty
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

Raport o zakończeniu wywołania (z powodu błędu lub bez błędu).

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
elapsedTime long: upłynął czas wywołania w ms

invocationFailed

public void invocationFailed (Throwable cause)

zgłasza niepełne wywołanie z powodu błędu.

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
cause Throwable: przyczyna niepowodzenia Throwable

invocationSkipped

public void invocationSkipped (SkipReason reason)

zgłasza wywołanie jako pominięte;

Parametry
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Raportuje rozpoczęcie wywołania testu.

Będzie wywoływany automatycznie przez platformę TradeFederation. Aby umożliwić raportowanie z kilku urządzeń, autorzy raportów muszą zastąpić tę metodę.

Parametry
context IInvocationContext: informacje o wywołaniu;

isDisabled

public boolean isDisabled ()

Zwraca wartość Prawda, jeśli cały obiekt jest wyłączony (pomiń zarówno konfigurację, jak i dezaktywację). W przeciwnym razie ma wartość Fałsz.

Zwroty
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkiem testowym, ale nie można tego zrobić w przypadku bezpośredniego wywołania zwrotnego testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). Dzięki temu wywołaniu zwrotnemu można wyraźnie powiązać dane.

Parametry
dataName String: nazwa danych

logFile LogFile: LogFile, który został wcześniej zarejestrowany i powinien być powiązany z przypadkiem testu.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Ta metoda została wycofana.
Nie są już potrzebne do testowania.

Ustaw informacje o kompilacji. Należy używać tylko do testowania.

Parametry
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

Określa, czy obiekt ma być wyłączony. Wyłączone oznacza, że należy pominąć zarówno etap konfiguracji, jak i demontażu. Może być używany do wyłączenia obiektu domyślnie w konstrukcji domyślnej.

Parametry
isDisabled boolean: stan, w którym powinien znajdować się obiekt.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Określa, czy MergeStrategy ma być używany do scalania wyników.

Parametry
strategy MergeStrategy

Niepowodzenie testuZałożenia Niepowodzeń

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości.

Parametry
test TestDescription: identyfikuje test

trace String: zrzut stosu błędu

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości.

Parametry
test TestDescription: identyfikuje test

failure FailureDescription: FailureDescription opisujący błąd 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. Aby uzyskać dokładne pomiary, połącz je z elementem testStarted(com.android.tradefed.result.TestDescription, long).

Parametry
test TestDescription: identyfikuje test

endTime long: czas zakończenia testu (mierzony w polu System.currentTimeMillis()).

testMetrics : ERROR(/Map) wyemitowanych wskaźników

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testu.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test zaliczony. Zwraca też wszystkie dane klucz-wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
test TestDescription: identyfikuje test

testMetrics : ERROR(/Map) danych wyemitowanych

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Jest wywoływana między testStarted a testEnded.

Parametry
test TestDescription: identyfikuje test

failure FailureDescription: FailureDescription opisujący błąd i jego kontekst.

Niepowodzenie testu

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Jest wywoływana między testStarted a testEnded.

Parametry
test TestDescription: identyfikuje test

trace String: zrzut stosu niepowodzenia

testIgnored

public void testIgnored (TestDescription test)

Wywoływana, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.ignore.

Parametry
test TestDescription: identyfikuje test

testModuleEnded

public void testModuleEnded ()

Raportuje koniec wykonania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

zgłasza rozpoczęcie działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas wykonywania testu, który korzysta z modułów: modułów opartych na zestawach.

Parametry
moduleContext IInvocationContext: IInvocationContext modułu.

Zakończono bieg testowy

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Raportuje zakończenie testu.

Parametry
elapsedTime long: czas, który upłynął od urządzenia, w milisekundach

runMetrics : pary klucz-wartość raportowane na koniec testu.

Niepowodzenie testu uruchomienia

public void testRunFailed (FailureDescription failure)

Nie udało się wykonać testu raportów z powodu błędu opisanego w atrybucie FailureDescription.

Parametry
failure FailureDescription: FailureDescription opisujący błąd i jego kontekst.

testRunFailed

public void testRunFailed (String errorMessage)

Nie udało się wykonać testu raportów z powodu błędu krytycznego.

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

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
name String: nazwa testu;

numTests int: łączna liczba testów w sesji testowej

attemptNumber int: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. Wartość orderNumber ma wartość 0 zindeksowana i powinna wzrastać przy każdym nowym uruchomieniu. Na przykład: 3 próby są szczegółowo ponawiane, powinny mieć łącznie 4 uruchomienia w ramach tej samej nazwy runName, a wartość orderNumber musi mieścić się w przedziale od 0 do 3.

Uruchomiono test

public void testRunStarted (String name, 
                int numTests)

Raportuje rozpoczęcie testu.

Parametry
name String: nazwa testu;

numTests int: łączna liczba testów w sesji testowej

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
name String: nazwa testu;

numTests int: łączna liczba testów w sesji testowej

attemptNumber int: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tym samym runName, a attemptNumber powinien mieć wartość od 0 do 3.

startTime long: czas rozpoczęcia uruchomienia (mierzony w polu System.currentTimeMillis())

Zatrzymano uruchomienie testu

public void testRunStopped (long elapsedTime)

Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.

TODO: currently unused, consider removing

Parametry
elapsedTime long: czas, który upłynął od urządzenia, w milisekundach

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu. Te testy zostaną powtórzone, aby sprawdzić, czy tym razem zostaną wykonane prawidłowo.

Parametry
test TestDescription: identyfikuje test

reason SkipReason: SkipReason

testStarted (rozpoczęto test)

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.

Parametry
test TestDescription: identyfikuje test

startTime long: czas rozpoczęcia testu (określony za pomocą parametru System.currentTimeMillis()).

testStarted (rozpoczęto test)

public void testStarted (TestDescription test)

Raportuje początek pojedynczego przypadku testowego. Starszy interfejs, którego należy używać w miarę możliwości w przypadku testStarted(com.android.tradefed.result.TestDescription).

Parametry
test TestDescription: identyfikuje test

Chronione metody

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Umożliwia czyszczenie pliku modułu, aby nie przechowywać ich zbyt długo.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Umożliwia wyczyszczenie wyników dla danego nazwy procesu. Należy używać tylko w niektórych przypadkach, np. jako agregator wyników.

Parametry
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Przełącz opcję „Zagregowane wskaźniki”

Parametry
aggregate boolean