Эта страница переведена с помощью Cloud Translation API.

Слушатель модуля

public class ModuleListener
extends CollectingTestListener

java.lang.Объект
↳	com.android.tradefed.result.CollectingTestListener
	↳	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)` `setTestMappingSources ( testMappingSources)` Задает источники тестового сопоставления, которые будут вставлены в метрики.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` Вызывается, когда атомарный тест отмечает, что он принимает условие, которое является ложным.
`void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Вызывается, когда атомарный тест отмечает, что он принимает условие, которое является ложным.
`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)` Сообщает об окончании выполнения отдельного тестового примера.
`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)` `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`	`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`

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

hasLastAttemptFailed

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`

сетколлектестсонли

public void setCollectTestsOnly (boolean collectTestsOnly)

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

Параметры
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

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

Параметры
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

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

Параметры
`testMappingSources`

testAssummentFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssummentFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

testEnded

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

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

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

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

public void testIgnored (TestDescription test)

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

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

журнал испытаний

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

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

testLogSaved

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)

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

Параметры
`elapsedTime`	`long` : устройство сообщило о прошедшем времени в миллисекундах
`runMetrics`	: пары ключ-значение, о которых сообщается в конце тестового прогона с `Metric` .

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

testRunStarted

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

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

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

testStarted

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