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 testów.

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

int getExpectedTests()

Zwraca liczbę oczekiwanych testów.

IInvocationContext getInvocationContext()

Zwraca kontekst wywołania zgłoszonego 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 niepowodzenia (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 informacje o głównej wersji, które zostały zgłoszone za pomocą 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 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)

Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).

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ść True, jeśli cały obiekt jest wyłączony (pomijanie konfiguracji i demontażu).

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ływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

void testEnded(TestDescription test, long endTime, testMetrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), w której możemy bezpośrednio określić czas zakończenia.

void testEnded(TestDescription test, testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

void testFailed(TestDescription test, FailureDescription failure)

Raportuje niepowodzenie pojedynczego przypadku testowego.

void testFailed(TestDescription test, String trace)

Raportuje 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 koniec wykonania 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ływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu.

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

Chronione metody

final void clearModuleLogFiles()

Umożliwia wyczyszczenie 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ę „Dane zbiorcze”.

Konstruktory publiczne

CollectingTestListener

public CollectingTestListener ()

Metody publiczne

getBuildInfo

public IBuildInfo getBuildInfo ()

Ta metoda została wycofana.
polegaj na IBuildInfogetInvocationContext().

Zwraca informacje o kompilacji.

Zwroty
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Pobiera wyniki bieżącego 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łoszonego za pomocą invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Zwroty
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

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

Jeśli jest ich więcej, każdy przebieg testu jest scalany, a najnowsze wyniki testu zastępują wyniki poprzednich przebiegów. 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 będą pochodzić 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 {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 stanie niepowodzenia (uwzględniane są tylko nieudane testy, a nie błędy w założeniach).

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

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

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

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

attempt int: identyfikator próby.

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

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Zwraca liczbę prób dla danej nazwy testu.

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

Zwroty
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Pobiera wszystkie próby TestRunResult danego testu.

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

Zwroty
Wszystkie TestRunResult dla danego przetestowania, posortowane 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 ()

Zwraca wszystkie nazwy wszystkich testów.

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

Zwroty

hasFailedTests

public boolean hasFailedTests ()

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

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 {testRunStarted(String, int).

Zwroty
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).

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ść True, jeśli cały obiekt jest wyłączony (pomijanie konfiguracji i demontażu). 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 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). 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 testowym.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

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

Ustaw informacje o wersji. Należy ich 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 MergeStrategy, który ma być używany podczas łączenia wyników.

Parametry
strategy MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

Parametry
test TestDescription: identyfikuje test

trace String: zrzut stosu błędu

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

Parametry
test TestDescription: identyfikuje test

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

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), w której 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 za pomocą funkcji System.currentTimeMillis()

testMetrics : ERROR(/Map) danych wyemitowanych

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test się powiedzie. 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)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

Parametry
test TestDescription: identyfikuje test

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

Parametry
test TestDescription: identyfikuje test

trace String: zrzut stosu błędu

testIgnored

public void testIgnored (TestDescription test)

Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu 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.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Raportuje zakończenie testu.

Parametry
elapsedTime long: czas upłynął, milisekundy zgłoszone przez urządzenie

runMetrics : pary klucz-wartość zgłoszone na końcu wykonania testu

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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. attemptNumber jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe wykonanie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 wykonania pod tym samym runName, a attemptNumber będzie miał wartość od 0 do 3.

testRunStarted

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 nazwą runName, a wartość attemptNumber powinna się zmieniać od 0 do 3.

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

testRunStopped

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 upłynął, milisekundy zgłoszone przez urządzenie

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 wszystko się uda.

Parametry
test TestDescription: identyfikuje test

reason SkipReason: SkipReason

testStarted

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 mierzony za pomocą funkcji System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

Raportuje rozpoczęcie pojedynczego testu. 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 wyczyszczenie 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ę „Dane zbiorcze”.

Parametry
aggregate boolean