Przesyłanie wyników
public
class
ResultForwarder
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.ResultForwarder |
ITestInvocationListener
, który przekazuje wyniki wywołania do listy innych odbiorców.
Podsumowanie
Konstruktory publiczne | |
---|---|
ResultForwarder(ITestInvocationListener... listeners)
Alternatywny konstruktor argumentu zmiennej dla |
|
ResultForwarder(
Utwórz |
Konstruktory chronione | |
---|---|
ResultForwarder()
Utwórz |
Metody publiczne | |
---|---|
TestSummary
|
getSummary()
Umożliwia wywołaniu InvocationListener zwrócenie podsumowania. |
void
|
invocationEnded(long elapsedTime)
Raport o zakończeniu wywołania (z powodu błędu lub bez błędu). |
void
|
invocationFailed(FailureDescription failure)
zgłasza niepełne wywołanie z powodu 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 początek wywołania testu. |
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 testu. |
void
|
testFailed(TestDescription test, FailureDescription failure)
Raportuje 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
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Zawiera powiązane dane dziennika lub debugowania z wywołania testu. |
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ę wykonać testu raportów z powodu błędu opisanego w atrybucie |
void
|
testRunFailed(String errorMessage)
Nie udało się wykonać testu raportów z powodu błędu krytycznego. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Raportuje rozpoczęcie testu. |
void
|
testRunStarted(String runName, int testCount)
Raportuje rozpoczęcie testu. |
void
|
testRunStarted(String runName, int testCount, 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 parametru |
void
|
testStarted(TestDescription test)
Raportuje początek pojedynczego przypadku testowego. |
Chronione metody | |
---|---|
|
getListeners()
Pobierz listę słuchaczy. |
void
|
setListeners(ITestInvocationListener... listeners)
Ustaw słuchaczy po zakończeniu budowy. |
void
|
setListeners(
Ustaw słuchaczy po zakończeniu budowy. |
Konstruktory publiczne
Przekazywanie wyników
public ResultForwarder (ITestInvocationListener... listeners)
Alternatywny konstruktor argumentu zmiennej dla ResultForwarder
.
Parametry | |
---|---|
listeners |
ITestInvocationListener : prawdziwe ITestInvocationListener , do których mają być przesyłane wyniki |
Przesyłanie wyników
public ResultForwarder (listeners)
Utwórz ResultForwarder
.
Parametry | |
---|---|
listeners |
: prawdziwe ITestInvocationListener , do których mają być przesyłane wyniki |
Konstruktory chronione
Przesyłanie wyników
protected ResultForwarder ()
Utwórz ResultForwarder
z ustawieniem odroczonego detektora. Przeznaczona tylko do użytku przez podklasy.
Metody publiczne
getSummary
public TestSummary getSummary ()
Umożliwia usłudze InvocationListener zwrócenie podsumowania.
Zwroty | |
---|---|
TestSummary |
TestSummary podsumowujący wykonanie, lub wartość null. |
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 : czas, jaki upłynął wywołania w milisekundach, |
invocationFailed
public void invocationFailed (FailureDescription failure)
zgłasza niepełne wywołanie z powodu błędu.
Będzie wywoływany automatycznie przez platformę TradeFederation.
Parametry | |
---|---|
failure |
FailureDescription : FailureDescription opisujący przyczynę niepowodzenia |
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 |
Wywołanie pominięte
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; |
Niepowodzenie testuZałożenia Niepowodzeń
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 metody ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, w której można bezpośrednio podać godzinę zakończenia. Aby uzyskać dokładny pomiar, połącz go z polem testStarted(com.android.tradefed.result.TestDescription, long)
.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
endTime |
long : czas zakończenia testu mierzony za pomocą System.currentTimeMillis() |
testMetrics |
: ERROR(/Map) danych wyemitowanych |
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 również wszystkie wskaźniki klucz-wartość, które mogły zostać wygenerowane podczas wykonywania przypadku testowego.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
testMetrics |
: ERROR(/Map) danych wyemitowanych |
Niepowodzenie testu
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 |
testignorowany
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 |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Podaje powiązany dziennik lub dane debugowania z wywołania testu.
Musi być wywołany przed ERROR(/ITestInvocationListener#invocationFailed(Throwable))
lub ERROR(/ITestInvocationListener#invocationEnded(long))
Framework TradeFederation automatycznie wywoła tę metodę, podając log hosta i w razie potrzeby logcat urządzenia.
Parametry | |
---|---|
dataName |
String : String nazwa opisowa danych, np. „device_logcat”. Uwaga: imię i nazwisko może nie być unikalne w przypadku każdego wywołania. Oznacza to, że implementatorzy muszą mieć możliwość obsługi wielu wywołań z tym samym imieniem i nazwiskiem. |
dataType |
LogDataType : element LogDataType danych |
dataStream |
InputStreamSource : InputStreamSource danych. Implementatorzy powinni wywołać createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że zamkną powstały strumień wejściowy po zakończeniu. Osoby wywołujące tę metodę powinny zadbać o to, aby źródło danych było dostępne do momentu zakończenia metody testLog. |
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)
Koniec testu raportów.
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ę wykonać testu raportów z powodu błędu krytycznego.
Parametry | |
---|---|
errorMessage |
String : String opisujący przyczynę niepowodzenia wykonania. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa testu; |
testCount |
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. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa testu; |
testCount |
int : łączna liczba testów w sesji testowej |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa testu; |
testCount |
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 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 |
testPominięto
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
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. W starszym interfejsie należy w miarę możliwości używać interfejsu testStarted(com.android.tradefed.result.TestDescription)
.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
Metody chronione
getListeners
protectedgetListeners ()
Pobierz listę słuchaczy. Służy tylko do korzystania przez podklasy.
Zwroty | |
---|---|
|
Lista ITestInvocationListener . |
setListeners
protected void setListeners (ITestInvocationListener... listeners)
Ustaw słuchaczy po zakończeniu budowy. Przeznaczona tylko do użytku przez podklasy.
Parametry | |
---|---|
listeners |
ITestInvocationListener : prawdziwe ITestInvocationListener , do których mają być przesyłane wyniki |
setListeners
protected void setListeners (listeners)
Ustaw słuchaczy po zakończeniu budowy. Przeznaczona tylko do użytku przez podklasy.
Parametry | |
---|---|
listeners |
: prawdziwe ITestInvocationListener , do których mają być przesyłane wyniki |