SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

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)

В некоторых случаях журнал должен быть тесно связан с тестовыми примерами, но возможность сделать это напрямую testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.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)

Альтернатива ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) где мы можем напрямую указать время окончания.

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)

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

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)

Альтернатива testStarted(com.android.tradefed.result.TestDescription) , где мы также указываем, когда тест был запущен, в сочетании с ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) для точного измерения. .

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)

Сообщает об окончании тестового запуска. ИСПРАВЛЕНИЕ: мы не можем иметь два интерфейса Map<> разного типа, поэтому здесь нам придется использовать HashMap.

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

runMetrics : пары ключ-значение, зарегистрированные в конце тестового запуска с помощью Metric .

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 : идентифицирует тест.