ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Obiekt
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

---

ITestInvocationListener , który zbiera wyniki z fragmentu wywołania (znanego również jako podział wywołania do uruchamiania na wielu zasobach równolegle) i przekazuje je do innego odbiornika.

Streszczenie

Konstruktory publiczne
ShardListener ( ITestInvocationListener main) Utwórz ShardListener .

Metody publiczne
	getUnderlyingResultReporter ()
void	invocationEnded (long elapsedTime) Zgłasza, że ​​wywołanie zakończyło się 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 testowego.
void	logAssociation (String dataName, LogFile logFile) W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego na bezpośrednim 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) Udostępnia powiązane dane dziennika lub debugowania z wywołania testowego.
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testModuleEnded () Zgłasza koniec uruchomienia modułu.
void	testModuleStarted ( IInvocationContext moduleContext) Zgłasza początek uruchomionego modułu.
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Zgłasza koniec przebiegu testowego.
void	testRunFailed ( FailureDescription failure) Przebieg testu raportów nie został ukończony z powodu błędu opisanego przez FailureDescription .
void	testRunFailed (String failureMessage) Testowanie raportów nie zostało ukończone z powodu błędu krytycznego.
void	testRunStarted (String name, int numTests, int attemptNumber, long startTime) Zgłasza początek przebiegu testowego.

Konstruktory publiczne

ShardListener

public ShardListener (ITestInvocationListener main)

Utwórz ShardListener .

Parametry
main	ITestInvocationListener : ITestInvocationListener wyniki powinny zostać przesłane. Aby zapobiec kolizjom z innymi ShardListener s, ten obiekt będzie synchronizowany na main podczas przekazywania wyników. A wyniki zostaną wysłane dopiero po zakończeniu fragmentu wywołania.

Metody publiczne

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Zwroty

wywołanie zakończone

public void invocationEnded (long elapsedTime)

Zgłasza, że ​​wywołanie zakończyło się pomyślnie lub z powodu błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
elapsedTime	long : czas, który upłynął od wywołania 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 : przyczyna niepowodzenia Throwable

wywołanie rozpoczęte

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ć raportowanie wielu urządzeń.

Parametry
context	IInvocationContext : informacje o wywołaniu

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego na bezpośrednim 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 jawnie zapewnić silne powiązanie.

Parametry
dataName	String : nazwa danych
logFile	LogFile : LogFile , który był wcześniej rejestrowany i powinien być powiązany z przypadkiem testowym.

setWsparcieSzczegółowe wyniki

public void setSupportGranularResults (boolean enableGranularResults)

Parametry
enableGranularResults	boolean

wsparcieSzczegółoweWyniki

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)

Udostępnia powiązane dane dziennika lub debugowania z wywołania testowego.

Musi zostać wywołane przed ERROR(/ITestInvocationListener#invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

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

Parametry
dataName	String : opisowa nazwa String danych. 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ą danych
dataType	LogDataType : LogDataType danych
dataStream	InputStreamSource : InputStreamSource danych. Implementatorzy powinni wywoływać metodę createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że wynikowy InputStream zostanie zamknięty po zakończeniu. Obiekty wywołujące powinny upewnić się, że źródło danych pozostaje obecne i dostępne do czasu zakończenia metody testLog.

testLogZapisano

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parametry
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testModuleEnd

public void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

moduł testowyrozpoczęty

public void testModuleStarted (IInvocationContext moduleContext)

Zgłasza początek uruchomionego modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas biegu, który korzysta z modułów: biegaczy opartych na pakietach.

Parametry
moduleContext	IInvocationContext : IInvocationContext modułu.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

Parametry
elapsedTime	long : czas, który upłynął od urządzenia, w milisekundach
runMetrics	: pary klucz-wartość zgłaszane na koniec przebiegu testu z Metric .

testRunNie powiodło się

public void testRunFailed (FailureDescription failure)

Przebieg testu raportów nie został ukończony z powodu błędu opisanego przez FailureDescription .

Parametry
failure	FailureDescription : FailureDescription opisujący błąd i jego kontekst.

testRunNie powiodło się

public void testRunFailed (String failureMessage)

Testowanie raportów nie zostało ukończone z powodu błędu krytycznego.

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

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Zgłasza początek przebiegu testowego.

Parametry
name	String : nazwa uruchomienia testu
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 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest ponawiany 3 razy w trybie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.
startTime	long : czas rozpoczęcia przebiegu, mierzony przez System.currentTimeMillis()