Проторезультатрепортер
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) В некоторых случаях журнал должен быть тесно связан с тестовыми примерами, но возможность сделать это напрямую |
void | processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) Используйте запись вызова для отправки по одному всех окончательных журналов вызова. |
void | processFinalProto (TestRecordProto.TestRecord finalRecord) Обработка финального прототипа со всеми результатами. |
void | processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) Обработка прототипа тестовой записи частичного вызова после того, как произошел |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) Обработка прототипа записи окончательного тестового примера после возникновения |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) Обработка прототипа записи частичного тестового примера после того, как произошел |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) Обработка окончательного прототипа записи модуля после выполнения |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) Обработка прототипа частичной записи модуля после того, как произошел |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Обработка протокола завершенной записи запуска после возникновения |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) Обработка прототипа записи частичного запуска теста после возникновения |
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) Альтернатива |
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) Тестовый запуск отчетов не удалось завершить из-за сбоя, описанного в поле |
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) Альтернатива |
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 |