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 ShardListener .

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 invocationSkipped ( SkipReason reason)

Zgłasza wywołanie jako pominięte

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 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 FailureDescription .

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

public  getUnderlyingResultReporter ()

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łaniePominięte

public void invocationSkipped (SkipReason reason)

Zgłasza wywołanie jako pominięte

Parametry
reason SkipReason

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ć 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.

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 : pary klucz-wartość zgłaszane na koniec przebiegu testowego z 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()