ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Объект
com.android.tradefed.result.CollectingTestListener
com.android.tradefed.invoker.ShardListener


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

Краткое содержание

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

ShardListener ( ITestInvocationListener main)

Создайте ShardListener .

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

getUnderlyingResultReporter ()
void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationStarted ( IInvocationContext context)

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

void logAssociation (String dataName, LogFile logFile)

В некоторых случаях лог должен быть жестко связан с тест-кейсом, но возможность сделать это на прямом testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) обратный вызов невозможен.

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

Возвращает True, если генератор отчетов поддерживает детализированные результаты, в противном случае — false.

void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

Предоставляет связанный журнал или данные отладки из вызова теста.

void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

void testModuleEnded ()

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

void testModuleStarted ( IInvocationContext moduleContext)

Сообщает о начале работы модуля.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

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

void testRunFailed ( FailureDescription failure)

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

void testRunFailed (String failureMessage)

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

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

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

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

ShardListener

public ShardListener (ITestInvocationListener main)

Создайте ShardListener .

Параметры
main ITestInvocationListener : ITestInvocationListener результаты должны быть перенаправлены. Чтобы предотвратить коллизии с другими ShardListener s, этот объект будет синхронизироваться с main при пересылке результатов. И результаты будут отправлены только после завершения сегмента вызова.

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

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Возвращает

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

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 : ERROR(/Throwable) причина сбоя

вызов запущен

public void invocationStarted (IInvocationContext context)

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

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

В некоторых случаях лог должен быть жестко связан с тест-кейсом, но возможность сделать это на прямом testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) обратный вызов невозможен. Таким образом, этот обратный вызов позволяет явно указать сильную ассоциацию.

Параметры
dataName String : имя данных

logFile LogFile : LogFile , который был зарегистрирован ранее и должен быть связан с тестовым примером.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Параметры
enableGranularResults boolean

supportGranularResults

public boolean supportGranularResults ()

Возвращает True, если генератор отчетов поддерживает детализированные результаты, в противном случае — false.

Возвращает
boolean

журнал испытаний

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

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Параметры
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

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

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

Параметры
failureMessage String : ERROR(/String) , описывающая причину сбоя запуска.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

Параметры
name String : имя запуска теста.

numTests int : общее количество тестов в тестовом прогоне

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

startTime long : время запуска, измеренное с помощью ERROR(/System#currentTimeMillis())