ProtoResultReporter

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

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


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

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

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

ProtoResultReporter ()

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

final void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

Сообщает о незавершенном вызове из-за некоторого состояния ошибки.

void invocationFailed (Throwable cause)

Сообщает о незавершенном вызове из-за некоторого состояния ошибки.

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

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

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

TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

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

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

ProtoResultReporter

public ProtoResultReporter ()

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

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

public final void invocationEnded (long elapsedTime)

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

Будет автоматически вызываться фреймворком TradeFederation.

Параметры
elapsedTime long : прошедшее время вызова в мс

invocationFailed

public void invocationFailed (FailureDescription failure)

Сообщает о незавершенном вызове из-за некоторого состояния ошибки.

Будет автоматически вызываться фреймворком TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

Сообщает о незавершенном вызове из-за некоторого состояния ошибки.

Будет автоматически вызываться фреймворком TradeFederation.

Параметры
cause Throwable : Throwable причина сбоя

вызов запущен

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 : частичный прототип, заполняемый после вызова invocationStart.

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 : частичный прототип, представляющий модуль.

процессTestRunEnded

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

supportGranularResults

public boolean supportGranularResults ()

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

Возвращает
boolean

testAssummentFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

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

testAssummentFailure

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

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

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

testFailed

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

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

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

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

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

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

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

testStarted

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

testStarted

public final void testStarted (TestDescription test)

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

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

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

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

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

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

Возвращает
TestRecordProto.ChildReference