ProtoResultReporter

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

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

Известные прямые подклассы FileProtoResultReporter , StreamProtoResultReporter FileProtoResultReporter Proto Reporter, который выгружает TestRecord в файл. StreamProtoResultReporter Реализация 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