Detektor NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Słuchający pośrednik służący do tłumaczenia nazw metody testu, klasy i pakietu podczas raportowania wyników.

Podsumowanie

Konstruktory publiczne

NameMangleListener(ITestInvocationListener listener)

Metody publiczne

TestSummary getSummary()

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

void invocationEnded(long elapsedTime)

Raport o zakończeniu wywołania (z powodu błędu lub bez błędu).

void invocationFailed(Throwable cause)

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

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 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ływana, 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 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ę wykonać testu raportów z powodu błędu krytycznego.

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.

Chronione metody

TestDescription mangleTestId(TestDescription test)

Ta metoda jest wykonywana w przypadku wszystkich wartości TestDescription przekazywanych do funkcji zwracających wartości testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) i ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)).

String mangleTestRunName(String name)

Ta metoda jest wykonywana w przypadku wszystkich nazw testów przekazanych do funkcji wywołania zwrotnego testRunStarted(String, int).

Konstruktory publiczne

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parametry
listener ITestInvocationListener

Metody publiczne

getSummary

public TestSummary getSummary ()

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

Zwroty
TestSummary TestSummary podsumowujący uruchomienie lub wartość null

invocationEnded

public void invocationEnded (long elapsedTime)

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

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 błędu (Throwable).

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.

Niepowodzenie testuZałożenia Niepowodzeń

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości.

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

Niepowodzenie testu

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: opisowa nazwa danych typu String, np. „device_logcat”. Uwaga: imię i nazwisko może nie być unikalne w przypadku każdego wywołania. Oznacza to, że 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. Wywołujący powinny dbać o to, aby źródło danych było dostępne i dostępne do chwili zakończenia działania 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ę wykonać testu raportów z powodu błędu krytycznego.

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 uruchomienia testu
testCount int: łączna liczba testów w sesji testowej

Zatrzymano uruchomienie testu

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

Metody chronione

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Ta metoda jest wykonywana dla wszystkich wartości TestDescription przekazywanych do funkcji zwracających wartości testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) i ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). Ta metoda powinna zwracać prawdopodobnie inny element TestDescription, który zostanie przekazany do niższego strumienia ITestInvocationListener określonego podczas budowy.

Implementacja powinna być ostrożna, aby nie zmodyfikować oryginalnego TestDescription.

Domyślna implementacja przekazuje przychodzący identyfikator bez zmian.

Parametry
test TestDescription

Zwroty
TestDescription

mangleTestRunName

protected String mangleTestRunName (String name)

Ta metoda jest uruchamiana przy wszystkich nazwach uruchomień testowych przekazywanych do wywołania zwrotnego testRunStarted(String, int). Metoda powinna zwracać nazwę testu, która może być inna niż nazwa przekazywana do ITestInvocationListener, która została określona podczas tworzenia.

Implementacja powinna być ostrożna, aby nie zmodyfikować pierwotnej nazwy uruchomienia.

Domyślna implementacja przekazuje przychodzącą nazwę testu bez zmian.

Parametry
name String

Zwroty
String