Эта страница переведена с помощью Cloud Translation API.

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