CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

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


ITestInvocationListener, który będzie zbierać 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 odpowiedniej kolejności.

Podsumowanie

Konstruktory publiczne

CollectingTestListener()

Metody publiczne

IBuildInfo getBuildInfo()

Ta metoda została wycofana. korzystać z IBuildInfogetInvocationContext().

TestRunResult getCurrentRunResults()

Pobiera wyniki bieżącego testu.

int getExpectedTests()

Zwraca liczbę oczekiwanych testów.

IInvocationContext getInvocationContext()

Zwraca kontekst wywołania zgłoszony za pomocą invocationStarted(IInvocationContext)

List<TestRunResult> getMergedTestRunResults()

Zwraca scaloną kolekcję wyników wszystkich uruchomień w ramach różnych prób.

IInvocationContext getModuleContextForRunResult(String testRunName)

Zwraca IInvocationContext modułu powiązanego z wynikami.

MultiMap<String, LogFile> getModuleLogFiles()

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

MultiMap<String, LogFile> getNonAssociatedLogFiles()

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

int getNumAllFailedTestRuns()

Zwraca łączną liczbę uruchomień testów w stanie błędu.

int getNumAllFailedTests()

Zwraca łączną liczbę testów w stanie błędu (tylko nieudane testy, błędy założeń nie są wliczane).

int getNumTestsInState(TestStatus status)

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

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

Zgodność ze starszym typem stanu

int getNumTotalTests()

Zwraca łączną liczbę ukończonych testów we wszystkich uruchomieniach.

IBuildInfo getPrimaryBuildInfo()

Zwraca podstawowe informacje o kompilacji zgłoszone za pomocą invocationStarted(IInvocationContext).

Collection<TestRunResult> getRunResults()

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

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

Zwróć TestRunResult, aby spróbować jeszcze raz.

int getTestRunAttemptCount(String testRunName)

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

List<TestRunResult> getTestRunAttempts(String testRunName)

Pobiera wszystkie próby dla TestRunResult w danym przebiegu testu.

List<TestRunResult> getTestRunForAttempts(int attempt)

Pobiera wszystkie wyniki dla danej próby.

Collection<String> getTestRunNames()

Zwróć wszystkie nazwy wszystkich przebiegów testu.

boolean hasFailedTests()

Zwraca informację, czy w wywołaniu były jakieś testy, które się nie powiodły lub których założenia się nie sprawdziły.

boolean hasTestRunResultsForName(String testRunName)

Zwraca informację, czy dana nazwa testu ma jakieś wyniki.

void invocationEnded(long elapsedTime)

Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się ono pomyślnie, czy z powodu błędu.

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

Zgłasza wywołanie jako pominięte

void invocationStarted(IInvocationContext context)

Zgłasza rozpoczęcie wywołania testu.

boolean isDisabled()

Zwraca wartość True, jeśli cały obiekt jest wyłączony (pomija zarówno konfigurację, jak i zamykanie).

void logAssociation(String dataName, LogFile logFile)

W niektórych przypadkach dziennik musi być ściśle powiązany z przypadkami testowymi, ale nie można tego zrobić w bezpośrednim wywołaniu zwrotnym testLogSaved(String,LogDataType,InputStreamSource,LogFile).

void setBuildInfo(IBuildInfo buildInfo)

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

void setDisable(boolean isDisabled)

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

void setMergeStrategy(MergeStrategy strategy)

Ustawia MergeStrategy, który ma być używany podczas scalania wyników.

void testAssumptionFailure(TestDescription test, String trace)

Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy

void testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternatywa dla testEnded(TestDescription,Map), w której możemy bezpośrednio określić czas zakończenia.

void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)

Zgłasza zakończenie wykonania pojedynczego elementu testowania.

void testFailed(TestDescription test, FailureDescription failure)

Zgłasza niepowodzenie pojedynczego elementu testowania.

void testFailed(TestDescription test, String trace)

Zgłasza niepowodzenie pojedynczego elementu testowania.

