PodprocesResulterReporter

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.Object
com.android.tradefed.result.SubprocessResultsReporter


Implementuje ITestInvocationListener do określenia jako result_reporter i przekazuje z podprocesu wyniki testów, przebiegów testów, wywołań testowych.

Streszczenie

Konstruktorzy publiczni

SubprocessResultsReporter ()

Metody publiczne

void close ()

TestSummary getSummary ()

Zezwala InvocationListener na zwrócenie podsumowania.

void invocationEnded (long elapsedTime)

Informuje, ż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 jakiegoś błędu.

void invocationFailed (Throwable cause)

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

void invocationStarted ( IInvocationContext context)

Zgłasza początek wywołania testowego.

void logAssociation (String dataName, LogFile logFile)

W niektórych przypadkach dziennik musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego w bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 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 wypisać logowany test, czy nie.

boolean supportGranularResults ()

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

void testAssumptionFailure ( TestDescription testId, String trace)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje warunek, który jest fałszywy

void testAssumptionFailure ( TestDescription testId, FailureDescription failure)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje 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)

Raportuje zakończenie wykonywania 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ływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

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

Udostępnia skojarzone dane dziennika lub debugowania z wywołania testowego.

void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

void testModuleStarted ( IInvocationContext moduleContext)

Raportuje początek działania modułu.

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

Raportuje koniec uruchomienia testowego.

void testRunFailed ( FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

void testRunFailed (String reason)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

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

Raportuje początek uruchomienia testowego.

void testRunStarted (String runName, int testCount)

Raportuje początek uruchomienia testowego.

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

Raportuje początek uruchomienia testowego.

void testRunStopped (long arg0)

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

void testStarted ( TestDescription testId, long startTime)

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

void testStarted ( TestDescription testId)

Raportuje początek indywidualnego przypadku testowego.

Konstruktorzy publiczni

PodprocesResulterReporter

public SubprocessResultsReporter ()

Metody publiczne

blisko

public void close ()

pobierz podsumowanie

public TestSummary getSummary ()

Zezwala InvocationListener na zwrócenie podsumowania.

Zwroty
TestSummary TestSummary podsumowujący przebieg lub null

inwokacjaZakończona

public void invocationEnded (long elapsedTime)

Informuje, ż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 trwania wywołania w ms

wywołanie nie powiodło się

public void invocationFailed (FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu jakiegoś 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 jakiegoś błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
cause Throwable : Throwable przyczyna niepowodzenia

wywołanieRozpoczęto

public void invocationStarted (IInvocationContext context)

Zgłasza początek wywołania testowego.

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

Parametry
context IInvocationContext : informacje o wywołaniu

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach dziennik musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego w bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) nie jest możliwe. Tak więc to wywołanie zwrotne umożliwia jawne zapewnienie silnego skojarzenia.

Parametry
dataName String : nazwa danych

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

printEvent

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 wypisać logowany test, czy nie.

Parametry
outputTestLog boolean

supportGranularResults

public boolean supportGranularResults ()

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

Zwroty
boolean

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje 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ływane, gdy atomowy test oznaczy, że przyjmuje warunek, który jest fałszywy

Parametry
testId TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego 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)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten 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.

Zostanie wywołana między testStarted i testEnded.

Parametry
testId TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

Test nieudany

public void testFailed (TestDescription testId, 
                String reason)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Zostanie wywołana między testStarted i testEnded.

Parametry
testId TestDescription : identyfikuje test

reason String : ślad stosu awarii

testIgnorowane

public void testIgnored (TestDescription testId)

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

Parametry
testId TestDescription : identyfikuje test

testLog

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

Udostępnia skojarzone dane dziennika lub debugowania z wywołania testowego.

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, dziennik urządzenia.

Parametry
dataName String : opisowa nazwa danych typu String . np. „device_logcat”. Uwaga dataName może nie być unikatowa na wywołanie. tj. realizatorzy muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą data

dataType LogDataType : LogDataType danych

dataStream InputStreamSource : InputStreamSource danych. Realizatorzy powinni wywołać metodę createInputStream, aby rozpocząć odczytywanie danych i zapewnić zamknięcie wynikowego InputStream po zakończeniu. Wywołujący powinien upewnić się, że źródło danych pozostaje obecne i dostępne do momentu zakończenia metody testLog.

testModułZakończony

public void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

testModułUruchomiony

public void testModuleStarted (IInvocationContext moduleContext)

Raportuje 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 używa modułów: biegaczy opartych na pakiecie.

Parametry
moduleContext IInvocationContext : IInvocationContext modułu.

TestUruchomionyZakończony

public void testRunEnded (long time, 
                 runMetrics)

Raportuje koniec uruchomienia testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> o różnych typach, 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łoszone na koniec testu z Metric .

TestUruchomie się nie powiódł

public void testRunFailed (FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

Parametry
failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

TestUruchomie się nie powiódł

public void testRunFailed (String reason)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

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

testUruchomiony

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

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

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

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. Np. Test jest ziarnisty ponawiany 3 razy, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

testUruchomiony

public void testRunStarted (String runName, 
                int testCount)

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

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

testUruchomiony

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

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

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

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. Np. Test jest powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

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

testRunStopped

public void testRunStopped (long arg0)

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

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

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

testRozpoczęto

public void testStarted (TestDescription testId, 
                long startTime)

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

Parametry
testId TestDescription : identyfikuje test

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

testRozpoczęto

public void testStarted (TestDescription testId)

Raportuje początek indywidualnego przypadku testowego. Starszy interfejs powinien używać testStarted(com.android.tradefed.result.TestDescription) , gdy tylko jest to możliwe.

Parametry
testId TestDescription : identyfikuje test