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

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.Объект
↳	com.android.tradefed.result.ResultForwarder

Известные прямые подклассы

FilteredResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultForwarder , TestTimeoutEnforcer

Фильтредрезультатфорвардер	Вариант `ResultForwarder` , который позволяет сообщать только белый список `TestDescription` .
JarHostTest.HostTestListener	Слушатель-оболочка, который перенаправляет все события, кроме testRunStarted() и testRunEnded(), встроенному слушателю.
Логсаверресултфорвардер	`ResultForwarder` для сохранения журналов с помощью глобальной файловой заставки.
LogcatCrashResultForwarder	Специальный слушатель: при сбоях (сбой процесса инструментирования) он попытается извлечь из logcat сбой и добавить его в сообщение об ошибке, связанное с тестом.
PythonBinaryHostTest.PythonForwarder	Пересылка результатов для замены имени запуска двоичным именем.
Результатандлогфорвардер	Пересылка для результатов и журналов событий.
Ретриресултфорвардер	Расширение `ResultForwarder` , которое всегда нажимает на заданный номер попытки.
ShardMainResultForwarder	Объект `ResultForwarder` , объединяющий результаты вызовов сегментированного теста.
ТестТимеаутЭнфорсер	Слушатели, которые позволяют проверить время выполнения данного тестового примера и завершить его, если он превышает заданный тайм-аут.

Известные косвенные подклассы

GranularRetriableTestWrapper.StartEndCollector , RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Помощник класса, чтобы поймать пропущенное начало и конец запуска.
Ретрилогсаверресултфорвардер	Переадресатор, который также обрабатывает текущую попытку, в которой мы находимся.

ITestInvocationListener , который перенаправляет результаты вызова в список других прослушивателей.

Резюме

Публичные конструкторы
`ResultForwarder ( listeners)` `ResultForwarder ( listeners)` Создайте `ResultForwarder` .
`ResultForwarder ( ITestInvocationListener... listeners)` Альтернативный конструктор переменной arg для `ResultForwarder` .

Защищенные конструкторы
`ResultForwarder ()` Создайте `ResultForwarder` с настройкой отложенного прослушивателя.

