Detektor NameMangleListener
public
abstract
class
NameMangleListener
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.NameMangleListener, |
Detektor serwera proxy do translacji metod testowych, klas i nazw pakietów w miarę raportowania wyników.
Podsumowanie
Konstruktory publiczne | |
---|---|
NameMangleListener(ITestInvocationListener listener)
|
Metody publiczne | |
---|---|
TestSummary
|
getSummary()
Umożliwia usłudze InvocationListener zwrócenie podsumowania. |
void
|
invocationEnded(long elapsedTime)
Raportuje, że wywołanie zostało zakończone (prawidłowo lub z powodu błędu) . |
void
|
invocationFailed(Throwable cause)
Zgłasza niepełne wywołanie z powodu błędu. |
void
|
invocationStarted(IInvocationContext context)
Raportuje początek wywołania testu. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o fałszywej wartości. |
void
|
testEnded(TestDescription test,
Raportuje koniec wykonania danego 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, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignoruj. |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Podaje powiązany dziennik lub dane debugowania z wywołania testu. |
void
|
testRunEnded(long elapsedTime,
Koniec przebiegu testowego raportów. |
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)
Test raportów został zatrzymany przed ukończeniem na prośbę użytkownika. |
void
|
testStarted(TestDescription test)
Raportuje początek pojedynczego przypadku testowego. |
Metody chronione | |
---|---|
TestDescription
|
mangleTestId(TestDescription test)
Ta metoda jest uruchamiana we wszystkich obiektach |
String
|
mangleTestRunName(String name)
Ta metoda jest uruchamiana przy wszystkich nazwach uruchomień testowych przekazywanych do
|
Konstruktory publiczne
Detektor NameMangleListener
public NameMangleListener (ITestInvocationListener listener)
Parametry | |
---|---|
listener |
ITestInvocationListener |
Metody publiczne
getPodsumowanie
public TestSummary getSummary ()
Umożliwia usłudze InvocationListener zwrócenie podsumowania.
Zwroty | |
---|---|
TestSummary |
TestSummary podsumowujący uruchomienie lub wartość null |
Zakończenie wywołania
public void invocationEnded (long elapsedTime)
Raportuje, że wywołanie zostało zakończone (prawidłowo lub z powodu błędu) .
będzie automatycznie wywoływana przez platformę federacji handlowej.
Parametry | |
---|---|
elapsedTime |
long : czas, jaki upłynął wywołania w milisekundach, |
Niepowodzenie wywołania
public void invocationFailed (Throwable cause)
Zgłasza niepełne wywołanie z powodu błędu.
będzie automatycznie wywoływana przez platformę federacji handlowej.
Parametry | |
---|---|
cause |
Throwable : przyczyna błędu (Throwable ). |
Rozpoczęcie wywoływania
public void invocationStarted (IInvocationContext context)
Raportuje początek wywołania testu.
będzie automatycznie wywoływana przez platformę federacji handlowej. Raportujący muszą zastąpić aby umożliwić raportowanie wielu urządzeń.
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 niepowodzenia |
testZakończony
public void testEnded (TestDescription test,testMetrics)
Raportuje koniec wykonania danego przypadku testowego.
Jeśli funkcja testFailed(TestDescription, FailureDescription)
nie została wywołana, test zaliczony. Zwraca również dowolną parę klucz/wartość
wskaźniki, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
testMetrics |
: ERROR(/Map) wyemitowanych wskaźników |
Niepowodzenie testu
public void testFailed (TestDescription test, String trace)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Jest wywoływana między testStarted a testEnded.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
trace |
String : zrzut stosu niepowodzenia |
testignorowany
public void testIgnored (TestDescription test)
Wywoływana, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignoruj.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
dziennik testów
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Podaje powiązany dziennik lub dane debugowania z wywołania testu.
Należy wywołać przed ERROR(/ITestInvocationListener#invocationFailed(Throwable))
lub
ERROR(/ITestInvocationListener#invocationEnded(long))
Platforma federacji handlu detalicznego automatycznie wywoła tę metodę, dostarczając dziennik hosta. a w razie potrzeby także dziennik urządzenia.
Parametry | |
---|---|
dataName |
String : opisowa nazwa danych typu String . np. „device_logcat”. Notatka
Wartość dataName nie może być unikalna na każdym wywołaniu. Oznacza to, że implementujący muszą być w stanie obsłużyć
wiele wywołań z tą samą wartością dataName |
dataType |
LogDataType : element LogDataType danych |
dataStream |
InputStreamSource : element InputStreamSource danych. Implementatorzy powinni wywołać
createInputStream, aby zacząć odczytywać dane i upewnić się, że
Strumień wejściowy po zakończeniu. Rozmówca powinien zadbać o to, aby źródło danych było nadal źródłem danych.
obecny i dostępny do chwili zakończenia działania metody testLog. |
Zakończono bieg testowy
public void testRunEnded (long elapsedTime,runMetrics)
Koniec przebiegu testowego raportów. NAPRAWDŹ: nie możemy mieć dwóch map<> z interfejsami różnego typu. musimy użyć Skrótu HashMap.
Parametry | |
---|---|
elapsedTime |
long : czas, który upłynął od urządzenia, w milisekundach |
runMetrics |
: pary klucz-wartość raportowane po zakończeniu testu z użyciem Metric . |
Niepowodzenie testu uruchomienia
public void testRunFailed (String errorMessage)
Nie udało się wykonać testu raportów z powodu błędu krytycznego.
Parametry | |
---|---|
errorMessage |
String : String z opisem przyczyny niepowodzenia uruchomienia. |
Uruchomiono test
public void testRunStarted (String runName, int testCount)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa uruchomienia testu |
testCount |
int : łączna liczba testów w teście |
Zatrzymano uruchomienie testu
public void testRunStopped (long elapsedTime)
Test raportów został zatrzymany przed ukończeniem na prośbę użytkownika.
DO ZROBIENIA: obecnie nieużywane, rozważ usunięcie
Parametry | |
---|---|
elapsedTime |
long : czas, który upłynął od urządzenia, w milisekundach |
testStarted (rozpoczęto test)
public void testStarted (TestDescription test)
Raportuje początek pojedynczego przypadku testowego. W starszym interfejsie należy w miarę możliwości używać interfejsu testStarted(com.android.tradefed.result.TestDescription)
.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
Metody chronione
IdentyfikatorTestu mangle
protected TestDescription mangleTestId (TestDescription test)
Ta metoda jest uruchamiana we wszystkich obiektach TestDescription
przekazywanych do wywołań zwrotnych 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ć błąd
być może inny element TestDescription
, który zostanie przekazany do niższego strumienia ITestInvocationListener
określonego podczas budowy.
Pamiętaj, by podczas implementacji nie zmieniać oryginalnego elementu TestDescription
.
Domyślna implementacja przekazuje przychodzące identyfikatory bez zmian.
Parametry | |
---|---|
test |
TestDescription |
Zwroty | |
---|---|
TestDescription |
NazwaTestu mangle
protected String mangleTestRunName (String name)
Ta metoda jest uruchamiana przy wszystkich nazwach uruchomień testowych przekazywanych do
testRunStarted(String, int)
oddzwonienie. Metoda powinna zwrócić prawdopodobnie inną wartość
nazwa uruchomienia testu, która będzie przekazywana do późniejszego strumienia ITestInvocationListener
, która była
określonych podczas budowy.
Podczas implementacji należy pamiętać, aby nie zmienić nazwy oryginalnego uruchomienia.
Domyślna implementacja przekazuje nazwę uruchomienia testu przychodzącego jako niezmodyfikowana.
Parametry | |
---|---|
name |
String |
Zwroty | |
---|---|
String |