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 ( ITestInvocationListener... listeners) Установите слушателей после построения.
void	setListeners ( listeners) setListeners ( 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 (ITestInvocationListener... listeners)

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

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

setListeners

protected void setListeners ( listeners)

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

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