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 |
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 |
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 |
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 |
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ć przedERROR(/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 | 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 |