ResultReporter

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

java.lang.Object
↳ com.google.android.tradefed.result.teststorage.ResultReporter

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

Вложенные классы

class ResultReporter.ListBuilder <T>

Константы

String DEFAULT_BUILDPROVIDER

String EXPERIMENTAL

String SYSTEM_CHECKER

String TRADEFED

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

ResultReporter ()

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

void enableFilterProperty (boolean enableFilterProperty)
IConfiguration getConfiguration ()
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 log)

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

void putEarlySummary ( summaries)

Передает ERROR(/List) ненулевых TestSummary , которые могли быть возвращены из любого экземпляра ITestInvocationListener , созданного как часть конфигурации.

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, metrics)

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

void testFailed ( TestDescription test, FailureDescription failure)

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

void testFailed ( TestDescription test, String trace)

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

void testIgnored ( TestDescription test)

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

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

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

Защищенные методы

ITestStorageClient createTestStorageClient ( IInvocationContext context)
String getVersion ()

Константы

DEFAULT_BUILDPROVIDER 

public static final String DEFAULT_BUILDPROVIDER

Постоянное значение: "androidbuild"

ЭКСПЕРИМЕНТАЛЬНЫЙ 

public static final String EXPERIMENTAL

Постоянное значение: «экспериментальное»

SYSTEM_CHECKER 

public static final String SYSTEM_CHECKER

Постоянное значение: «system_checker»

ТРЕЙДФЕД 

public static final String TRADEFED

Постоянное значение: "tradefed"

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

ResultReporter 

public ResultReporter ()

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

enableFilterProperty 

public void enableFilterProperty (boolean enableFilterProperty)

Параметры
enableFilterProperty boolean

получитьКонфигурацию 

public IConfiguration getConfiguration ()

Возврат
IConfiguration

получитьSummary 

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

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

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

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

putEarlySummary 

public void putEarlySummary ( summaries)

Передает ERROR(/List) ненулевых TestSummary , которые могли быть возвращены любым экземпляром ITestInvocationListener , созданным в рамках конфигурации. Первые сводки генерируются после ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) и могут быть завершены в конце вызова с помощью ERROR(/#putSummary(List)) .

Он вызывается перед ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) и содержит все сводки от прослушивателей, настроенных до него.

Параметры
summaries : ERROR(/List) ненулевых TestSummary из ITestInvocationListener , которые являются частью текущей конфигурации.

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

testAssumptionFailure 

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

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

testAssumptionFailure 

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, 
                 metrics)

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

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

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

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

testFailed 

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

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

testFailed 

public void testFailed (TestDescription test, 
                String trace)

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

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

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

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

тест проигнорирован 

public void testIgnored (TestDescription test)

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

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

testModuleEnded 

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

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

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

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

Защищенные методы

createTestStorageClient 

protected ITestStorageClient createTestStorageClient (IInvocationContext context)

Параметры
context IInvocationContext

Возврат
ITestStorageClient

получитьВерсию 

protected String getVersion ()

Возврат
String