NazwaMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

java.lang.Obiekt
com.android.tradefed.result.NameMangleListener


Odbiornik proxy do tłumaczenia metod testowych, klas i nazw pakietów w miarę raportowania wyników.

Streszczenie

Konstruktory publiczne

NameMangleListener ( ITestInvocationListener listener)

Metody publiczne

TestSummary getSummary ()

Umożliwia InvocationListener zwrócenie podsumowania.

void invocationEnded (long elapsedTime)

Zgłasza, że ​​wywołanie zakończyło się 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 testowego.

void testAssumptionFailure ( TestDescription test, String trace)

Wywoływana, gdy test atomowy oznacza, ż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 awarię pojedynczego przypadku testowego.

void testIgnored ( TestDescription test)

Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

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

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

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

Zgłasza koniec przebiegu testowego.

void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount)

Zgłasza początek przebiegu testowego.

void testRunStopped (long elapsedTime)

Przebieg testu raportów został zatrzymany przed zakończeniem z powodu żądania użytkownika.

void testStarted ( TestDescription test)

Raportuje początek pojedynczego przypadku testowego.

Metody chronione

TestDescription mangleTestId ( TestDescription test)

Ta metoda jest uruchamiana na wszystkich elementach TestDescription przekazywanych do metod testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) i ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) wywołań zwrotnych.

String mangleTestRunName (String name)

Ta metoda jest uruchamiana dla wszystkich nazw przebiegów testów, które są przekazywane do wywołania zwrotnego testRunStarted(String, int) .

Konstruktory publiczne

NazwaMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parametry
listener ITestInvocationListener

Metody publiczne

getStreszczenie

public TestSummary getSummary ()

Umożliwia InvocationListener zwrócenie podsumowania.

Zwroty
TestSummary TestSummary podsumowujący przebieg lub null

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

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

test zakończony

public void testEnded (TestDescription test, 
                 testMetrics)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten test zakończył się pomyślnie. Zwraca również wszelkie metryki klucza/wartości, 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 awarię pojedynczego przypadku testowego.

Zostanie wywołany między testStarted a testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

zignorowano test

public void testIgnored (TestDescription test)

Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

Parametry
test TestDescription : identyfikuje test

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.

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

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Zgłasza początek przebiegu testowego.

Parametry
runName String : nazwa uruchomienia testu

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

testRunZatrzymany

public void testRunStopped (long elapsedTime)

Przebieg testu raportów został zatrzymany przed zakończeniem z powodu żądania użytkownika.

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

Parametry
elapsedTime long : czas, który upłynął od urządzenia, w milisekundach

testRozpoczęty

public void testStarted (TestDescription test)

Raportuje początek pojedynczego przypadku testowego. Starszy interfejs powinien używać testStarted(com.android.tradefed.result.TestDescription) gdy tylko jest to możliwe.

Parametry
test TestDescription : identyfikuje test

Metody chronione

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Ta metoda jest uruchamiana na wszystkich elementach TestDescription przekazywanych do testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) i ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) wywołań zwrotnych. Metoda powinna zwrócić prawdopodobnie inny TestDescription , który zostanie przekazany do podrzędnego ITestInvocationListener , który został określony podczas konstruowania.

Implementacja powinna uważać, aby nie modyfikować oryginalnego TestDescription .

Domyślna implementacja przekazuje identyfikator przychodzący przez niezmodyfikowany.

Parametry
test TestDescription

Zwroty
TestDescription

mangleTestRunNazwa

protected String mangleTestRunName (String name)

Ta metoda jest uruchamiana dla wszystkich nazw przebiegów testów, które są przekazywane do wywołania zwrotnego testRunStarted(String, int) . Metoda powinna zwrócić prawdopodobnie inną nazwę przebiegu testu, która zostanie przekazana do podrzędnego ITestInvocationListener , który został określony podczas konstruowania.

Implementacja powinna uważać, aby nie zmodyfikować oryginalnej nazwy uruchomienia.

Domyślna implementacja przekazuje przychodzącą nazwę przebiegu testu przez niezmodyfikowaną.

Parametry
name String

Zwroty
String