ResultDBReporter

public class ResultDBReporter
extends Object implements IConfigurationReceiver , ILogSaverListener , ISupportGranularResults , ITestSummaryListener

java.lang.Объект
↳ com.android.tradefed.result.resultdb.ResultDBReporter

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

Константы

int MAX_PRIMARY_ERROR_MESSAGE_BYTES

int MAX_SUMMARY_HTML_BYTES

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

ResultDBReporter ()

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

TestSummary getSummary ()

Позволяет InvocationListener возвращать сводку.

void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

Сообщает о неполном вызове из-за какой-то ошибки.

void invocationFailed (Throwable cause)

Сообщает о неполном вызове из-за какой-то ошибки.

void invocationSkipped ( SkipReason reason)

Сообщает о пропущенном вызове

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 setConfiguration ( IConfiguration configuration)

Внедряет используемую IConfiguration .

void setLogSaver ( ILogSaver logSaver)

Настройте ILogSaver , чтобы разрешить разработчику сохранять файлы.

boolean supportGranularResults ()

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

void testAssumptionFailure ( TestDescription test, String trace)

Вызывается, когда атомарный тест сигнализирует, что он предполагает ложное условие.

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Вызывается, когда атомарный тест сигнализирует, что он предполагает ложное условие.

void testEnded ( TestDescription test, long endTime, testMetrics)

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

void 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 elapsedTimeMillis, 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 testSkipped ( TestDescription test, SkipReason reason)

Вызывается, когда тест пропущен и не выполнен по причине, которая обычно не ожидается.

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)

Сообщает о начале отдельного тестового случая.

Константы

MAX_PRIMARY_ERROR_MESSAGE_BYTES 

public static final int MAX_PRIMARY_ERROR_MESSAGE_BYTES

Постоянное значение: 1024 (0x00000400)

MAX_SUMMARY_HTML_BYTES 

public static final int MAX_SUMMARY_HTML_BYTES

Постоянное значение: 4096 (0x00001000)

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

ResultDBReporter 

public ResultDBReporter ()

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

получитьРезюме 

public TestSummary getSummary ()

Позволяет InvocationListener возвращать сводку.

Возвраты
TestSummary TestSummary , подытоживающий прогон, или null

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

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 invocationSkipped (SkipReason reason)

Сообщает о пропущенном вызове

Параметры
reason SkipReason

вызовНачался 

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 , который был зарегистрирован ранее и должен быть связан с тестовым случаем.

setConfiguration 

public void setConfiguration (IConfiguration configuration)

Внедряет используемую IConfiguration .

Параметры
configuration IConfiguration

setLogSaver 

public void setLogSaver (ILogSaver logSaver)

Настройте ILogSaver , чтобы разрешить разработчику сохранять файлы.

Параметры
logSaver ILogSaver : ILogSaver

поддержкаGranularResults 

public boolean supportGranularResults ()

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

Возвраты
boolean

тестПредположениеНеудача 

public void testAssumptionFailure (TestDescription test, 
                String trace)

Вызывается, когда атомарный тест сигнализирует, что он предполагает ложное условие.

Параметры
test TestDescription : идентифицирует тест

trace String : трассировка стека отказа

тестПредположениеНеудача 

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Вызывается, когда атомарный тест сигнализирует, что он предполагает ложное условие.

Параметры
test TestDescription : идентифицирует тест

failure FailureDescription : FailureDescription , описывающий сбой и его контекст.

тестЗавершен 

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) выданных метрик

тестЗавершен 

public void testEnded (TestDescription test, 
                 testMetrics)

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

Если testFailed(TestDescription, FailureDescription) не был вызван, этот тест пройден. Также возвращает любые метрики ключ/значение, которые могли быть выданы во время выполнения тестового случая.

Параметры
test TestDescription : идентифицирует тест

testMetrics : ERROR(/Map) выданных метрик

тестНе пройден 

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

Будет вызван между testStarted и testEnded.

Параметры
test TestDescription : идентифицирует тест

failure FailureDescription : FailureDescription , описывающий сбой и его контекст.

тестНе пройден 

public void testFailed (TestDescription test, 
                String trace)

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

Будет вызван между testStarted и testEnded.

Параметры
test TestDescription : идентифицирует тест

trace String : трассировка стека отказа

тестИгнорируется 

public void testIgnored (TestDescription test)

Вызывается, когда тест не будет запущен, как правило, потому что метод теста аннотирован org.junit.Ignore.

Параметры
test TestDescription : идентифицирует тест

testLog 

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

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

Необходимо вызвать до ERROR(/ITestInvocationListener#invocationFailed(Throwable)) или ERROR(/ITestInvocationListener#invocationEnded(long))

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

Параметры
dataName String : описательное имя данных типа String . Например, "device_logcat". Обратите внимание, что dataName может быть не уникальным для каждого вызова. То есть разработчики должны иметь возможность обрабатывать несколько вызовов с одинаковым dataName.

dataType LogDataType : LogDataType данных

dataStream InputStreamSource : InputStreamSource данных. Реализаторы должны вызвать createInputStream, чтобы начать чтение данных, и убедиться, что результирующий InputStream закрыт после завершения. Вызывающие должны убедиться, что источник данных остается присутствующим и доступным до завершения метода testLog.

testModuleЗавершен 

public void testModuleEnded ()

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

testModuleStarted 

public void testModuleStarted (IInvocationContext moduleContext)

Сообщает о начале выполнения модуля. Этот обратный вызов связан с testModuleEnded() и является необязательным в последовательности. Он используется только во время выполнения, использующего модули: раннеры на основе набора.

Параметры
moduleContext IInvocationContext : IInvocationContext модуля.

testRunEnded 

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

runMetrics : пары «ключ-значение», сообщаемые в конце тестового прогона

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, которые выполняются несколько раз. attemptNumber индексируется 0 и должен увеличиваться каждый раз, когда происходит новый запуск. Например, тест гранулярно повторяется 3 раза, он должен иметь 4 общих запуска под тем же runName, а attemptNumber находится в диапазоне от 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, которые выполняются несколько раз. attemptNumber индексируется 0 и должен увеличиваться каждый раз, когда происходит новый запуск. Например, тест гранулярно повторяется 3 раза, он должен иметь 4 общих запуска под тем же runName, а attemptNumber находится в диапазоне от 0 до 3.

startTime long : время начала прогона, измеренное с помощью System.currentTimeMillis()

testRunStopped 

public void testRunStopped (long elapsedTime)

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

TODO: в настоящее время не используется, рассмотрите возможность удаления

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

тестПропущен 

public void testSkipped (TestDescription test, 
                SkipReason reason)

Вызывается, когда тест пропущен и не выполнен по причине, которая обычно не ожидается. Эти тесты будут попытаны быть повторены, чтобы попытаться получить надлежащее выполнение.

Параметры
test TestDescription : идентифицирует тест

reason SkipReason : SkipReason

тестНачался 

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

тестНачался 

public void testStarted (TestDescription test)

Сообщает о начале отдельного тестового случая. Старый интерфейс, следует использовать testStarted(com.android.tradefed.result.TestDescription) везде, где это возможно.

Параметры
test TestDescription : идентифицирует тест