ShardListener
public class ShardListener
extends CollectingTestListener
implements ISupportGranularResults
java.lang.Объект | ||
↳ | com.android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.invoker.ShardListener |
ITestInvocationListener
, который собирает результаты из сегмента вызова (т.н. разделение вызова для параллельного выполнения на нескольких ресурсах) и перенаправляет их другому прослушивателю.
Краткое содержание
Публичные конструкторы | |
---|---|
ShardListener ( ITestInvocationListener main) Создайте |
Публичные методы | |
---|---|
getUnderlyingResultReporter () | |
void | invocationEnded (long elapsedTime) Сообщает, что вызов завершился успешно или из-за какой-либо ошибки. |
void | invocationFailed ( FailureDescription failure) Сообщает о незавершенном вызове из-за некоторого состояния ошибки. |
void | invocationFailed (Throwable cause) Сообщает о незавершенном вызове из-за некоторого состояния ошибки. |
void | invocationStarted ( IInvocationContext context) Сообщает о начале вызова теста. |
void | logAssociation (String dataName, LogFile 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) Не удалось выполнить тестовый запуск отчетов из-за сбоя, описанного в |
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
publicgetUnderlyingResultReporter ()
Возвращает | |
---|---|
вызов завершен
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()) |