Reporter wyników podprocesu

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

Obiekt Java.lang.Object
com.android.tradefed.result.SubprocessResultsReporter


Implementuje ITestInvocationListener , który ma być określony jako reporter_wyników i przekazuje z podprocesu wyniki testów, przebiegów testów i wywołań testów.

Streszczenie

Konstruktorzy publiczni

SubprocessResultsReporter ()

Metody publiczne

void close ()

TestSummary getSummary ()

Umożliwia InvocationListener zwrócenie podsumowania.

void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationStarted ( IInvocationContext context)

Zgłasza początek wywołania testu.

void logAssociation (String dataName, LogFile logFile)

W niektórych przypadkach log musi być ściśle powiązany z przypadkami testowymi, ale możliwość zrobienia tego bezpośrednio na testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) wywołanie zwrotne nie jest możliwe.

void printEvent (String key, Object event)

Pomocnik do wydrukowania klucza zdarzenia, a następnie obiektu json.

void setOutputTestLog (boolean outputTestLog)

Ustawia, czy powinniśmy wypisywać zarejestrowany test, czy nie.

boolean supportGranularResults ()

Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.

void testAssumptionFailure ( TestDescription testId, String trace)

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

void testAssumptionFailure ( TestDescription testId, FailureDescription failure)

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

void testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics)

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

void testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics)

Zgłasza koniec wykonania pojedynczego 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ływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

Zawiera skojarzone dane dziennika lub debugowania z wywołania testu.

void testModuleEnded ()

Zgłasza koniec działania modułu.

void testModuleStarted ( IInvocationContext moduleContext)

Zgłasza początek działania modułu.

void testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics)

Zgłasza koniec przebiegu testowego.

void testRunFailed ( FailureDescription failure)

Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w FailureDescription .

void testRunFailed (String reason)

Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.

void testRunStarted (String runName, int testCount, int attemptNumber)

Zgłasza rozpoczęcie przebiegu testowego.

void testRunStarted (String runName, int testCount)

Zgłasza rozpoczęcie przebiegu testowego.

void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

Zgłasza rozpoczęcie przebiegu testowego.

void testRunStopped (long arg0)

Raportuje, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

void testSkipped ( TestDescription testId, SkipReason reason)

Wywoływane, gdy test został pominięty i nie został wykonany z powodu, którego zwykle się nie oczekuje.

void testStarted ( TestDescription testId, long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, kiedy test został rozpoczęty, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) w celu dokładnego pomiaru .

void testStarted ( TestDescription testId)

Zgłasza rozpoczęcie pojedynczego przypadku testowego.

Konstruktorzy publiczni

Reporter wyników podprocesu

public SubprocessResultsReporter ()

Metody publiczne

zamknąć

public void close ()

pobierz podsumowanie

public TestSummary getSummary ()

Umożliwia InvocationListener zwrócenie podsumowania.

Zwroty
TestSummary TestSummary podsumowujący przebieg lub null

wywołanieZakończone

public void invocationEnded (long elapsedTime)

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

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
elapsedTime long : czas wywołania, który upłynął w ms

wywołanie nie powiodło się

public void invocationFailed (FailureDescription failure)

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

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
failure FailureDescription : FailureDescription opisujący przyczynę niepowodzenia

wywołanie nie powiodło się

public void invocationFailed (Throwable cause)

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

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
cause Throwable : Throwable , czyli przyczyna niepowodzenia

wywołanieRozpoczęte

public void invocationStarted (IInvocationContext context)

Zgłasza początek wywołania testu.

Zostanie automatycznie wywołany przez platformę TradeFederation. Reporterzy muszą zastąpić tę metodę, aby obsługiwać raporty z wielu urządzeń.

Parametry
context IInvocationContext : informacja o wywołaniu

stowarzyszenie log

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być ściśle powiązany z przypadkami testowymi, ale możliwość zrobienia tego bezpośrednio na testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) wywołanie zwrotne nie jest możliwe. Zatem to wywołanie zwrotne pozwala na wyraźne zapewnienie silnego powiązania.

Parametry
dataName String : nazwa danych

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

wydrukuj wydarzenie

public void printEvent (String key, 
                Object event)

Pomocnik do wydrukowania klucza zdarzenia, a następnie obiektu json.

Parametry
key String

event Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Ustawia, czy powinniśmy wypisywać zarejestrowany test, czy nie.

Parametry
outputTestLog boolean

wsparcieGranularResults

public boolean supportGranularResults ()

Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.

Zwroty
boolean

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

Parametry
testId TestDescription : identyfikuje test

trace String : ślad stosu awarii

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

