ИмяMangleListener
public abstract class NameMangleListener
extends Object
implements ITestInvocationListener
java.lang.Объект | |
↳ | com.android.tradefed.result.NameMangleListener |
Прокси-слушатель для преобразования имен тестовых методов, классов и пакетов по мере получения результатов.
Краткое содержание
Публичные конструкторы | |
---|---|
NameMangleListener ( ITestInvocationListener listener) |
Публичные методы | |
---|---|
TestSummary | getSummary () Позволяет InvocationListener возвращать сводку. |
void | invocationEnded (long elapsedTime) Сообщает, что вызов завершился успешно или из-за какой-либо ошибки. |
void | invocationFailed (Throwable cause) Сообщает о незавершенном вызове из-за некоторого состояния ошибки. |
void | invocationStarted ( IInvocationContext context) Сообщает о начале вызова теста. |
void | testAssumptionFailure ( TestDescription test, String trace) Вызывается, когда атомарный тест отмечает, что он принимает условие, которое является ложным. |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Сообщает об окончании выполнения отдельного тестового примера. |
void | testFailed ( TestDescription test, String trace) Сообщает о сбое отдельного тестового примера. |
void | testIgnored ( TestDescription test) Вызывается, когда тест не будет запущен, как правило, потому, что метод теста помечен org.junit.Ignore. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Предоставляет связанный журнал или данные отладки из вызова теста. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Сообщает об окончании тестового прогона. |
void | testRunFailed (String errorMessage) Не удалось выполнить тестовый запуск отчетов из-за неустранимой ошибки. |
void | testRunStarted (String runName, int testCount) Сообщает о начале тестового прогона. |
void | testRunStopped (long elapsedTime) Тестовый запуск отчетов остановлен до завершения по запросу пользователя. |
void | testStarted ( TestDescription test) Сообщает о начале отдельного тестового примера. |
Защищенные методы | |
---|---|
TestDescription | mangleTestId ( TestDescription test) Этот метод запускается для всех |
String | mangleTestRunName (String name) Этот метод запускается для всех имен тестовых запусков, которые передаются обратному вызову |
Публичные конструкторы
ИмяMangleListener
public NameMangleListener (ITestInvocationListener listener)
Параметры | |
---|---|
listener | ITestInvocationListener |
Публичные методы
getSummary
public TestSummary getSummary ()
Позволяет InvocationListener возвращать сводку.
Возвращает | |
---|---|
TestSummary | TestSummary обобщающий прогон, или null |
вызов завершен
public void invocationEnded (long elapsedTime)
Сообщает, что вызов завершился успешно или из-за какой-либо ошибки.
Будет автоматически вызываться фреймворком TradeFederation.Параметры | |
---|---|
elapsedTime | long : прошедшее время вызова в мс |
invocationFailed
public void invocationFailed (Throwable cause)
Сообщает о незавершенном вызове из-за некоторого состояния ошибки.
Будет автоматически вызываться фреймворком TradeFederation.Параметры | |
---|---|
cause | Throwable : Throwable причина сбоя |
вызов запущен
public void invocationStarted (IInvocationContext context)
Сообщает о начале вызова теста.
Будет автоматически вызываться фреймворком TradeFederation. Журналистам необходимо переопределить этот метод, чтобы поддерживать отчеты с нескольких устройств.
Параметры | |
---|---|
context | IInvocationContext : информация о вызове |
testAssummentFailure
public void testAssumptionFailure (TestDescription test, String trace)
Вызывается, когда атомарный тест отмечает, что он принимает условие, которое является ложным.
Параметры | |
---|---|
test | TestDescription : идентифицирует тест |
trace | String : трассировка стека сбоя |
testEnded
public void testEnded (TestDescription test,testMetrics)
Сообщает об окончании выполнения отдельного тестового примера.
Если testFailed(TestDescription, FailureDescription)
не был вызван, этот тест пройден. Также возвращает любые метрики типа "ключ-значение", которые могли быть созданы во время выполнения тестового примера.
Параметры | |
---|---|
test | TestDescription : идентифицирует тест |
testMetrics | ERROR(/Map) выдаваемых метрик |
testFailed
public void testFailed (TestDescription test, String trace)
Сообщает о сбое отдельного тестового примера.
Будет вызываться между testStarted и testEnded.
Параметры | |
---|---|
test | TestDescription : идентифицирует тест |
trace | String : трассировка стека сбоя |
тестИгнорируется
public void testIgnored (TestDescription test)
Вызывается, когда тест не будет запущен, как правило, потому, что метод теста помечен org.junit.Ignore.
Параметры | |
---|---|
test | TestDescription : идентифицирует тест |
журнал испытаний
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Предоставляет связанный журнал или данные отладки из вызова теста.
Должен вызываться доERROR(/ITestInvocationListener#invocationFailed(Throwable))
или ERROR(/ITestInvocationListener#invocationEnded(long))
Платформа TradeFederation автоматически вызовет этот метод, предоставив журнал хоста и, если применимо, logcat устройства.Параметры | |
---|---|
dataName | String : String описательное имя данных. например, "device_logcat". Примечание. dataName может не быть уникальным для каждого вызова. т.е. разработчики должны иметь возможность обрабатывать несколько вызовов с одним и тем же именем данных. |
dataType | LogDataType : LogDataType данных |
dataStream | InputStreamSource : InputStreamSource данных. Разработчики должны вызвать createInputStream, чтобы начать чтение данных, и обеспечить закрытие результирующего InputStream после завершения. Вызывающие должны убедиться, что источник данных остается доступным до тех пор, пока метод testLog не завершится. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Сообщает об окончании тестового прогона. ИСПРАВЛЕНИЕ: У нас не может быть двух интерфейсов Map<> с разными типами, поэтому здесь мы должны использовать HashMap.
Параметры | |
---|---|
elapsedTime | long : устройство сообщило о прошедшем времени в миллисекундах |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (String errorMessage)
Не удалось выполнить тестовый запуск отчетов из-за неустранимой ошибки.
Параметры | |
---|---|
errorMessage | String : String , описывающая причину сбоя запуска. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Сообщает о начале тестового прогона.
Параметры | |
---|---|
runName | String : имя запуска теста. |
testCount | int : общее количество тестов в тестовом прогоне |
testRunStopped
public void testRunStopped (long elapsedTime)
Тестовый запуск отчетов остановлен до завершения по запросу пользователя.
TODO: в настоящее время не используется, рассмотрите возможность удаления
Параметры | |
---|---|
elapsedTime | long : устройство сообщило о прошедшем времени в миллисекундах |
testStarted
public void testStarted (TestDescription test)
Сообщает о начале отдельного тестового примера. Старый интерфейс, по возможности следует использовать testStarted(com.android.tradefed.result.TestDescription)
.
Параметры | |
---|---|
test | TestDescription : идентифицирует тест |
Защищенные методы
mangleTestId
protected TestDescription mangleTestId (TestDescription test)
Этот метод запускается для всех TestDescription
, которые передаются в testStarted(com.android.tradefed.result.TestDescription)
, testFailed(com.android.tradefed.result.TestDescription, String)
и ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))
обратные вызовы. Метод должен возвращать, возможно, другое TestDescription
, которое будет передано нижестоящему прослушивателю ITestInvocationListener
, указанному во время построения.
Реализация должна быть осторожной, чтобы не изменить исходное TestDescription
.
Реализация по умолчанию пропускает входящий идентификатор без изменений.
Параметры | |
---|---|
test | TestDescription |
Возвращает | |
---|---|
TestDescription |
mangleTestRunName
protected String mangleTestRunName (String name)
Этот метод запускается для всех имен тестовых запусков, которые передаются обратному вызову testRunStarted(String, int)
. Метод должен возвращать, возможно, другое имя выполнения теста, которое будет передано нижестоящему прослушивателю ITestInvocationListener
, указанному во время построения.
Параметры | |
---|---|
name | String |
Возвращает | |
---|---|
String |