Проторезультатрепортер

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener , ISupportGranularResults , ITestInvocationListener

java.lang.Объект
com.android.tradefed.result.proto.ProtoResultReporter


Отчет о результатах создает прототип TestRecord со всеми результатами внутри. Должен быть расширен для обработки того, что делать с окончательным прототипом вprocessFinalProto processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) .

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

Общественные конструкторы

ProtoResultReporter ()

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

final void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

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

final void invocationStarted ( IInvocationContext context)

Сообщает о начале тестового вызова.

final void logAssociation (String dataName, LogFile logFile)

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

void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Используйте запись вызова для отправки по одному всех окончательных журналов вызова.

void processFinalProto (TestRecordProto.TestRecord finalRecord)

Обработка финального прототипа со всеми результатами.

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

Обработка прототипа тестовой записи частичного вызова после того, как произошел invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Обработка прототипа записи окончательного тестового примера после возникновения ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Обработка прототипа записи частичного тестового примера после того, как произошел testStarted(com.android.tradefed.result.TestDescription, long) .

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Обработка окончательного прототипа записи модуля после выполнения testModuleEnded() .

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Обработка прототипа частичной записи модуля после того, как произошел testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Обработка протокола завершенной записи запуска после возникновения ERROR(/#testRunEnded(long,HashMap)) .

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Обработка прототипа записи частичного запуска теста после возникновения testRunStarted(String, int) .

void setGranularResults (boolean granularResults)
void setInlineRecordOfChildren (boolean inline)
boolean supportGranularResults ()

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

final void testAssumptionFailure ( TestDescription test, String trace)

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

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

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

final void testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics)

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

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

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

final void testFailed ( TestDescription test, FailureDescription failure)

Сообщает о сбое отдельного тестового примера.

final void testFailed ( TestDescription test, String trace)

Сообщает о сбое отдельного тестового примера.

final void testIgnored ( TestDescription test)

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

final void testModuleEnded ()

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

final void testModuleStarted ( IInvocationContext moduleContext)

Сообщает о начале работы модуля.

final void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

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

final void testRunFailed ( FailureDescription failure)

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

final void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount, int attemptNumber)

Сообщает о начале тестового запуска.

final void testRunStarted (String runName, int testCount)

Сообщает о начале тестового запуска.

void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

Сообщает о начале тестового запуска.

final void testSkipped ( TestDescription test, SkipReason reason)

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

final void testStarted ( TestDescription test, long startTime)

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

final void testStarted ( TestDescription test)

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

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

void afterModuleEnd ()
void beforeModuleStart ()
TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Создает дочернюю ссылку для модуля.

Общественные конструкторы

Проторезультатрепортер

public ProtoResultReporter ()

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

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

public final 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 final void invocationStarted (IInvocationContext context)

Сообщает о начале тестового вызова.

Будет автоматически вызываться платформой TradeFederation. Создателям отчетов необходимо переопределить этот метод для поддержки отчетов с нескольких устройств.

Параметры
context IInvocationContext : информация о вызове.

logAssociation

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

процессфиналинвоквоклогс

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Используйте запись вызова для отправки по одному всех окончательных журналов вызова.

Параметры
invocationLogs TestRecordProto.TestRecord : завершенный прототип, представляющий вызов.

процессFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Обработка финального прототипа со всеми результатами.

Параметры
finalRecord TestRecordProto.TestRecord : завершенный прототип со всеми результатами вызова.

процессСтартИнвокейшн

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Обработка прототипа тестовой записи частичного вызова после того, как произошел invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

Параметры
invocationStartRecord TestRecordProto.TestRecord : частичный прототип, заполняемый после вызоваStart.

invocationContext IInvocationContext : вызов IInvocationContext .

процесстесткесеендед

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Обработка прототипа записи окончательного тестового примера после возникновения ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))

Параметры
testCaseRecord TestRecordProto.TestRecord : завершенный прототип, представляющий тестовый пример.

процесстесткесестартед

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Обработка прототипа записи частичного тестового примера после того, как произошел testStarted(com.android.tradefed.result.TestDescription, long) .

Параметры
testCaseStartedRecord TestRecordProto.TestRecord : частичный прототип, представляющий тестовый пример.

процесстестмодулеенд

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Обработка окончательного прототипа записи модуля после выполнения testModuleEnded() .

Параметры
moduleRecord TestRecordProto.TestRecord : завершенный прототип, представляющий модуль.

процесстестмодулестартед

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Обработка прототипа частичной записи модуля после того, как произошел testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

Параметры
moduleStartRecord TestRecordProto.TestRecord : частичный прототип, представляющий модуль.

процесстеструнендед

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Обработка протокола завершенной записи запуска после возникновения ERROR(/#testRunEnded(long,HashMap)) .

Параметры
runRecord TestRecordProto.TestRecord : завершенный прототип, представляющий выполнение.

moduleInProgress boolean : выполняется ли модуль.

процессТестРунстартед

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Обработка прототипа записи частичного запуска теста после возникновения testRunStarted(String, int) .

Параметры
runStartedRecord TestRecordProto.TestRecord : частичный прототип, представляющий выполнение.

setGranularResults

public void setGranularResults (boolean granularResults)

Параметры
granularResults boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Параметры
inline boolean

поддержкаGranularResults

public boolean supportGranularResults ()

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

Возврат
boolean

тестПредположениеОтказ

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

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

тестПредположениеОтказ

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

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

testEnded

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

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

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

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Сообщает о сбое отдельного тестового примера.

Будет вызываться между testStarted и testEnded.

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

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

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

public final void testFailed (TestDescription test, 
                String trace)

Сообщает о сбое отдельного тестового примера.

Будет вызываться между testStarted и testEnded.

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

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

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

public final void testIgnored (TestDescription test)

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

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

testModuleEnded

public final void testModuleEnded ()

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

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

Параметры
errorMessage 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 final 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()

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

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

reason SkipReason : SkipReason

тестНачало

public final 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 final void testStarted (TestDescription test)

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

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

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

послемодулеконд

protected void afterModuleEnd ()

домодульстарт

protected void beforeModuleStart ()

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Создает дочернюю ссылку для модуля.

Параметры
record TestRecordProto.TestRecord

Возврат
TestRecordProto.ChildReference