void testIgnored(TestDescription test)

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

void testModuleEnded()

Zgłasza zakończenie działania modułu.

void testModuleStarted(IInvocationContext moduleContext)

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

void testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)

Zgłasza zakończenie sesji testowej.

void testRunFailed(FailureDescription failure)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu opisanego przez FailureDescription.

void testRunFailed(String errorMessage)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu krytycznego.

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

Zgłasza rozpoczęcie sesji testowej.

void testRunStarted(String name, int numTests)

Zgłasza rozpoczęcie sesji testowej.

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

Zgłasza rozpoczęcie sesji testowej.

void testRunStopped(long elapsedTime)

Zgłasza zatrzymanie sesji testowej przed zakończeniem na prośbę użytkownika.

void testSkipped(TestDescription test, SkipReason reason)

Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana.

void testStarted(TestDescription test, long startTime)

Alternatywa dla testStarted(TestDescription), w której podajemy też datę rozpoczęcia testu, w połączeniu z testEnded(TestDescription,long,Map), aby uzyskać dokładny pomiar.

void testStarted(TestDescription test)

Zgłasza rozpoczęcie pojedynczego elementu testowania.

Metody chronione

final void clearModuleLogFiles()

Umożliwia czyszczenie pliku modułu, aby uniknąć jego zbyt długiego przechowywania.

final void clearResultsForName(String testRunName)

Umożliwia wyczyszczenie wyników dla danej nazwy uruchomienia.

final void clearTestRunResults()

Umożliwia wyczyszczenie wszystkich wyników testu, aby nie przechowywać ich zbyt długo.

void setIsAggregrateMetrics(boolean aggregate)

Przełącz opcję „Agreguj dane”

Konstruktory publiczne

CollectingTestListener

public CollectingTestListener ()

Metody publiczne

getBuildInfo

public IBuildInfo getBuildInfo ()

Ta metoda została wycofana.
korzystać z IBuildInfo od getInvocationContext().

Zwraca informacje o kompilacji.

Zwraca
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()} w odpowiedni sposób.

Zwraca
TestRunResult TestRunResult reprezentujący dane zebrane podczas ostatniego 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.

Zwraca
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Zwraca kontekst wywołania zgłoszony za pomocą invocationStarted(IInvocationContext)

Zwraca
IInvocationContext

getMergedTestRunResults

public List<TestRunResult> getMergedTestRunResults ()

Zwraca scaloną kolekcję wyników wszystkich uruchomień w ramach różnych prób.

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

Dane z tej samej próby zostaną scalone na podstawie preferencji ustawionych przez aggregate-metrics. Ostateczne dane to dane z ostatniej próby.

Zwraca
List<TestRunResult>

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Zwraca IInvocationContext modułu powiązanego z wynikami.

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

Zwraca
IInvocationContext IInvocationContext modułu dla danej nazwy wykonania testu null , jeśli nie ma wyników dla tej nazwy.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

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

Zwraca
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

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

Zwraca
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Zwraca łączną liczbę uruchomień testów w stanie błędu.

Zwraca
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Zwraca łączną liczbę testów w stanie błędu (tylko nieudane testy, błędy założeń nie są wliczane).

Zwraca
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

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

Parametry
status TestStatus

Zwraca
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Zgodność ze starszym typem stanu

Parametry
ddmlibStatus TestResult.TestStatus

Zwraca
int

getNumTotalTests

public int getNumTotalTests ()

Zwraca łączną liczbę ukończonych testów we wszystkich uruchomieniach.

Zwraca
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Zwraca podstawowe informacje o kompilacji zgłoszone za pomocą invocationStarted(IInvocationContext). Główna kompilacja to kompilacja zwrócona przez pierwszego dostawcę kompilacji w bieżącej konfiguracji. Jeśli nie ma kontekstu (nie ma przypadku testowego do utworzenia), zwraca wartość null.

Zwraca
IBuildInfo

getRunResults

