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 |
TestRunResult
|
getCurrentRunResults()
Pobiera wyniki bieżącego testu. |
int
|
getExpectedTests()
Zwraca liczbę oczekiwanych testów. |
IInvocationContext
|
getInvocationContext()
Zwraca kontekst wywołania zgłoszonego za pomocą |
|
getMergedTestRunResults()
Zwraca złączoną kolekcję wyników wszystkich przebiegów w różnych próbach. |
IInvocationContext
|
getModuleContextForRunResult(String testRunName)
Zwraca |
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ą |
|
getRunResults()
Ta metoda została wycofana.
Użyj |
TestRunResult
|
getTestRunAtAttempt(String testRunName, int attempt)
Zwracaj |
int
|
getTestRunAttemptCount(String testRunName)
Zwraca liczbę prób dla danej nazwy testu. |
|
getTestRunAttempts(String testRunName)
Pobiera wszystkie próby |
|
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 |
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 |
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,
Alternatywa dla |
void
|
testEnded(TestDescription test,
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,
Raportuje zakończenie testu. |
void
|
testRunFailed(FailureDescription failure)
Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w |
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 |
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 IBuildInfo
z getInvocationContext()
.
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
publicgetMergedTestRunResults ()
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 |
IInvocationContext modułu dla danej nazwy testu null jeś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
publicgetRunResults ()
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
publicgetTestRunAttempts (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
publicgetTestRunForAttempts (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
publicgetTestRunNames ()
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 |