Публичные методы
`TestSummary`	`getSummary ()` Позволяет InvocationListener возвращать сводку.
`void`	`invocationEnded (long elapsedTime)` Сообщает, что вызов завершился успешно или из-за какой-либо ошибки.
`void`	`invocationFailed ( FailureDescription failure)` Сообщает о незавершенном вызове из-за некоторого состояния ошибки.
`void`	`invocationFailed (Throwable cause)` Сообщает о незавершенном вызове из-за некоторого состояния ошибки.
`void`	`invocationStarted ( IInvocationContext context)` Сообщает о начале вызова теста.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` Вызывается, когда атомарный тест отмечает, что он принимает условие, которое является ложным.
`void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Вызывается, когда атомарный тест отмечает, что он принимает условие, которое является ложным.
`void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` Альтернатива `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` где мы можем напрямую указать время окончания.
`void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` Сообщает об окончании выполнения отдельного тестового примера.
`void`	`testFailed ( TestDescription test, FailureDescription failure)` Сообщает о сбое отдельного тестового примера.
`void`	`testFailed ( TestDescription test, String trace)` Сообщает о сбое отдельного тестового примера.
`void`	`testIgnored ( TestDescription test)` Вызывается, когда тест не будет запущен, как правило, потому, что метод теста помечен org.junit.Ignore.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Предоставляет связанный журнал или данные отладки из вызова теста.
`void`	`testModuleEnded ()` Сообщает об окончании выполнения модуля.
`void`	`testModuleStarted ( IInvocationContext moduleContext)` Сообщает о начале работы модуля.
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` Сообщает об окончании тестового прогона.
`void`	`testRunFailed ( FailureDescription failure)` Не удалось выполнить тестовый запуск отчетов из-за сбоя, описанного в `FailureDescription` .
`void`	`testRunFailed (String errorMessage)` Не удалось выполнить тестовый запуск отчетов из-за неустранимой ошибки.
`void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Сообщает о начале тестового прогона.
`void`	`testRunStarted (String runName, int testCount)` Сообщает о начале тестового прогона.
`void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Сообщает о начале тестового прогона.
`void`	`testRunStopped (long elapsedTime)` Тестовый запуск отчетов остановлен до завершения по запросу пользователя.
`void`	`testStarted ( TestDescription test, long startTime)` Альтернатива `testStarted(com.android.tradefed.result.TestDescription)` , где мы также указываем, когда тест был запущен, в сочетании с `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` для точного измерения .
`void`	`testStarted ( TestDescription test)` Сообщает о начале отдельного тестового случая.

Защищенные методы
	`getListeners ()` Получить список слушателей.
`void`	`setListeners ( listeners)` `setListeners ( listeners)` Установите слушателей после построения.
`void`	`setListeners ( ITestInvocationListener... listeners)` Установите слушателей после построения.

Публичные конструкторы

ResultForwarder

public ResultForwarder ( listeners)

Создайте ResultForwarder .

Параметры
`listeners`	: настоящие `ITestInvocationListener` для пересылки результатов

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Альтернативный конструктор переменной arg для ResultForwarder .

Параметры
`listeners`	`ITestInvocationListener` : настоящий `ITestInvocationListener` для пересылки результатов

Защищенные конструкторы

ResultForwarder

protected ResultForwarder ()

Создайте ResultForwarder с настройкой отложенного прослушивателя. Предназначен только для использования подклассами.

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

getSummary

public TestSummary getSummary ()

Позволяет InvocationListener возвращать сводку.

Возвращает
`TestSummary`	`TestSummary` , обобщающий прогон, или null

вызов завершен

public void invocationEnded (long elapsedTime)

Сообщает, что вызов завершился успешно или из-за какой-либо ошибки.

Будет автоматически вызываться фреймворком TradeFederation.

Параметры
`elapsedTime`	`long` : прошедшее время вызова в мс

invocationFailed

public void invocationFailed (FailureDescription failure)

Сообщает о незавершенном вызове из-за некоторого состояния ошибки.

Будет автоматически вызываться фреймворком TradeFederation.

Параметры
`failure`	`FailureDescription` : `FailureDescription` описывающий причину сбоя.

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` : трассировка стека сбоя

testAssummentFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Вызывается, когда атомарный тест отмечает, что он принимает условие, которое является ложным.

Параметры
`test`	`TestDescription` : идентифицирует тест
`failure`	`FailureDescription` : `FailureDescription` описывающий сбой и его контекст.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Альтернатива ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) где мы можем напрямую указать время окончания. Объедините с testStarted(com.android.tradefed.result.TestDescription, long) для точного измерения.

Параметры
`test`	`TestDescription` : идентифицирует тест
`endTime`	`long` : время окончания теста, измеренное с помощью `System.currentTimeMillis()` .
`testMetrics`	: `ERROR(/Map)` выдаваемых метрик

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Сообщает об окончании выполнения отдельного тестового примера.

Если testFailed(TestDescription, FailureDescription) не был вызван, этот тест пройден. Также возвращает любые метрики типа "ключ-значение", которые могли быть созданы во время выполнения тестового примера.

Параметры
`test`	`TestDescription` : идентифицирует тест
`testMetrics`	: `ERROR(/Map)` выдаваемых метрик

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Сообщает о сбое отдельного тестового примера.

Будет вызываться между testStarted и testEnded.

Параметры
`test`	`TestDescription` : идентифицирует тест
`failure`	`FailureDescription` : `FailureDescription` описывающий сбой и его контекст.

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 не завершится.

testModuleEnded

public void testModuleEnded ()

Сообщает об окончании выполнения модуля.

тестмодулестартед

public void testModuleStarted (IInvocationContext moduleContext)