public Collection<TestRunResult> getRunResults ()

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

Zwraca wyniki wszystkich przebiegów testu.

Zwraca
Collection<TestRunResult>

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Zwróć TestRunResult, aby spróbować jeszcze raz.

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

attempt int: identyfikator próby.

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

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

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

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

Zwraca
int

getTestRunAttempts

public List<TestRunResult> getTestRunAttempts (String testRunName)

Pobiera wszystkie próby TestRunResult w ramach danego przebiegu testu.

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

Zwraca
List<TestRunResult> Wszystkie TestRunResult w przypadku danego testu, uporządkowane według liczby prób.

getTestRunForAttempts

public List<TestRunResult> getTestRunForAttempts (int attempt)

Pobiera wszystkie wyniki dla danej próby.

Parametry
attempt int: próba, dla której chcemy uzyskać wyniki.

Zwraca
List<TestRunResult> Wszystkie TestRunResult w przypadku danej próby.

getTestRunNames

public Collection<String> getTestRunNames ()

Zwróć wszystkie nazwy wszystkich przebiegów testu.

Te testy mogły być przeprowadzane wielokrotnie.

Zwraca
Collection<String>

hasFailedTests

public boolean hasFailedTests ()

Zwraca informację, czy w wywołaniu były jakieś testy, które się nie powiodły lub których założenia się nie sprawdziły.

Zwraca
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Zwraca informację, czy dana nazwa przebiegu testu ma jakieś wyniki.

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

Zwraca
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się ono pomyślnie, czy z powodu błędu.

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
elapsedTime long: czas trwania wywołania w milisekundach.

invocationFailed

public void invocationFailed (Throwable cause)

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

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
cause Throwable: Throwable przyczyna niepowodzenia

invocationSkipped

public void invocationSkipped (SkipReason reason)

Zgłasza wywołanie jako pominięte

Parametry
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Zgłasza rozpoczęcie wywołania testu.

Zostanie automatycznie wywołana przez platformę TradeFederation. Aby obsługiwać raportowanie z wielu urządzeń, reporterzy 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 (pomija zarówno konfigurację, jak i zamykanie). W przeciwnym razie ma wartość Fałsz.

Zwraca
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach dziennik musi być ściśle powiązany z przypadkami testowymi, ale nie można tego zrobić w bezpośrednim wywołaniu zwrotnym testLogSaved(String,LogDataType,InputStreamSource,LogFile). Dzięki temu wywołaniu zwrotnemu można wyraźnie określić silne powiązanie.

Parametry
dataName String: nazwa danych

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

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

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

Ustaw informacje o kompilacji. Tej metody 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 kroki konfiguracji, jak i kroki zamykania. Można go użyć, aby domyślnie wyłączyć obiekt w konstruktorze domyślnym.

Parametry
isDisabled boolean: stan, w jakim powinien znajdować się obiekt.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Ustawia MergeStrategy, który ma być używany podczas scalania wyników.

Parametry
strategy MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy

Parametry
test TestDescription: identyfikuje test

trace String: zrzut stosu błędu

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy

Parametry
test TestDescription: identyfikuje test

failure FailureDescription: FailureDescription opisuje błąd i jego kontekst.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternatywa dla testEnded(TestDescription,Map), w której możemy bezpośrednio określić czas zakończenia. Łącz z testStarted(TestDescription,long), aby uzyskać dokładne pomiary.

Parametry
test TestDescription: identyfikuje test

endTime long: czas zakończenia testu mierzony za pomocą System.currentTimeMillis()

testMetrics HashMap: Map danych wygenerowanych

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Zgłasza zakończenie wykonania pojedynczego elementu testowania.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test uznaje się za zaliczony. Zwraca też wszystkie dane klucz/wartość, które mogły zostać wyemitowane podczas wykonywania elementu testowania.

Parametry
test TestDescription: identyfikuje test

testMetrics HashMap: Map danych wygenerowanych

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Zgłasza niepowodzenie pojedynczego elementu testowania.

