Raportujący wyniki podprocesów
public
class
SubprocessResultsReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
Implementuje parametr ITestInvocationListener
, który ma być określony jako wynik_reporter i przekazywanie z
z wynikami testów i wywołaniami testów.
Podsumowanie
Konstruktory publiczne | |
---|---|
SubprocessResultsReporter()
|
Metody publiczne | |
---|---|
void
|
close()
|
TestSummary
|
getSummary()
Umożliwia usłudze InvocationListener zwrócenie podsumowania. |
void
|
invocationEnded(long elapsedTime)
Raportuje, że wywołanie zostało zakończone (prawidłowo lub z powodu 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
|
invocationStarted(IInvocationContext context)
Raportuje początek wywołania testu. |
void
|
logAssociation(String dataName, LogFile logFile)
W niektórych przypadkach zapis musi być silnie powiązany z przypadkami testowymi, ale mieć możliwość
więc w przypadku sprzedaży bezpośredniej |
void
|
printEvent(String key, Object event)
Pomocnik wyświetlający klucz zdarzenia, a następnie obiekt json. |
void
|
setOutputTestLog(boolean outputTestLog)
Określa, czy zarejestrowany test ma być generowany. |
boolean
|
supportGranularResults()
Zwraca wartość Prawda, jeśli reporter obsługuje szczegółowe wyniki. W przeciwnym razie zwraca wartość Fałsz. |
void
|
testAssumptionFailure(TestDescription testId, String trace)
Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości. |
void
|
testAssumptionFailure(TestDescription testId, FailureDescription failure)
Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości. |
void
|
testEnded(TestDescription testId, long endTime,
Alternatywa dla parametru |
void
|
testEnded(TestDescription testId,
Raportuje koniec wykonania danego przypadku testowego. |
void
|
testFailed(TestDescription testId, FailureDescription failure)
Zgłasza niepowodzenie pojedynczego przypadku testowego. |
void
|
testFailed(TestDescription testId, String reason)
Zgłasza niepowodzenie pojedynczego przypadku testowego. |
void
|
testIgnored(TestDescription testId)
Wywoływana, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignoruj. |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Podaje powiązany dziennik lub dane debugowania z wywołania testu. |
void
|
testModuleEnded()
Raportuje zakończenie działania modułu. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Raportuje początek uruchomionego modułu. |
void
|
testRunEnded(long time,
Koniec przebiegu testowego raportów. |
void
|
testRunFailed(FailureDescription failure)
Nie udało się wykonać testu raportów z powodu błędu opisanego w |
void
|
testRunFailed(String reason)
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 arg0)
Test raportów został zatrzymany przed ukończeniem na prośbę użytkownika. |
void
|
testSkipped(TestDescription testId, SkipReason reason)
Wywoływane, gdy test został pominięty i nie został wykonany z przyczyn, które zwykle nie są oczekiwane. |
void
|
testStarted(TestDescription testId, long startTime)
Alternatywa dla parametru |
void
|
testStarted(TestDescription testId)
Raportuje początek pojedynczego przypadku testowego. |
Konstruktory publiczne
Raportujący wyniki podprocesów
public SubprocessResultsReporter ()
Metody publiczne
zamknij
public void close ()
getPodsumowanie
public TestSummary getSummary ()
Umożliwia usłudze InvocationListener zwrócenie podsumowania.
Zwroty | |
---|---|
TestSummary |
TestSummary podsumowujący uruchomienie lub wartość null |
Zakończenie wywołania
public void invocationEnded (long elapsedTime)
Raportuje, że wywołanie zostało zakończone (prawidłowo lub z powodu błędu) .
będzie automatycznie wywoływana przez platformę federacji handlowej.
Parametry | |
---|---|
elapsedTime |
long : czas, jaki upłynął wywołania w milisekundach, |
Niepowodzenie wywołania
public void invocationFailed (FailureDescription failure)
Zgłasza niepełne wywołanie z powodu błędu.
będzie automatycznie wywoływana przez platformę federacji handlowej.
Parametry | |
---|---|
failure |
FailureDescription : FailureDescription opisujący przyczynę błędu; |
Niepowodzenie wywołania
public void invocationFailed (Throwable cause)
Zgłasza niepełne wywołanie z powodu błędu.
będzie automatycznie wywoływana przez platformę federacji handlowej.
Parametry | |
---|---|
cause |
Throwable : przyczyna błędu (Throwable ). |
Rozpoczęcie wywoływania
public void invocationStarted (IInvocationContext context)
Raportuje początek wywołania testu.
będzie automatycznie wywoływana przez platformę federacji handlowej. Raportujący muszą zastąpić aby umożliwić raportowanie wielu urządzeń.
Parametry | |
---|---|
context |
IInvocationContext : informacje o wywołaniu. |
powiązanie_logowania
public void logAssociation (String dataName, LogFile logFile)
W niektórych przypadkach zapis musi być silnie powiązany z przypadkami testowymi, ale mieć możliwość
więc w przypadku sprzedaży bezpośredniej testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
oddzwanianie jest niemożliwe. Dzięki temu to wywołanie zwrotne umożliwia utworzenie silnego powiązania
bezpośrednio.
Parametry | |
---|---|
dataName |
String : nazwa danych |
logFile |
LogFile : LogFile , który został zarejestrowany wcześniej i powinny być powiązany z parametrem
dla danego przypadku testowego. |
PrintEvent
public void printEvent (String key, Object event)
Pomocnik wyświetlający klucz zdarzenia, a następnie obiekt json.
Parametry | |
---|---|
key |
String |
event |
Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
Określa, czy na wyjściu ma być generowany logowany test.
Parametry | |
---|---|
outputTestLog |
boolean |
Pomoc Szczegółowe wyniki
public boolean supportGranularResults ()
Zwraca wartość Prawda, jeśli reporter obsługuje szczegółowe wyniki. W przeciwnym razie zwraca wartość Fałsz.
Zwroty | |
---|---|
boolean |
Niepowodzenie testuZałożenia Niepowodzeń
public void testAssumptionFailure (TestDescription testId, String trace)
Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
trace |
String : zrzut stosu niepowodzenia |
Niepowodzenie testuZałożenia Niepowodzeń
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
testZakończony
public void testEnded (TestDescription testId, long endTime,metrics)
Alternatywa dla parametru ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, w którym można określić godzinę zakończenia
bezpośrednio. Aby uzyskać dokładny pomiar, połącz go z polem testStarted(com.android.tradefed.result.TestDescription, long)
.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
endTime |
long : czas zakończenia testu (mierzony w polu System.currentTimeMillis() ). |
metrics |
: ERROR(/Map) wyemitowanych wskaźników |
testZakończony
public void testEnded (TestDescription testId,metrics)
Raportuje koniec wykonania danego przypadku testowego.
Jeśli funkcja testFailed(TestDescription, FailureDescription)
nie została wywołana, test zaliczony. Zwraca również dowolną parę klucz/wartość
wskaźniki, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
metrics |
: ERROR(/Map) wyemitowanych wskaźników |
Niepowodzenie testu
public void testFailed (TestDescription testId, FailureDescription failure)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Jest wywoływana między testStarted a testEnded.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
Niepowodzenie testu
public void testFailed (TestDescription testId, String reason)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Jest wywoływana między testStarted a testEnded.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
reason |
String : zrzut stosu niepowodzenia |
testignorowany
public void testIgnored (TestDescription testId)
Wywoływana, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignoruj.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
dziennik testów
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Podaje powiązany dziennik lub dane debugowania z wywołania testu.
Należy wywołać przed ERROR(/ITestInvocationListener#invocationFailed(Throwable))
lub
ERROR(/ITestInvocationListener#invocationEnded(long))
Platforma federacji handlu detalicznego automatycznie wywoła tę metodę, dostarczając dziennik hosta. a w razie potrzeby także dziennik urządzenia.
Parametry | |
---|---|
dataName |
String : opisowa nazwa danych typu String . np. „device_logcat”. Notatka
Wartość dataName nie może być unikalna na każdym wywołaniu. Oznacza to, że implementujący muszą być w stanie obsłużyć
wiele wywołań z tą samą wartością dataName |
dataType |
LogDataType : element LogDataType danych |
dataStream |
InputStreamSource : element InputStreamSource danych. Implementatorzy powinni wywołać
createInputStream, aby zacząć odczytywać dane i upewnić się, że
Strumień wejściowy po zakończeniu. Rozmówca powinien zadbać o to, aby źródło danych było nadal źródłem danych.
obecny i dostępny do chwili zakończenia działania metody testLog. |
Zakończono moduł testowy
public void testModuleEnded ()
Raportuje zakończenie działania modułu.
Początek modułu testowania
public void testModuleStarted (IInvocationContext moduleContext)
Raportuje początek uruchomionego modułu. To wywołanie zwrotne jest powiązane z usługą testModuleEnded()
i jest opcjonalne w sekwencji. Używa się go tylko podczas biegu, w którym
moduły: aplikacje biegowe oparte na pakiecie.
Parametry | |
---|---|
moduleContext |
IInvocationContext : element IInvocationContext modułu. |
Zakończono bieg testowy
public void testRunEnded (long time,runMetrics)
Koniec przebiegu testowego raportów. NAPRAWDŹ: nie możemy mieć dwóch map<> z interfejsami różnego typu. musimy użyć Skrótu HashMap.
Parametry | |
---|---|
time |
long : czas, który upłynął od urządzenia, w milisekundach |
runMetrics |
: pary klucz-wartość raportowane po zakończeniu testu z użyciem Metric . |
Niepowodzenie testu uruchomienia
public void testRunFailed (FailureDescription failure)
Nie udało się wykonać testu raportów z powodu błędu opisanego w FailureDescription
.
Parametry | |
---|---|
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
Niepowodzenie testu uruchomienia
public void testRunFailed (String reason)
Nie udało się wykonać testu raportów z powodu błędu krytycznego.
Parametry | |
---|---|
reason |
String : String z opisem przyczyny niepowodzenia uruchomienia. |
Uruchomiono test
public void testRunStarted (String runName, int testCount, int attemptNumber)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa uruchomienia testu |
testCount |
int : łączna liczba testów w teście |
attemptNumber |
int : numer zamówienia identyfikujący różne próby wykonania tej samej wartości runName
uruchamianych wiele razy. Liczba próbek jest indeksowana 0 i powinna być większa za każdym razem.
nowy bieg. np. Test został ponowiony po 3 próbach. Łącznie powinien przypadać 4 razy
działa w ramach tej samej nazwy runName, a parametr orderNumber mieści się w zakresie od 0 do 3. |
Uruchomiono test
public void testRunStarted (String runName, int testCount)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa uruchomienia testu |
testCount |
int : łączna liczba testów w teście |
Uruchomiono test
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa uruchomienia testu |
testCount |
int : łączna liczba testów w teście |
attemptNumber |
int : numer zamówienia identyfikujący różne próby wykonania tej samej wartości runName
uruchamianych wiele razy. Wartość orderNumber jest indeksowana o wartości 0 i powinna rosnąć za każdym razem, gdy
nowego uruchomienia. np. Test został ponowiony po raz ostatni 3 razy; powinien on mieć łącznie 4 uruchomienia
w tej samej wartości runName, a parametr phishingNumber mieści się w zakresie od 0 do 3. |
startTime |
long : czas rozpoczęcia uruchomienia (mierzony w polu System.currentTimeMillis() ). |
Zatrzymano uruchomienie testu
public void testRunStopped (long arg0)
Test raportów został zatrzymany przed ukończeniem na prośbę użytkownika.
DO ZROBIENIA: obecnie nieużywane, rozważ usunięcie
Parametry | |
---|---|
arg0 |
long : czas, który upłynął od urządzenia, w milisekundach |
testPominięto
public void testSkipped (TestDescription testId, SkipReason reason)
Wywoływane, gdy test został pominięty i nie został wykonany z przyczyn, które zwykle nie są oczekiwane. W tych testach zostaną ponowione próby przeprowadzenia prawidłowego wykonania.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
reason |
SkipReason : SkipReason |
testStarted (rozpoczęto test)
public void testStarted (TestDescription testId, long startTime)
Alternatywa dla parametru testStarted(com.android.tradefed.result.TestDescription)
, gdzie również określamy, kiedy test został przeprowadzony
w połączeniu z parametrem ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
, aby uzyskać dokładny pomiar.
Parametry | |
---|---|
testId |
TestDescription : identyfikuje test |
startTime |
long : czas rozpoczęcia testu (określony za pomocą parametru System.currentTimeMillis() ). |
testStarted (rozpoczęto test)
public void testStarted (TestDescription testId)
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 | |
---|---|
testId |
TestDescription : identyfikuje test |