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)
Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie). |
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,
Raportuje zakończenie wykonywania pojedynczego przypadku testowego. |
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,
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 pojedynczego testu. |
Chronione metody | |
---|---|
TestDescription
|
mangleTestId(TestDescription test)
Ta metoda jest wykonywana dla wszystkich wartości |
String
|
mangleTestRunName(String name)
Ta metoda jest wywoływana w przypadku wszystkich nazw testów, które są przekazywane do funkcji wywołania zwrotnego |
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 wykonanie, lub wartość null. |
invocationEnded
public void invocationEnded (long elapsedTime)
Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).
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)
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; |
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 testowego.
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 |
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 : String nazwa opisowa danych, np. „device_logcat”. Uwaga: nazwa danych może nie być unikalna dla każdego wywołania. Oznacza to, że implementatorzy muszą mieć możliwość obsługi wielu wywołań z tą samą nazwą danych. |
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 pojedynczego testu. 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 |
Chronione metody
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))
. Metoda powinna zwrócić TestDescription
, który może być inny niż ITestInvocationListener
przekazywany do następnego ITestInvocationListener
, który został określony podczas tworzenia.
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 wywoływana w przypadku wszystkich nazw testów, które są przekazywane do funkcji 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 |