Wywoływana między testStarted a testEnded.

Parametry
test TestDescription: identyfikuje test

failure FailureDescription: FailureDescription opisuje błąd i jego kontekst.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego elementu testowania.

Wywoływana między testStarted a testEnded.

Parametry
test TestDescription: identyfikuje test

trace String: zrzut stosu błędu

testIgnored

public void testIgnored (TestDescription test)

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

Parametry
test TestDescription: identyfikuje test

testModuleEnded

public void testModuleEnded ()

Zgłasza zakończenie działania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Zgłasza rozpoczęcie działania modułu. Ten wywołanie zwrotne jest powiązane z elementem testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas uruchamiania modułów: narzędzi uruchamiających opartych na pakietach.

Parametry
moduleContext IInvocationContext: IInvocationContext modułu.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Zgłasza zakończenie sesji testowej. FIXME: Nie możemy mieć dwóch interfejsów Map<> z różnymi typami, więc musimy tutaj użyć HashMap.

Parametry
elapsedTime long: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach)

runMetrics HashMap: pary klucz/wartość zgłaszane na zakończenie sesji testowej z parametrem Metric.

testRunFailed

public void testRunFailed (FailureDescription failure)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu opisanego przez FailureDescription.

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

testRunFailed

public void testRunFailed (String errorMessage)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu krytycznego.

Parametry
errorMessage String: String opisuje przyczynę niepowodzenia uruchomienia.

testRunStarted

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

Zgłasza rozpoczęcie sesji testowej.

Parametry
name String: nazwa sesji testowej

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

attemptNumber int: numer zamówienia, który identyfikuje różne próby tego samego uruchomienia runName wykonywanego wielokrotnie. Numer próby jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest ponownie uruchamiany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tą samą nazwą uruchomienia, a numer próby powinien wynosić od 0 do 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Zgłasza rozpoczęcie sesji testowej.

Parametry
name String: nazwa sesji testowej

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

testRunStarted

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

Zgłasza rozpoczęcie sesji testowej.

Parametry
name String: nazwa sesji testowej

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

attemptNumber int: numer zamówienia, który identyfikuje różne próby tego samego uruchomienia runName wykonywanego wielokrotnie. Wartość attemptNumber jest indeksowana od zera i powinna zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Na przykład jeśli test jest ponownie uruchamiany 3 razy, powinien mieć łącznie 4 uruchomienia pod tą samą nazwą runName, a wartość attemptNumber powinna wynosić od 0 do 3.

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

testRunStopped

public void testRunStopped (long elapsedTime)

Zgłasza zatrzymanie sesji testowej przed zakończeniem na prośbę użytkownika.

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

Parametry
elapsedTime long: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach)

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana. Te testy będą ponawiane, aby uzyskać prawidłowe wykonanie.

Parametry
test TestDescription: identyfikuje test

reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(TestDescription), w której podajemy też datę rozpoczęcia testu, w połączeniu z testEnded(TestDescription,long,Map), aby uzyskać dokładny pomiar.

Parametry
test TestDescription: identyfikuje test

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

testStarted

public void testStarted (TestDescription test)

Zgłasza rozpoczęcie pojedynczego elementu testowania. Jest to starszy interfejs; o ile to możliwe, używaj testStarted(TestDescription).

Parametry
test TestDescription: identyfikuje test

Metody chronione

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Umożliwia czyszczenie pliku modułu, aby uniknąć jego zbyt długiego przechowywania.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Umożliwia wyczyszczenie wyników dla danej nazwy uruchomienia. Należy używać tylko w niektórych przypadkach, np. w przypadku agregatora wyników.

Parametry
testRunName String

clearTestRunResults

protected final void clearTestRunResults ()

Umożliwia wyczyszczenie wszystkich wyników testu, aby nie przechowywać ich zbyt długo.

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Przełącz opcję „Agreguj dane”

Parametry
aggregate boolean