ShardLister
public class ShardListener
extends CollectingTestListener
implements ISupportGranularResults
Obiekt Java.lang.Object | ||
↳ | com.android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.invoker.ShardListener |
Element ITestInvocationListener
, który zbiera wyniki z fragmentu wywołania (czyli podziału wywołania w celu równoległego uruchamiania na wielu zasobach) i przekazuje je do innego odbiornika.
Streszczenie
Konstruktorzy publiczni | |
---|---|
ShardListener ( ITestInvocationListener main) Utwórz |
Metody publiczne | |
---|---|
getUnderlyingResultReporter () | |
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 |
void | setSupportGranularResults (boolean enableGranularResults) |
boolean | supportGranularResults () Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Zawiera skojarzone dane dziennika lub debugowania z wywołania testu. |
void | testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) |
void | testModuleEnded () Zgłasza koniec działania modułu. |
void | testModuleStarted ( IInvocationContext moduleContext) Zgłasza początek działania modułu. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Zgłasza koniec przebiegu testowego. |
void | testRunFailed ( FailureDescription failure) Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w |
void | testRunFailed (String failureMessage) Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Zgłasza rozpoczęcie przebiegu testowego. |
Konstruktorzy publiczni
ShardLister
public ShardListener (ITestInvocationListener main)
Utwórz ShardListener
.
Parametry | |
---|---|
main | ITestInvocationListener : ITestInvocationListener wyniki powinny zostać przesłane dalej. Aby zapobiec kolizjom z innymi obiektami ShardListener , ten obiekt będzie synchronizowany na main podczas przesyłania wyników. Wyniki zostaną wysłane dopiero po zakończeniu fragmentu wywołania. |
Metody publiczne
getUnderlyingResultReporter
publicgetUnderlyingResultReporter ()
Zwroty | |
---|---|
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. |
setSupportGranularResults
public void setSupportGranularResults (boolean enableGranularResults)
Parametry | |
---|---|
enableGranularResults | boolean |
wsparcieGranularResults
public boolean supportGranularResults ()
Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.
Zwroty | |
---|---|
boolean |
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ć 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, 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. |
dziennik testowy zapisany
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Parametry | |
---|---|
dataName | String |
dataType | LogDataType |
dataStream | InputStreamSource |
logFile | LogFile |
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 elapsedTime,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 | |
---|---|
elapsedTime | long : urządzenie zgłosiło czas, który upłynął, w milisekundach |
runMetrics | 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 failureMessage)
Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.
Parametry | |
---|---|
failureMessage | String : String opisujący przyczynę niepowodzenia uruchomienia. |
Uruchomiono testRun
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Zgłasza rozpoczęcie przebiegu testowego.
Parametry | |
---|---|
name | String : nazwa przebiegu testowego |
numTests | 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() |
ShardLister
public class ShardListener
extends CollectingTestListener
implements ISupportGranularResults
Obiekt Java.lang.Object | ||
↳ | com.android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.invoker.ShardListener |
Element ITestInvocationListener
, który zbiera wyniki z fragmentu wywołania (czyli podziału wywołania w celu równoległego uruchamiania na wielu zasobach) i przekazuje je do innego odbiornika.
Streszczenie
Konstruktorzy publiczni | |
---|---|
ShardListener ( ITestInvocationListener main) Utwórz |
Metody publiczne | |
---|---|
getUnderlyingResultReporter () | |
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 |
void | setSupportGranularResults (boolean enableGranularResults) |
boolean | supportGranularResults () Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Zawiera skojarzone dane dziennika lub debugowania z wywołania testu. |
void | testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) |
void | testModuleEnded () Zgłasza koniec działania modułu. |
void | testModuleStarted ( IInvocationContext moduleContext) Zgłasza początek działania modułu. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Zgłasza koniec przebiegu testowego. |
void | testRunFailed ( FailureDescription failure) Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w |
void | testRunFailed (String failureMessage) Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Zgłasza rozpoczęcie przebiegu testowego. |
Konstruktorzy publiczni
ShardLister
public ShardListener (ITestInvocationListener main)
Utwórz ShardListener
.
Parametry | |
---|---|
main | ITestInvocationListener : ITestInvocationListener wyniki powinny zostać przesłane dalej. Aby zapobiec kolizjom z innymi obiektami ShardListener , ten obiekt będzie synchronizowany na serwerze main podczas przesyłania wyników. Wyniki zostaną wysłane dopiero po zakończeniu fragmentu wywołania. |
Metody publiczne
getUnderlyingResultReporter
publicgetUnderlyingResultReporter ()
Zwroty | |
---|---|
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. |
setSupportGranularResults
public void setSupportGranularResults (boolean enableGranularResults)
Parametry | |
---|---|
enableGranularResults | boolean |
wsparcieGranularResults
public boolean supportGranularResults ()
Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.
Zwroty | |
---|---|
boolean |
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ć 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, 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. |
dziennik testowy zapisany
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Parametry | |
---|---|
dataName | String |
dataType | LogDataType |
dataStream | InputStreamSource |
logFile | LogFile |
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 elapsedTime,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 | |
---|---|
elapsedTime | long : urządzenie zgłosiło czas, który upłynął, w milisekundach |
runMetrics | 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 failureMessage)
Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.
Parametry | |
---|---|
failureMessage | String : String opisujący przyczynę niepowodzenia uruchomienia. |
Uruchomiono testRun
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Zgłasza rozpoczęcie przebiegu testowego.
Parametry | |
---|---|
name | String : nazwa przebiegu testowego |
numTests | 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() |