Результат выполнения теста
public class TestRunResult
extends Object implements ITestRunListener
| java.lang.Object | |
| ↳ | com.android.ddmlib.testrunner.TestRunResult |
Сохраняет результаты одного тестового запуска.
Ведет точный учет проведенных тестов и отслеживает незавершенные тесты.
Не потокобезопасно! Колбэки теста* должны вызываться по порядку.
Краткое содержание
Государственные строители | |
|---|---|
TestRunResult () Создайте пустой объект | |
Общедоступные методы | |
|---|---|
Set< TestIdentifier > | getCompletedTests ()Получает набор завершенных тестов. |
long | getElapsedTime ()Возвращает текущее время выполнения. |
String | getName () |
int | getNumAllFailedTests ()Возвращает общее количество тестов, находящихся в состоянии сбоя (сбой, ошибка предположения). |
int | getNumCompleteTests ()Получает количество полностью завершенных тестов в этом запуске, то есть со статусом, отличным от "незавершенный". |
int | getNumTests ()Получает количество тестов в этом запуске. |
int | getNumTestsInState ( TestResult.TestStatus status)Получает количество тестов в заданном состоянии для данного запуска. |
String | getRunFailureMessage () Возвращает сообщение об ошибке выполнения, |
Map<String, String> | getRunMetrics () |
Map< TestIdentifier , TestResult > | getTestResults ()Возвращает карту результатов теста. |
String | getTextSummary ()Возвращает удобную для пользователя строку с описанием результатов. |
boolean | hasFailedTests () |
boolean | isRunComplete () |
boolean | isRunFailure () |
void | setAggregateMetrics (boolean metricAggregation) |
void | setRunComplete (boolean runComplete) |
void | testAssumptionFailure ( TestIdentifier test, String trace)Вызывается, когда атомарный тест указывает на то, что он предполагает ложное условие. |
void | testEnded ( TestIdentifier test, Map<String, String> testMetrics)Сообщает о завершении выполнения отдельного тестового случая. |
void | testFailed ( TestIdentifier test, String trace)Сообщает о сбое отдельного тестового случая. |
void | testIgnored ( TestIdentifier test)Вызывается, когда тест выполняться не будет, как правило, потому что тестовый метод аннотирован с помощью org.junit.Ignore. |
void | testRunEnded (long elapsedTime, Map<String, String> runMetrics)Сообщает об окончании тестового запуска. |
void | testRunFailed (String errorMessage)Сообщается, что тестовый запуск не завершился из-за критической ошибки. |
void | testRunStarted (String runName, int testCount)Сообщает о начале тестового запуска. |
void | testRunStopped (long elapsedTime)Тестирование отчетов было прервано до завершения по запросу пользователя. |
void | testStarted ( TestIdentifier test)Сообщает о начале выполнения отдельного тестового случая. |
Государственные строители
Общедоступные методы
getCompletedTests
public Set<TestIdentifier> getCompletedTests ()
Получает набор завершенных тестов.
| Возвраты | |
|---|---|
Set< TestIdentifier > | |
getElapsedTime
public long getElapsedTime ()
Возвращает текущее время выполнения.
| Возвраты | |
|---|---|
long | |
getName
public String getName ()
| Возвраты | |
|---|---|
String | название тестового запуска |
getNumAllFailedTests
public int getNumAllFailedTests ()
Возвращает общее количество тестов, находящихся в состоянии сбоя (сбой, ошибка предположения).
| Возвраты | |
|---|---|
int | |
getNumCompleteTests
public int getNumCompleteTests ()
Получает количество полностью завершенных тестов в этом запуске, то есть со статусом, отличным от "незавершенный".
| Возвраты | |
|---|---|
int | |
getNumTests
public int getNumTests ()
Получает количество тестов в этом запуске.
| Возвраты | |
|---|---|
int | |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus status)
Получает количество тестов в заданном состоянии для данного запуска.
| Параметры | |
|---|---|
status | TestResult.TestStatus |
| Возвраты | |
|---|---|
int | |
getRunFailureMessage
public String getRunFailureMessage ()
Возвращает сообщение об ошибке выполнения, null , если выполнение не завершилось с ошибкой.
| Возвраты | |
|---|---|
String | |
getRunMetrics
public Map<String, String> getRunMetrics ()
| Возвраты | |
|---|---|
Map<String, String> | Map метрик выполнения теста. |
получитьРезультатыТестирования
public Map<TestIdentifier, TestResult> getTestResults ()
Возвращает карту результатов теста.
| Возвраты | |
|---|---|
Map< TestIdentifier , TestResult > | |
getTextSummary
public String getTextSummary ()
Возвращает удобную для пользователя строку с описанием результатов.
| Возвраты | |
|---|---|
String | |
hasFailedTests
public boolean hasFailedTests ()
| Возвраты | |
|---|---|
boolean | true , если в ходе тестового запуска были обнаружены неудачные или ошибочные тесты. |
isRunComplete
public boolean isRunComplete ()
| Возвраты | |
|---|---|
boolean | true если выполнение теста завершено. |
isRunFailure
public boolean isRunFailure ()
| Возвраты | |
|---|---|
boolean | true если запуск теста завершился неудачей. |
setAggregateMetrics
public void setAggregateMetrics (boolean metricAggregation)
| Параметры | |
|---|---|
metricAggregation | boolean |
setRunComplete
public void setRunComplete (boolean runComplete)
| Параметры | |
|---|---|
runComplete | boolean |
testAssumptionFailure
public void testAssumptionFailure (TestIdentifier test, String trace)
Вызывается, когда атомарный тест указывает на то, что он предполагает ложное условие.
| Параметры | |
|---|---|
test | TestIdentifier : идентифицирует тест |
trace | String : трассировка стека ошибки |
тест завершен
public void testEnded (TestIdentifier test, Map<String, String> testMetrics)
Сообщает о завершении выполнения отдельного тестового случая.
Если testFailed(TestIdentifier, String) не был вызван, значит, тест пройден успешно. Также возвращает любые метрики ключ/значение, которые могли быть получены во время выполнения тестового случая.
| Параметры | |
|---|---|
test | TestIdentifier : идентифицирует тест |
testMetrics | Map : Map метрик, генерируемых во время выполнения тестового случая методом android.app.Instrumentation#sendStatus . Порядок добавления сохраняется, если только вы не генерируете один и тот же ключ несколько раз. Обратите внимание, что стандартные ключи, определенные в IInstrumentationResultParser.StatusKeys , исключаются из этой карты. Ddmlib может добавлять дополнительные метрики теста, определенные в IInstrumentationResultParser.StatusKeys . |
тест не пройден
public void testFailed (TestIdentifier test, String trace)
Сообщает о сбое отдельного тестового случая.
Эта функция будет вызвана в промежутке между testStarted и testEnded.
| Параметры | |
|---|---|
test | TestIdentifier : идентифицирует тест |
trace | String : трассировка стека ошибки |
тест проигнорирован
public void testIgnored (TestIdentifier test)
Вызывается, когда тест выполняться не будет, как правило, потому что тестовый метод аннотирован с помощью org.junit.Ignore.
| Параметры | |
|---|---|
test | TestIdentifier : идентифицирует тест |
testRunEnded
public void testRunEnded (long elapsedTime,
Map<String, String> runMetrics)Сообщает об окончании тестового запуска.
| Параметры | |
|---|---|
elapsedTime | long : устройство сообщило о прошедшем времени в миллисекундах |
runMetrics | Map : Map метрик, генерируемых во время выполнения тестового случая методом android.app.Instrumentation#addResults . Порядок добавления сохраняется, если только вы не генерируете один и тот же ключ несколько раз. Обратите внимание, что стандартные ключи, определенные в IInstrumentationResultParser.StatusKeys , исключаются из этой карты. Ddmlib может добавлять дополнительные метрики теста, определенные в IInstrumentationResultParser.StatusKeys . |
testRunFailed
public void testRunFailed (String errorMessage)
Сообщается, что тестовый запуск не завершился из-за критической ошибки.
| Параметры | |
|---|---|
errorMessage | String : String описывающая причину сбоя выполнения. |
testRunStarted
public void testRunStarted (String runName,
int testCount)Сообщает о начале тестового запуска.
| Параметры | |
|---|---|
runName | String : название тестового запуска |
testCount | int : общее количество тестов в тестовом запуске |
testRunStopped
public void testRunStopped (long elapsedTime)
Тестирование отчетов было прервано до завершения по запросу пользователя.
| Параметры | |
|---|---|
elapsedTime | long : устройство сообщило о прошедшем времени в миллисекундах |
тест начат
public void testStarted (TestIdentifier test)
Сообщает о начале выполнения отдельного тестового случая.
| Параметры | |
|---|---|
test | TestIdentifier : идентифицирует тест |