BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

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

---

Przepuszczająca reguła ITestInvocationListener, która zbiera raporty o błędach po wystąpieniu zdarzeń konfigurowalnych, a potem wywołuje regułę ITestInvocationListener.testLog w swoich elementach podrzędnych po zebraniu każdego raportu o błędzie.

Zachowania: (FIXME: finish this)

• Przechwyć po każdym teście, jeśli któryś z nich się nie powiódł.
• Rejestrowanie po każdym teście
• Przechwyć po każdym nieudanym teście
• Rejestruj

Podsumowanie

Zagnieżdżone klasy
class	BugreportCollector.Predicate Pełny predykat opisujący, kiedy należy przechwycić raport o błędzie.
interface	BugreportCollector.SubPredicate

Fieldsem
public static final BugreportCollector.Predicate	AFTER_FAILED_TESTCASES Wstępnie zdefiniowany predykat, który jest uruchamiany po każdym nieudanym teście.
public static final BugreportCollector.Predicate	AT_START Wstępnie zdefiniowany predykat, który jest uruchamiany po rozpoczęciu pierwszego wywołania.

Konstruktory publiczne
BugreportCollector(ITestInvocationListener listener, ITestDevice testDevice)

Metody publiczne
void	addPredicate(BugreportCollector.Predicate p)
void	blockUntilIdle() Blokuj, dopóki zbieracz nie przestanie zbierać żadnych raportów o błędach.
TestSummary	getSummary() Umożliwia wywołaniu InvocationListener zwrócenie podsumowania.
void	invocationEnded(long elapsedTime) Raport o zakończeniu wywołania, czy to z powodu błędu czy też z innego powodu.
void	invocationFailed(Throwable cause) zgłasza niepełne wywołanie z powodu błędu;
void	invocationStarted(IInvocationContext context) Informuje o rozpoczęciu wywołania testu.
void	setAsynchronous(boolean asynchronous) Określ, czy raport o błędach ma być zbierany w ramach innego wątku (asynchronous = true), czy też ma blokować dzwoniącego, dopóki raport o błędach nie zostanie przechwycony (asynchronous = false).
void	setDescriptiveName(String name) Ustaw nazwę opisową, która będzie używana podczas rejestrowania raportów o błędach.
void	setDeviceWaitTime(int waitTime) Ustaw czas (w sekundach) oczekiwania na połączenie z internetem urządzenia, zanim spróbujemy przechwycić raport o błędzie.
void	testAssumptionFailure(TestDescription test, String trace) Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
void	testEnded(TestDescription test, testMetrics) Raportuje zakończenie wykonywania pojedynczego przypadku testu.
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	testRunEnded(long elapsedTime, runMetrics) Raportuje zakończenie testu.
void	testRunFailed(String errorMessage) Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.
void	testRunStarted(String runName, int testCount) 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	testStarted(TestDescription test) Raportuje rozpoczęcie indywidualnego przypadku testowego.

Fieldsem

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Wstępnie zdefiniowany predykat, który jest uruchamiany po każdym nieudanym teście.

AT_START

public static final BugreportCollector.Predicate AT_START

Wstępnie zdefiniowany predykat, który jest uruchamiany w momencie rozpoczęcia pierwszego wywołania.

Konstruktory publiczne

BugreportCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parametry
listener	ITestInvocationListener
testDevice	ITestDevice

Metody publiczne

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

Parametry
p	BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

Blokuj, dopóki zbieracz nie przestanie zbierać żadnych raportów o błędach. Jeśli kolektor nie zbiera aktywnie raportu o błędzie, zwracaj natychmiast

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)

Raport o zakończeniu wywołania, czy to z powodu błędu czy też z innego powodu.

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

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

Informuje o rozpoczęciu 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;

setAsynchronous

public void setAsynchronous (boolean asynchronous)

Określ, czy raport o błędach ma być zbierany w ramach innego wątku (asynchronous = true), czy też ma blokować dzwoniącego, dopóki raport o błędach nie zostanie przechwycony (asynchronous = false).

Parametry
asynchronous	boolean

setDescriptiveName

public void setDescriptiveName (String name)

Ustaw nazwę opisową, która będzie używana podczas rejestrowania raportów o błędach. Jeśli null, BugreportCollector użyje domyślnego zachowania, czyli zserializuje nazwę zdarzenia, które spowodowało zebranie raportu o błędzie.

Parametry
name	String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Ustaw czas (w sekundach) oczekiwania na połączenie z internetem urządzenia, zanim spróbujemy przechwycić raport o błędzie. Jeśli odpowiedź jest negatywna, nie zostanie przeprowadzona żadna weryfikacja. Wszystkie DeviceNotAvailableException wykryte podczas tej weryfikacji zostaną zapisane i zignorowane.

Parametry
waitTime	int

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testu.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test się powiódł. 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, 
                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: imię i nazwisko może nie być unikalne w przypadku każdego wywołania. Implementatorzy muszą mieć możliwość obsługi wielu wywołań z tym samym imieniem i nazwiskiem.
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.

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 (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)

Raportuje rozpoczęcie testu.

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

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

testStarted

public void testStarted (TestDescription test)

Raportuje rozpoczęcie indywidualnego przypadku testowego. 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