ИмяMangleListener
public abstract class NameMangleListener
extends Object
implements ITestInvocationListener
java.lang.Объект | |
↳ | com.android.tradefed.result.NameMangleListener |
Прослушиватель прокси-сервера для перевода имен тестовых методов, классов и пакетов по мере сообщения о результатах.
Краткое содержание
Общественные конструкторы | |
---|---|
NameMangleListener ( ITestInvocationListener listener) |
Публичные методы | |
---|---|
TestSummary | getSummary () Позволяет InvokeListener возвращать сводку. |
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 |
Публичные методы
получитьСводка
public TestSummary getSummary ()
Позволяет InvokeListener возвращать сводку.
Возврат | |
---|---|
TestSummary | TestSummary суммирующий прогон, или нулевой |
вызовЗавершен
public void invocationEnded (long elapsedTime)
Сообщает, что вызов завершился успешно или из-за какой-либо ошибки.
Будет автоматически вызываться платформой TradeFederation.Параметры | |
---|---|
elapsedTime | long : прошедшее время вызова в мс. |
вызов не пройден
public void invocationFailed (Throwable cause)
Сообщает о неполном вызове из-за какой-либо ошибки.
Будет автоматически вызываться платформой TradeFederation.Параметры | |
---|---|
cause | Throwable : Throwable причина сбоя |
вызовНачало
public void invocationStarted (IInvocationContext context)
Сообщает о начале тестового вызова.
Будет автоматически вызываться платформой TradeFederation. Создателям отчетов необходимо переопределить этот метод для поддержки отчетов с нескольких устройств.
Параметры | |
---|---|
context | IInvocationContext : информация о вызове. |
тестПредположениеОтказ
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) выданных метрик |
тест не пройден
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)
Сообщает об окончании тестового запуска.
Параметры | |
---|---|
elapsedTime | long : устройство сообщило прошедшее время в миллисекундах. |
runMetrics |
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 : устройство сообщило прошедшее время в миллисекундах. |
тестНачало
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 |