Parametry
testId TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisujący awarię i jej kontekst.

testZakończony

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) gdzie możemy bezpośrednio określić czas zakończenia. Połącz z testStarted(com.android.tradefed.result.TestDescription, long) , aby uzyskać dokładny pomiar.

Parametry
testId TestDescription : identyfikuje test

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

metrics : ERROR(/Map) emitowanych metryk

testZakończony

public void testEnded (TestDescription testId, 
                 metrics)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, test zakończył się pomyślnie. Zwraca również wszelkie metryki klucz/wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
testId TestDescription : identyfikuje test

metrics : ERROR(/Map) emitowanych metryk

Test nieudany

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Będzie wywoływany pomiędzy testStarted i testEnded.

Parametry
testId TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisujący awarię i jej kontekst.

Test nieudany

public void testFailed (TestDescription testId, 
                String reason)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Będzie wywoływany pomiędzy testStarted i testEnded.

Parametry
testId TestDescription : identyfikuje test

reason String : ślad stosu awarii

testIgnorowany

public void testIgnored (TestDescription testId)

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

Parametry
testId TestDescription : identyfikuje test

dziennik testowy

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Zawiera skojarzone dane dziennika lub debugowania z wywołania testu.

Należy wywołać przed ERROR(/ITestInvocationListener#invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

Struktura TradeFederation automatycznie wywoła tę metodę, dostarczając dziennik hosta i, jeśli ma to zastosowanie, logcat urządzenia.

Parametry
dataName String : String opisowy nazwy danych. np. „urządzenie_logcat”. Uwaga nazwa_danych może nie być unikalna dla każdego wywołania. tj. osoby wdrażające muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą danych

dataType LogDataType : LogDataType danych

dataStream InputStreamSource : InputStreamSource danych. Osoby wdrażające powinny wywołać funkcję createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że po ukończeniu wynikowy strumień wejściowy zostanie zamknięty. Osoby wywołujące powinny upewnić się, że źródło danych pozostaje obecne i dostępne do czasu zakończenia metody testLog.

moduł testowyZakończony

public void testModuleEnded ()

Zgłasza koniec działania modułu.

Uruchomiono moduł testowy

public void testModuleStarted (IInvocationContext moduleContext)

Zgłasza początek działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas biegu, który wykorzystuje moduły: biegacze bazujący na pakiecie.

Parametry
moduleContext IInvocationContext : IInvocationContext modułu.

testRunZakończony

public void testRunEnded (long time, 
                 runMetrics)

Zgłasza koniec przebiegu testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> różnych typów, więc musimy tutaj użyć HashMap.

Parametry
time long : urządzenie zgłosiło czas, który upłynął, w milisekundach

runMetrics : pary klucz-wartość zgłaszane na koniec przebiegu testowego za pomocą Metric .

testRun nie powiódł się

public void testRunFailed (FailureDescription failure)

Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w FailureDescription .

Parametry
failure FailureDescription : FailureDescription opisujący awarię i jej kontekst.

testRun nie powiódł się

public void testRunFailed (String reason)

Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.

Parametry
reason String : String opisujący przyczynę niepowodzenia uruchomienia.

Uruchomiono testRun

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

testCount int : całkowita liczba testów w przebiegu testu

attemptNumber int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.

Uruchomiono testRun

public void testRunStarted (String runName, 
                int testCount)

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

testCount int : całkowita liczba testów w przebiegu testu

Uruchomiono testRun

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

testCount int : całkowita liczba testów w przebiegu testu

attemptNumber int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.

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

testRunZatrzymany

public void testRunStopped (long arg0)

Raportuje, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

DO ZROBIENIA: obecnie nieużywany, rozważ usunięcie

Parametry
arg0 long : urządzenie zgłosiło czas, który upłynął, w milisekundach

testPominięty

public void testSkipped (TestDescription testId, 
                SkipReason reason)

Wywoływane, gdy test został pominięty i nie został wykonany z powodu, którego zwykle się nie oczekuje. Testy te zostaną ponowione, aby zapewnić ich prawidłowe wykonanie.

Parametry
testId TestDescription : identyfikuje test

reason SkipReason : SkipReason

test rozpoczęty

public void testStarted (TestDescription testId, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, kiedy test został rozpoczęty, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) w celu dokładnego pomiaru .

Parametry
testId TestDescription : identyfikuje test

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

test rozpoczęty

public void testStarted (TestDescription testId)

Zgłasza rozpoczęcie pojedynczego przypadku testowego. Starszy interfejs, jeśli to możliwe, należy używać testStarted(com.android.tradefed.result.TestDescription) .

Parametry
testId TestDescription : identyfikuje test