Сообщает о начале работы модуля. Этот обратный вызов связан с testModuleEnded() и является необязательным в последовательности. Он используется только во время запуска, в котором используются модули: бегуны на основе набора.

Параметры
`moduleContext`	`IInvocationContext` : `IInvocationContext` модуля.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Сообщает об окончании тестового прогона. ИСПРАВЛЕНИЕ: У нас не может быть двух интерфейсов Map<> с разными типами, поэтому здесь мы должны использовать HashMap.

Параметры
`elapsedTime`	`long` : устройство сообщило о прошедшем времени в миллисекундах
`runMetrics`	: пары ключ-значение, о которых сообщается в конце тестового прогона с `Metric` .

testRunFailed

public void testRunFailed (FailureDescription failure)

Не удалось выполнить тестовый запуск отчетов из-за сбоя, описанного в FailureDescription .

Параметры
`failure`	`FailureDescription` : `FailureDescription` описывающий сбой и его контекст.

testRunFailed

public void testRunFailed (String errorMessage)

Не удалось выполнить тестовый запуск отчетов из-за неустранимой ошибки.

Параметры
`errorMessage`	`String` : `String` , описывающая причину сбоя запуска.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Сообщает о начале тестового прогона.

Параметры
`runName`	`String` : имя запуска теста.
`testCount`	`int` : общее количество тестов в тестовом прогоне
`attemptNumber`	`int` : номер заказа, идентифицирующий различные попытки одного и того же runName, которые выполняются несколько раз. ПопыткаNumber имеет индекс 0 и должна увеличиваться каждый раз, когда происходит новый запуск. Например, тест гранулированно повторяется 3 раза, он должен иметь 4 полных запуска под одним и тем же именем запуска, а число попыток — от 0 до 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Сообщает о начале тестового прогона.

Параметры
`runName`	`String` : имя запуска теста.
`testCount`	`int` : общее количество тестов в тестовом прогоне

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Сообщает о начале тестового прогона.

Параметры
`runName`	`String` : имя запуска теста.
`testCount`	`int` : общее количество тестов в тестовом прогоне
`attemptNumber`	`int` : номер заказа, идентифицирующий различные попытки одного и того же runName, которые выполняются несколько раз. ПопыткаNumber имеет индекс 0 и должна увеличиваться каждый раз, когда происходит новый запуск. Например, тест гранулированно повторяется 3 раза, он должен иметь 4 полных запуска под одним и тем же именем запуска, а число попыток — от 0 до 3.
`startTime`	`long` : время запуска, измеренное с помощью `System.currentTimeMillis()` .

testRunStopped

public void testRunStopped (long elapsedTime)

Тестовый запуск отчетов остановлен до завершения по запросу пользователя.

TODO: в настоящее время не используется, рассмотрите возможность удаления

Параметры
`elapsedTime`	`long` : устройство сообщило о прошедшем времени в миллисекундах

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Альтернатива testStarted(com.android.tradefed.result.TestDescription) , где мы также указываем, когда тест был запущен, в сочетании с ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) для точного измерения .

Параметры
`test`	`TestDescription` : идентифицирует тест
`startTime`	`long` : время запуска теста, измеренное с помощью `System.currentTimeMillis()` .

testStarted

public void testStarted (TestDescription test)

Сообщает о начале отдельного тестового случая. Старый интерфейс, по возможности следует использовать testStarted(com.android.tradefed.result.TestDescription) .

Параметры
`test`	`TestDescription` : идентифицирует тест

Защищенные методы

getListeners

protected  getListeners ()

Получить список слушателей. Предназначен только для использования подклассами.

Возвращает
	Список `ITestInvocationListener` s.

setListeners

protected void setListeners ( listeners)

Установите слушателей после построения. Предназначен только для использования подклассами.

Параметры
`listeners`	: настоящие `ITestInvocationListener` для пересылки результатов

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Установите слушателей после построения. Предназначен только для использования подклассами.

Параметры
`listeners`	`ITestInvocationListener` : настоящий `ITestInvocationListener` для пересылки результатов