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

Этот метод запускается для всех 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

Публичные методы

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 : ERROR(/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 : описательное имя данных ERROR(/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 : ERROR(/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