Przesyłanie wyników

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder

Znane bezpośrednie podklasy FilteredResultForwarder, JarHostTest.HostTestListener, LogSaverResultForwarder, LogcatCrashResultForwarder, PythonBinaryHostTest.PythonForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder, TestTimeoutEnforcer FilteredResultForwarder Wariant ResultForwarder, który umożliwia raportowanie tylko listy dozwolonych TestDescription.  JarHostTest.HostTestListener Detektor opakowania, który przekazuje wszystkie zdarzenia oprócz testRunStarted() i testRunEnded() do wbudowanego detektora.  LogSaverResultForwarder ResultForwarder do zapisywania dzienników za pomocą globalnego narzędzia do zapisywania plików.  LogcatCrashResultForwarder Specjalny listener: w przypadku błędów (awarii procesu pomiarowego) próbuje wyodrębnić z logcatu informacje o awarii i dodaje je do komunikatu o błędzie powiązanego z testem.  PythonBinaryHostTest.PythonForwarder Przesyłanie wyników, aby zastąpić nazwę procesu nazwą binarną.  przekazywanie wyników i logów, Przesyłanie wyników i zdarzeń z dziennika.  RetryResultForwarder Rozszerzenie ResultForwarder, które zawsze przesyła dane do określonej próby.  ShardMainResultForwarder ResultForwarder, który łączy wyniki wywołań testu podzielonego na fragmenty.  TestTimeoutEnforcer Odbiorniki, które umożliwiają sprawdzenie czasu wykonania danego przypadku testowego i jego przerwanie, jeśli przekroczy on określony limit czasu.

Znane podklasy pośrednie GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector Pomocnik klasy do wychwytywania brakujących początków i zakończeń przebiegu.  RetryLogSaverResultForwarder Przesyłacz, który przekazuje również bieżącą próbę.

---

ITestInvocationListener, który przekazuje wyniki wywołania do listy innych odbiorców.

Podsumowanie

Konstruktory publiczne
ResultForwarder(ITestInvocationListener... listeners) Alternatywny konstruktor argumentu zmiennej dla ResultForwarder.
ResultForwarder( listeners) Utwórz ResultForwarder.

Chronione konstruktory
ResultForwarder() Utwórz ResultForwarder z opóźnionym odbiornikiem.

Metody publiczne
TestSummary	getSummary() Umożliwia wywołaniu InvocationListener zwrócenie podsumowania.
void	invocationEnded(long elapsedTime) Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).
void	invocationFailed(FailureDescription failure) zgłasza niepełne wywołanie z powodu błędu.
void	invocationFailed(Throwable cause) zgłasza niepełne wywołanie z powodu błędu.
void	invocationSkipped(SkipReason reason) zgłasza wywołanie jako pominięte;
void	invocationStarted(IInvocationContext context) Raportuje rozpoczęcie wywołania testu.
void	testAssumptionFailure(TestDescription test, String trace) Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
void	testEnded(TestDescription test, long endTime, testMetrics) Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), w której możemy bezpośrednio określić czas zakończenia.
void	testEnded(TestDescription test, testMetrics) Raportuje zakończenie wykonywania pojedynczego przypadku testowego.
void	testFailed(TestDescription test, FailureDescription failure) Raportuje niepowodzenie pojedynczego przypadku testowego.
void	testFailed(TestDescription test, String trace) Raportuje niepowodzenie pojedynczego przypadku testowego.
void	testIgnored(TestDescription test) Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Zawiera powiązane dane dziennika lub debugowania z wywołania testu.
void	testModuleEnded() Raportuje koniec wykonania modułu.
void	testModuleStarted(IInvocationContext moduleContext) zgłasza rozpoczęcie działania modułu.
void	testRunEnded(long elapsedTime, runMetrics) Raportuje zakończenie testu.
void	testRunFailed(FailureDescription failure) Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription.
void	testRunFailed(String errorMessage) Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.
void	testRunStarted(String runName, int testCount, int attemptNumber) Raportuje rozpoczęcie testu.
void	testRunStarted(String runName, int testCount) Raportuje rozpoczęcie testu.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Raportuje rozpoczęcie testu.
void	testRunStopped(long elapsedTime) Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.
void	testSkipped(TestDescription test, SkipReason reason) Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu.
void	testStarted(TestDescription test, long startTime) Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.
void	testStarted(TestDescription test) Raportuje rozpoczęcie pojedynczego testu.

Chronione metody
	getListeners() Pobierz listę słuchaczy.
void	setListeners(ITestInvocationListener... listeners) Ustaw słuchaczy po zakończeniu budowy.
void	setListeners( listeners) Ustaw słuchaczy po zakończeniu budowy.

Konstruktory publiczne

Przesyłanie wyników

public ResultForwarder (ITestInvocationListener... listeners)

Alternatywny konstruktor argumentu zmiennej dla ResultForwarder.

Parametry
listeners	ITestInvocationListener: prawdziwe ITestInvocationListener, do których mają być przesyłane wyniki

Przesyłanie wyników

public ResultForwarder ( listeners)

Utwórz ResultForwarder.

Parametry
listeners	: prawdziwe ITestInvocationListener, do których mają być przesyłane wyniki

Chronione konstruktory

Przesyłanie wyników

protected ResultForwarder ()

Utwórz ResultForwarder z opóźnionym odbiornikiem. Przeznaczony tylko do użycia przez podklasy.

Metody publiczne

getSummary

public TestSummary getSummary ()

Umożliwia wywołaniu InvocationListener zwrócenie podsumowania.

