Имя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)

Этот метод запускается для всех TestDescription , которые передаются в testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) и ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) обратные вызовы.

String mangleTestRunName (String name)

Этот метод запускается для всех имен запуска тестов, которые передаются в обратный вызов testRunStarted(String, int) .

Общественные конструкторы

Имя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)

Сообщает об окончании тестового запуска. ИСПРАВЛЕНИЕ: мы не можем иметь два интерфейса 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 : устройство сообщило прошедшее время в миллисекундах.

тестНачало

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