NazwaMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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


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

Streszczenie

Konstruktorzy publiczni

NameMangleListener ( ITestInvocationListener listener)

Metody publiczne

TestSummary getSummary ()

Zezwala InvocationListener na zwrócenie podsumowania.

void invocationEnded (long elapsedTime)

Informuje, ż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 jakiegoś błędu.

void invocationStarted ( IInvocationContext context)

Zgłasza początek wywołania testowego.

void testAssumptionFailure ( TestDescription test, String trace)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje warunek, który jest fałszywy

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

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

void testFailed ( TestDescription test, String trace)

Zgłasza niepowodzenie 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 skojarzone dane dziennika lub debugowania z wywołania testowego.

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

Raportuje koniec uruchomienia testowego.

void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

void testRunStarted (String runName, int testCount)

Raportuje początek uruchomienia testowego.

void testRunStopped (long elapsedTime)

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

void testStarted ( TestDescription test)

Raportuje początek indywidualnego przypadku testowego.

Metody chronione

TestDescription mangleTestId ( TestDescription test)

Ta metoda jest uruchamiana dla wszystkich TestDescription , które są przekazywane do testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) i ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) wywołania zwrotne.

String mangleTestRunName (String name)

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

Konstruktorzy publiczni

NazwaMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parametry
listener ITestInvocationListener

Metody publiczne

pobierz podsumowanie

public TestSummary getSummary ()

Zezwala InvocationListener na zwrócenie podsumowania.

Zwroty
TestSummary TestSummary podsumowujący przebieg lub null

inwokacjaZakończona

public void invocationEnded (long elapsedTime)

Informuje, ż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 trwania wywołania w ms

wywołanie nie powiodło się

public void invocationFailed (Throwable cause)

Zgłasza niekompletne wywołanie z powodu jakiegoś błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
cause Throwable : Throwable przyczyna niepowodzenia

wywołanieRozpoczęto

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ć zgłaszanie wielu urządzeń.

Parametry
context IInvocationContext : informacje o wywołaniu

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływane, gdy atomowy test oznaczy, że przyjmuje warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testZakończony

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten 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.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testIgnorowane

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

TestLog

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

Udostępnia skojarzone dane dziennika lub debugowania z wywołania testowego.

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, dziennik urządzenia.

Parametry
dataName String : opisowa nazwa danych typu String . 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ą data

dataType LogDataType : LogDataType danych

dataStream InputStreamSource : InputStreamSource danych. Realizatorzy powinni wywołać metodę createInputStream, aby rozpocząć odczytywanie danych i zapewnić zamknięcie wynikowego InputStream po zakończeniu. Wywołujący powinien upewnić się, że źródło danych pozostaje obecne i dostępne do momentu zakończenia metody testLog.

TestUruchomionyZakończony

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Raportuje koniec uruchomienia testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> o różnych typach, 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łoszone na koniec testu z Metric .

TestUruchomie się nie powiódł

public void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

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

testUruchomiony

public void testRunStarted (String runName, 
                int testCount)

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: obecnie nieużywane, rozważ usunięcie

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

testRozpoczęto

public void testStarted (TestDescription test)

Raportuje początek indywidualnego 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 dla wszystkich TestDescription , które są przekazywane do testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) i ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) wywołania zwrotne. 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 przychodzący identyfikator przez niezmodyfikowany.

Parametry
test TestDescription

Zwroty
TestDescription

magleTestRunName

protected String mangleTestRunName (String name)

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

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

Domyślna implementacja przekazuje nazwę przychodzącego uruchomienia testu przez niezmodyfikowane.

Parametry
name String

Zwroty
String