Zwroty
TestSummary	TestSummary podsumowujący wykonanie, lub wartość null.

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
elapsedTime	long: upłynął czas wywołania w ms

invocationFailed

public void invocationFailed (FailureDescription failure)

zgłasza niepełne wywołanie z powodu błędu.

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
failure	FailureDescription: FailureDescription opisujący przyczynę niepowodzenia

invocationFailed

public void invocationFailed (Throwable cause)

zgłasza niepełne wywołanie z powodu błędu.

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
cause	Throwable: przyczyna niepowodzenia Throwable

invocationSkipped

public void invocationSkipped (SkipReason reason)

zgłasza wywołanie jako pominięte;

Parametry
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Raportuje rozpoczęcie wywołania testu.

Będzie wywoływany automatycznie przez platformę TradeFederation. Aby umożliwić raportowanie z kilku urządzeń, autorzy raportów muszą zastąpić tę metodę.

Parametry
context	IInvocationContext: informacje o wywołaniu;

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

Parametry
test	TestDescription: identyfikuje test
trace	String: zrzut stosu błędu

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

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

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), w której możemy bezpośrednio określić czas zakończenia. Aby uzyskać dokładne pomiary, połącz je z elementem testStarted(com.android.tradefed.result.TestDescription, long).

Parametry
test	TestDescription: identyfikuje test
endTime	long: czas zakończenia testu mierzony za pomocą funkcji System.currentTimeMillis()
testMetrics	: ERROR(/Map) danych wyemitowanych

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test się powiedzie. Zwraca też wszystkie dane klucz-wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
test	TestDescription: identyfikuje test
testMetrics	: ERROR(/Map) danych wyemitowanych

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

Parametry
test	TestDescription: identyfikuje test
trace	String: zrzut stosu błędu

testIgnored

public void testIgnored (TestDescription test)

Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.

Parametry
test	TestDescription: identyfikuje test

testLog

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

Zawiera powiązane dane dziennika lub debugowania z wywołania testu.

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

Framework TradeFederation automatycznie wywoła tę metodę, podając log hosta i w razie potrzeby logcat urządzenia.

Parametry
dataName	String: Stringnazwa opisowa danych, np. „device_logcat”. Uwaga: nazwa danych może nie być unikalna dla każdego wywołania. Oznacza to, że implementatorzy muszą mieć możliwość obsługi wielu wywołań z tą samą nazwą danych.
dataType	LogDataType: LogDataType danych
dataStream	InputStreamSource: InputStreamSource danych. Implementatorzy powinni wywołać createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że zamkną powstały strumień wejściowy po zakończeniu. Osoby wywołujące tę metodę powinny zadbać o to, aby źródło danych było dostępne do momentu zakończenia metody testLog.

testModuleEnded

public void testModuleEnded ()

Raportuje koniec wykonania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

zgłasza rozpoczęcie działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas wykonywania testu, który korzysta z modułów: modułów opartych na zestawach.

Parametry
moduleContext	IInvocationContext: IInvocationContext modułu.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Raportuje zakończenie testu.

Parametry
elapsedTime	long: czas upłynął, milisekundy zgłoszone przez urządzenie
runMetrics	: pary klucz-wartość zgłoszone na końcu wykonania testu

testRunFailed

public void testRunFailed (FailureDescription failure)

Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription.

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

testRunFailed

public void testRunFailed (String errorMessage)

Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.

Parametry
errorMessage	String: String opisujący przyczynę niepowodzenia wykonania.

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
runName	String: nazwa testu;
testCount	int: łączna liczba testów w sesji testowej
attemptNumber	int: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe wykonanie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 wykonania pod tym samym runName, a attemptNumber będzie miał wartość od 0 do 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Raportuje rozpoczęcie testu.

Parametry
runName	String: nazwa testu;
testCount	int: łączna liczba testów w sesji testowej

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
runName	String: nazwa testu;
testCount	int: łączna liczba testów w sesji testowej
attemptNumber	int: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tym samym nazwą runName, a wartość attemptNumber powinna się zmieniać od 0 do 3.
startTime	long: czas rozpoczęcia wykonywania zadania, mierzony za pomocą System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.

TODO: currently unused, consider removing

Parametry
elapsedTime	long: czas upłynął, milisekundy zgłoszone przez urządzenie

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu. Te testy zostaną powtórzone, aby sprawdzić, czy tym razem wszystko się uda.

Parametry
test	TestDescription: identyfikuje test
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.

Parametry
test	TestDescription: identyfikuje test
startTime	long: czas rozpoczęcia testu mierzony za pomocą funkcji System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

Raportuje rozpoczęcie pojedynczego testu. Starszy interfejs, którego należy używać w miarę możliwości w przypadku testStarted(com.android.tradefed.result.TestDescription).

Parametry
test	TestDescription: identyfikuje test

Chronione metody

getListeners

protected  getListeners ()

Pobierz listę słuchaczy. Jest przeznaczony tylko do użytku przez podklasy.

Zwroty
	Lista ITestInvocationListener.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Ustaw słuchaczy po zakończeniu budowy. Jest przeznaczony tylko do użytku przez podklasy.

Parametry
listeners	ITestInvocationListener: prawdziwe ITestInvocationListener, do których mają być przesyłane wyniki

setListeners

protected void setListeners ( listeners)

Ustaw słuchaczy po zakończeniu budowy. Jest przeznaczony tylko do użytku przez podklasy.

Parametry
listeners	: prawdziwe ITestInvocationListener, do których mają być przesyłane wyniki