SubprocessResultsReporter
public class SubprocessResultsReporter
extends Object
implements ILogSaverListener , ISupportGranularResults , ITestInvocationListener
java.lang.Объект | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
Реализует ITestInvocationListener
который указывается как result_reporter и пересылает из подпроцесса результаты тестов, запусков тестов и вызовов тестов.
Краткое содержание
Общественные конструкторы | |
---|---|
SubprocessResultsReporter () |
Публичные методы | |
---|---|
void | close () |
TestSummary | getSummary () Позволяет InvokeListener возвращать сводку. |
void | invocationEnded (long elapsedTime) Сообщает, что вызов завершился успешно или из-за какой-либо ошибки. |
void | invocationFailed ( FailureDescription failure) Сообщает о неполном вызове из-за какой-либо ошибки. |
void | invocationFailed (Throwable cause) Сообщает о неполном вызове из-за какой-либо ошибки. |
void | invocationStarted ( IInvocationContext context) Сообщает о начале тестового вызова. |
void | logAssociation (String dataName, LogFile logFile) В некоторых случаях журнал должен быть тесно связан с тестовыми примерами, но возможность сделать это напрямую |
void | printEvent (String key, Object event) Помощник для печати ключа события, а затем объекта json. |
void | setOutputTestLog (boolean outputTestLog) Устанавливает, должны ли мы выводить зарегистрированный тест или нет. |
boolean | supportGranularResults () Возвращает True, если генератор отчетов поддерживает детализированные результаты, в противном случае — false. |
void | testAssumptionFailure ( TestDescription testId, String trace) Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие. |
void | testAssumptionFailure ( TestDescription testId, FailureDescription failure) Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие. |
void | testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics) Альтернатива |
void | testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics) Сообщает об окончании выполнения отдельного тестового примера. |
void | testFailed ( TestDescription testId, FailureDescription failure) Сообщает о сбое отдельного тестового примера. |
void | testFailed ( TestDescription testId, String reason) Сообщает о сбое отдельного тестового примера. |
void | testIgnored ( TestDescription testId) Вызывается, когда тест не будет запускаться, обычно потому, что метод теста помечен с помощью org.junit.Ignore. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Предоставляет связанные данные журнала или отладки из тестового вызова. |
void | testModuleEnded () Сообщает об окончании выполнения модуля. |
void | testModuleStarted ( IInvocationContext moduleContext) Сообщает о начале работы модуля. |
void | testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics) Сообщает об окончании тестового запуска. |
void | testRunFailed ( FailureDescription failure) Тестовый запуск отчетов не удалось завершить из-за сбоя, описанного в поле |
void | testRunFailed (String reason) Тестовый запуск отчетов не удалось завершить из-за фатальной ошибки. |
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 arg0) Тестовый запуск отчетов остановлен до завершения по запросу пользователя. |
void | testSkipped ( TestDescription testId, SkipReason reason) Вызывается, когда тест пропускается и не выполняется по причине, которая обычно не ожидается. |
void | testStarted ( TestDescription testId, long startTime) Альтернатива |
void | testStarted ( TestDescription testId) Сообщает о начале отдельного тестового примера. |
Общественные конструкторы
SubprocessResultsReporter
public SubprocessResultsReporter ()
Публичные методы
закрывать
public void close ()
получитьСводка
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 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 , который был зарегистрирован ранее и должен быть связан с тестовым примером. |
printEvent
public void printEvent (String key, Object event)
Помощник для печати ключа события, а затем объекта json.
Параметры | |
---|---|
key | String |
event | Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
Устанавливает, должны ли мы выводить зарегистрированный тест или нет.
Параметры | |
---|---|
outputTestLog | boolean |
поддержкаGranularResults
public boolean supportGranularResults ()
Возвращает True, если генератор отчетов поддерживает детализированные результаты, в противном случае — false.
Возврат | |
---|---|
boolean |
тестПредположениеОтказ
public void testAssumptionFailure (TestDescription testId, String trace)
Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |
trace | String : трассировка стека сбоя |
тестПредположениеОтказ
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
Вызывается, когда атомарный тест отмечает, что он предполагает ложное условие.
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |
failure | FailureDescription : FailureDescription описывающая сбой и его контекст. |
testEnded
public void testEnded (TestDescription testId, long endTime,metrics)
Альтернатива ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
где мы можем напрямую указать время окончания. Объедините его с testStarted(com.android.tradefed.result.TestDescription, long)
для точного измерения.
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |
endTime | long : время окончания теста, измеренное с помощью System.currentTimeMillis() |
metrics | ERROR(/Map) выданных метрик |
testEnded
public void testEnded (TestDescription testId,metrics)
Сообщает об окончании выполнения отдельного тестового примера.
Если testFailed(TestDescription, FailureDescription)
не был вызван, этот тест пройден. Также возвращает любые метрики ключ/значение, которые могли быть созданы во время выполнения тестового примера.
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |
metrics | ERROR(/Map) выданных метрик |
тест не пройден
public void testFailed (TestDescription testId, FailureDescription failure)
Сообщает о сбое отдельного тестового примера.
Будет вызываться между testStarted и testEnded.
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |
failure | FailureDescription : FailureDescription описывающая сбой и его контекст. |
тест не пройден
public void testFailed (TestDescription testId, String reason)
Сообщает о сбое отдельного тестового примера.
Будет вызываться между testStarted и testEnded.
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |
reason | String : трассировка стека сбоя |
тестИгнорируется
public void testIgnored (TestDescription testId)
Вызывается, когда тест не будет запускаться, обычно потому, что метод теста помечен с помощью org.junit.Ignore.
Параметры | |
---|---|
testId | 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 time,runMetrics)
Сообщает об окончании тестового запуска.
Параметры | |
---|---|
time | long : устройство сообщило прошедшее время в миллисекундах. |
runMetrics |
testRunFailed
public void testRunFailed (FailureDescription failure)
Тестовый запуск отчетов не удалось завершить из-за сбоя, описанного в поле FailureDescription
.
Параметры | |
---|---|
failure | FailureDescription : FailureDescription описывающая сбой и его контекст. |
testRunFailed
public void testRunFailed (String reason)
Тестовый запуск отчетов не удалось завершить из-за фатальной ошибки.
Параметры | |
---|---|
reason | 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 arg0)
Тестовый запуск отчетов остановлен до завершения по запросу пользователя.
TODO: в настоящее время не используется, рассмотрите возможность удаления
Параметры | |
---|---|
arg0 | long : устройство сообщило прошедшее время в миллисекундах. |
тестПропущен
public void testSkipped (TestDescription testId, SkipReason reason)
Вызывается, когда тест пропускается и не выполняется по причине, которая обычно не ожидается. Эти тесты будут предприняты повторно, чтобы попытаться обеспечить правильное выполнение.
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |
reason | SkipReason : SkipReason |
тестНачало
public void testStarted (TestDescription testId, long startTime)
Альтернатива testStarted(com.android.tradefed.result.TestDescription)
, где мы также указываем, когда тест был запущен, в сочетании с ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
для точного измерения. .
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |
startTime | long : время начала теста, измеренное с помощью System.currentTimeMillis() |
тестНачало
public void testStarted (TestDescription testId)
Сообщает о начале отдельного тестового примера. В более старом интерфейсе следует по возможности использовать testStarted(com.android.tradefed.result.TestDescription)
.
Параметры | |
---|---|
testId | TestDescription : идентифицирует тест. |