МодульСлушатель

public class ModuleListener
extends CollectingTestListener

java.lang.Объект
↳	com.android.tradefed.result.СборТестовогоСлушателя
	↳	com.android.tradefed.testtype.suite.ModuleListener

---

Прослушиватель, прикрепленный к каждому IRemoteTest каждого модуля, для сбора списка результатов.

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

Публичные конструкторы
ModuleListener ( ITestInvocationListener listener, IInvocationContext moduleContext) Конструктор.

Публичные методы
boolean	hasLastAttemptFailed () Возвращает информацию о том, завершился ли последний повторный сеанс прослушивателя неудачей.
void	logAssociation (String dataName, LogFile logFile) В некоторых случаях журнал должен быть тесно связан с тестовыми случаями, но возможность сделать это в прямом обратном вызове testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) невозможна.
void	setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation) Устанавливает, следует ли сообщать о попытке как об изолированной.
void	setCollectTestsOnly (boolean collectTestsOnly) Устанавливает, собираем ли мы только тесты.
void	setMarkTestsSkipped (boolean skip) Отмечать ли все тестовые случаи пропущенными.
void	setTestMappingSources ( testMappingSources) Устанавливает источники тестового сопоставления, которые будут вставлены в метрики.
void	setUseModuleResultsForwarder (boolean useModuleResultsForwarder)
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, testMetrics) Сообщает об окончании выполнения отдельного тестового случая.
void	testFailed ( TestDescription test, FailureDescription failure) Сообщает о неудачном выполнении отдельного тестового случая.
void	testFailed ( TestDescription test, String trace) Сообщает о неудачном выполнении отдельного тестового случая.
void	testIgnored ( TestDescription test) Вызывается, когда тест не будет запущен, как правило, потому что метод теста аннотирован org.junit.Ignore.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testRunEnded (long elapsedTime, runMetrics) Сообщает об окончании тестового прогона.
void	testRunFailed ( FailureDescription failure) Сообщается, что тестовый запуск не был завершен из-за сбоя, описанного FailureDescription .
void	testRunFailed (String errorMessage) Сообщается, что тестовый запуск не был завершен из-за фатальной ошибки.
void	testRunStarted (String name, int numTests, int attemptNumber) Сообщает о начале тестового запуска.
void	testRunStarted (String name, int numTests, 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)) для точного измерения.

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

МодульСлушатель

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Конструктор.

Параметры
listener	ITestInvocationListener
moduleContext	IInvocationContext

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

hasLastAttemptНеудачная

public boolean hasLastAttemptFailed ()

Возвращает информацию о том, завершился ли последний повторный сеанс прослушивателя неудачей.

Возвраты
boolean

logAssociation

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

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Устанавливает, следует ли сообщать о попытке как об изолированной.

Параметры
isolation	CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Устанавливает, собираем ли мы только тесты.

Параметры
collectTestsOnly	boolean

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Отмечать ли все тестовые случаи пропущенными.

Параметры
skip	boolean

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

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

Параметры
testMappingSources

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Параметры
useModuleResultsForwarder	boolean

тестПредположениеНеудача

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Параметры
test	TestDescription : идентифицирует тест
trace	String : трассировка стека отказа

тестПредположениеНеудача

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

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

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

Параметры
test	TestDescription : идентифицирует тест
testMetrics	: ERROR(/Map) выданных метрик

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

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

Параметры
test	TestDescription : идентифицирует тест
failure	FailureDescription : FailureDescription , описывающий сбой и его контекст.

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

public void testFailed (TestDescription test, 
                String trace)

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

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

Параметры
test	TestDescription : идентифицирует тест
trace	String : трассировка стека отказа

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

public void testIgnored (TestDescription test)

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

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

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Параметры
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogСохранено

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Параметры
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

Параметры
elapsedTime	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 name, 
                int numTests, 
                int attemptNumber)

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

Параметры
name	String : имя тестового запуска
numTests	int : общее количество тестов в тестовом прогоне
attemptNumber	int : порядковый номер, идентифицирующий различные попытки одного и того же runName, которые выполняются несколько раз. attemptNumber индексируется 0 и должен увеличиваться каждый раз, когда происходит новый запуск. Например, тест гранулярно повторяется 3 раза, он должен иметь 4 общих запуска под тем же runName, а attemptNumber находится в диапазоне от 0 до 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

Параметры
name	String : имя тестового запуска
numTests	int : общее количество тестов в тестовом прогоне
attemptNumber	int : порядковый номер, идентифицирующий различные попытки одного и того же runName, которые выполняются несколько раз. attemptNumber индексируется 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()