Результатфорвардер

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(), встроенному прослушивателю. LogSaverResultForwarder ResultForwarder для сохранения журналов с помощью глобальной системы сохранения файлов. LogcatCrashResultForwarder Специальный прослушиватель: в случае сбоя (сбоя процесса инструментирования) он попытается извлечь из логарифма сбой и добавить его к сообщению об ошибке, связанному с тестом. 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 () Позволяет InvokeListener возвращать сводку.
void	invocationEnded (long elapsedTime) Сообщает, что вызов завершился успешно или из-за какой-либо ошибки.
void	invocationFailed ( FailureDescription failure) Сообщает о неполном вызове из-за какой-либо ошибки.
void	invocationFailed (Throwable cause) Сообщает о неполном вызове из-за какой-либо ошибки.
void	invocationSkipped ( SkipReason reason) Сообщает о пропущенном вызове
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	testSkipped ( TestDescription test, SkipReason reason) Вызывается, когда тест пропускается и не выполняется по причине, которая обычно не ожидается.
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 ( ITestInvocationListener... listeners) Установите слушателей после построения.
void	setListeners ( listeners) setListeners ( listeners) Установите слушателей после построения.

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

Результатфорвардер

public ResultForwarder ( listeners)

Создайте ResultForwarder .

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

Результатфорвардер

public ResultForwarder (ITestInvocationListener... listeners)

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

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

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

Результатфорвардер

protected ResultForwarder ()

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

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

получитьСводка

public TestSummary getSummary ()

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

Возврат
TestSummary	TestSummary , суммирующий прогон, или нулевой

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

public void invocationEnded (long elapsedTime)

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

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

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

вызов не пройден

public void invocationFailed (FailureDescription failure)

Сообщает о неполном вызове из-за какой-либо ошибки.

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

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

вызов не пройден

public void invocationFailed (Throwable cause)

Сообщает о неполном вызове из-за какой-либо ошибки.

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

Параметры
cause	Throwable : Throwable причина сбоя

вызовПропущен

public void invocationSkipped (SkipReason reason)

Сообщает о пропущенном вызове

Параметры
reason	SkipReason

вызовНачало

public void invocationStarted (IInvocationContext context)

Сообщает о начале тестового вызова.

Будет автоматически вызываться платформой TradeFederation. Создателям отчетов необходимо переопределить этот метод для поддержки отчетов с нескольких устройств.

Параметры
context	IInvocationContext : информация о вызове.

тестПредположениеОтказ

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Параметры
test	TestDescription : идентифицирует тест.
trace	String : трассировка стека сбоя

тестПредположениеОтказ

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) выданных метрик

тест не пройден

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

тест не пройден

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 ()

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

testModuleStarted

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 : номер заказа, идентифицирующий различные попытки одного и того же имени запуска, которые выполняются несколько раз. Номер попытки имеет индекс 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 : номер заказа, идентифицирующий различные попытки одного и того же имени запуска, которые выполняются несколько раз. Номер попытки имеет индекс 0 и должен увеличиваться каждый раз при новом запуске. например, тест гранулярно повторяется 3 раза, всего должно быть 4 запуска под одним и тем же именем запуска, а номер попытки — от 0 до 3.
startTime	long : время начала прогона, измеренное с помощью System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

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

тестПропущен

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

тестНачало

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()

тестНачало

public void testStarted (TestDescription test)

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

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

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

getListeners

protected  getListeners ()

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

Возврат
	Список ITestInvocationListener .

setListeners

protected void setListeners (ITestInvocationListener... listeners)

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

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

setListeners

protected void setListeners ( listeners)

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

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