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 |
String | mangleTestRunName (String name) Ta metoda jest uruchamiana dla wszystkich nazw przebiegów testów, które są przekazywane do wywołania zwrotnego |
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 przedERROR(/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 | 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.
Parametry | |
---|---|
name | String |
Zwroty | |
---|---|
String |