Kolekcjoner raportów błędów

public class BugreportCollector
extends Object implements ITestInvocationListener

Obiekt Java.lang.Object
↳ com.android.tradefed.result.BugreportCollector

Element przekazujący ITestInvocationListener , który zbiera raporty o błędach w przypadku wystąpienia konfigurowalnych zdarzeń, a następnie wywołuje ITestInvocationListener#testLog na swoich elementach podrzędnych po zebraniu każdego raportu o błędach.

Zachowania: (FIXME: zakończ to)

  • Przechwyć po każdym przypadku, gdy którykolwiek przypadek testowy zakończył się niepowodzeniem
  • Przechwytywanie po każdym przypadku testowym
  • Przechwytywanie po każdym nieudanym teście
  • Schwytać

Streszczenie

Zagnieżdżone klasy

class BugreportCollector.Predicate

Pełny predykat opisujący, kiedy należy przechwycić raport o błędzie.

interface BugreportCollector.SubPredicate

Pola

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Predefiniowany predykat uruchamiany po każdym nieudanym przypadku testowym

public static final BugreportCollector.Predicate AT_START

Predefiniowany predykat uruchamiany po rozpoczęciu pierwszego wywołania

Konstruktorzy publiczni

BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

Metody publiczne

void addPredicate ( BugreportCollector.Predicate p)
void blockUntilIdle ()

Blokuj, dopóki moduł zbierający nie będzie zbierał żadnych raportów o błędach.

TestSummary getSummary ()

Umożliwia InvocationListener zwrócenie podsumowania.

void invocationEnded (long elapsedTime)

Raportuje, że wywołanie zostało zakończone pomyślnie lub 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 setAsynchronous (boolean asynchronous)

Ustaw, czy zbieranie raportów o błędach powinno zbierać raporty o błędach w innym wątku ( asynchronous = true ), czy też blokuj obiekt wywołujący do czasu przechwycenia raportu o błędach ( 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, aż urządzenie będzie online, zanim spróbujemy przechwycić raport o błędzie.

void testAssumptionFailure ( TestDescription test, String trace)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

void testFailed ( TestDescription test, String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

void testIgnored ( TestDescription test)

Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

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

Zawiera skojarzone dane dziennika lub debugowania z wywołania testu.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Zgłasza koniec przebiegu testowego.

void testRunFailed (String errorMessage)

Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.

void testRunStarted (String runName, int testCount)

Zgłasza rozpoczęcie przebiegu testowego.

void testRunStopped (long elapsedTime)

Raportuje, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

void testStarted ( TestDescription test)

Zgłasza rozpoczęcie pojedynczego przypadku testowego.

Pola

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Predefiniowany predykat uruchamiany po każdym nieudanym przypadku testowym

NA STARCIE

public static final BugreportCollector.Predicate AT_START

Predefiniowany predykat uruchamiany po rozpoczęciu pierwszego wywołania

Konstruktorzy publiczni

Kolekcjoner raportów błędów

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parametry
listener ITestInvocationListener

testDevice ITestDevice

Metody publiczne

dodajpredykat

public void addPredicate (BugreportCollector.Predicate p)

Parametry
p BugreportCollector.Predicate

blokuj do bezczynności

public void blockUntilIdle ()

Blokuj, dopóki moduł zbierający nie będzie zbierał żadnych raportów o błędach. Jeśli osoba zbierająca nie zbiera aktywnie raportu o błędzie, wróć natychmiast

pobierz podsumowanie

public TestSummary getSummary ()

Umożliwia InvocationListener zwrócenie podsumowania.

Zwroty
TestSummary TestSummary podsumowujący przebieg lub null

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

zestawAsynchroniczny

public void setAsynchronous (boolean asynchronous)

Ustaw, czy zbieranie raportów o błędach powinno zbierać raporty o błędach w innym wątku ( asynchronous = true ), czy też blokuj obiekt wywołujący do czasu przechwycenia raportu o błędach ( asynchronous = false ).

Parametry
asynchronous boolean

zestawNazwaOpisowa

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 powróci do domyślnego zachowania polegającego na serializacji nazwy zdarzenia, które spowodowało zebranie raportu o błędzie.

Parametry
name String

ustaw czas oczekiwania na urządzenie

public void setDeviceWaitTime (int waitTime)

Ustaw czas (w sekundach) oczekiwania, aż urządzenie będzie online, zanim spróbujemy przechwycić raport o błędzie. Jeżeli wynik będzie negatywny, kontrola nie zostanie przeprowadzona. Każdy wyjątek DeviceNotAvailableException napotkany podczas tego sprawdzania zostanie zarejestrowany i zignorowany.

Parametry
waitTime int

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testZakończony

public void testEnded (TestDescription test, 
                 testMetrics)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, test zakończył się pomyślnie. Zwraca również wszelkie metryki klucz/wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
test TestDescription : identyfikuje test

testMetrics : ERROR(/Map) emitowanych metryk

Test nieudany

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Będzie wywoływany pomiędzy testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testIgnorowany

public void testIgnored (TestDescription test)

Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

Parametry
test TestDescription : identyfikuje test

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.

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

Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.

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

Uruchomiono testRun

public void testRunStarted (String runName, 
                int testCount)

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

testCount int : całkowita liczba testów w przebiegu testu

testRunZatrzymany

public void testRunStopped (long elapsedTime)

Raportuje, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

DO ZROBIENIA: obecnie nieużywany, rozważ usunięcie

Parametry
elapsedTime long : urządzenie zgłosiło czas, który upłynął, w milisekundach

test rozpoczęty

public void testStarted (TestDescription test)

Zgłasza rozpoczęcie pojedynczego przypadku testowego. Starszy interfejs, jeśli to możliwe, należy używać testStarted(com.android.tradefed.result.TestDescription) .

Parametry
test TestDescription : identyfikuje test