Результат выполнения теста
public class TestRunResult
extends Object
| java.lang.Object | |
| ↳ | com.android.tradefed.result.TestRunResult |
Сохраняет результаты одного тестового запуска.
Ведет точный учет проведенных тестов и отслеживает незавершенные тесты.
Не потокобезопасно! Колбэки теста* должны вызываться по порядку.
Краткое содержание
Константы | |
|---|---|
String | ERROR_DIVIDER |
Государственные строители | |
|---|---|
TestRunResult () Создайте пустой объект | |
Общедоступные методы | |
|---|---|
void | addTestResult ( TestDescription test, TestResult testResult) |
Set< TestDescription > | getCompletedTests ()Получает набор завершенных тестов. |
long | getElapsedTime ()Возвращает текущее время выполнения. |
int | getExpectedTestCount ()Получает количество тестовых случаев, которое, по прогнозам, должно содержаться в этом объекте TestRunResult. |
Set< TestDescription > | getFailedTests ()Получает набор неудачно пройденных тестов. |
String | getName () |
int | getNumAllFailedTests ()Возвращает общее количество тестов, находящихся в состоянии сбоя (сбой, ошибка предположения). |
int | getNumCompleteTests ()Получает количество полностью завершенных тестов в этом запуске, то есть со статусом, отличным от "незавершенный". |
int | getNumTests ()Получает количество тестов в этом запуске. |
int | getNumTestsInState ( TestStatus status)Получает количество тестов в заданном состоянии для данного запуска. |
int | getNumTestsInState ( TestResult.TestStatus ddmlibStatus)Для обеспечения совместимости со старыми версиями. |
Set< TestDescription > | getPassedTests ()Получает набор пройденных тестов. |
FailureDescription | getRunFailureDescription () Возвращает дескриптор ошибки выполнения, |
String | getRunFailureMessage () Возвращает сообщение об ошибке выполнения, |
MultiMap <String, LogFile > | getRunLoggedFiles ()Возвращает копию карты, содержащую все файлы журналов, связанные с данным тестовым случаем. |
Map<String, String> | getRunMetrics () |
HashMap<String, MetricMeasurement.Metric> | getRunProtoMetrics () |
long | getStartTime ()Возвращает время начала первого вызова функции testRunStart. |
Map< TestDescription , TestResult > | getTestEntriesInState (Collection< TestStatus > statuses)Получает набор тестов в заданных статусах. |
Map< TestDescription , TestResult > | getTestResults ()Возвращает карту результатов теста. |
Set< TestDescription > | getTestsInState (List< TestStatus > statuses)Получает набор тестов в заданных статусах. |
List< TestResult > | getTestsResultsInState ( TestStatus status) Возвращает все результаты |
String | getTextSummary ()Возвращает удобную для пользователя строку с описанием результатов. |
boolean | hasFailedTests () |
boolean | isRunComplete () |
boolean | isRunFailure () |
static TestRunResult | merge (List< TestRunResult > testRunResults) |
static TestRunResult | merge (List< TestRunResult > testRunResults, MergeStrategy strategy)Объединить несколько результатов выполнения теста (TestRunResults) с одинаковым именем теста (testRunName). |
void | resetRunFailure ()Сбросить статус ошибки выполнения. |
void | setAggregateMetrics (boolean metricAggregation) |
void | setRunComplete (boolean runComplete) |
void | testAssumptionFailure ( TestDescription test, String trace) |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) |
void | testEnded ( TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics) |
void | testEnded ( TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics) |
void | testFailed ( TestDescription test, FailureDescription failure) |
void | testFailed ( TestDescription test, String trace) |
void | testIgnored ( TestDescription test) |
void | testLogSaved (String dataName, LogFile logFile)Информация о файле, который записывается в журнал, сохраняется и связывается с текущим тестовым случаем или запуском теста. |
void | testRunEnded (long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)Новый интерфейс, использующий новые протоколы метрик. |
void | testRunEnded (long elapsedTime, Map<String, String> runMetrics) |
void | testRunFailed ( FailureDescription failureDescription) |
void | testRunFailed (String errorMessage) |
void | testRunStarted (String runName, int testCount, long startTime)Уведомление о начале тестового запуска. |
void | testRunStarted (String runName, int testCount)Уведомление о начале тестового запуска. |
void | testRunStopped (long elapsedTime) |
void | testSkipped ( TestDescription test, SkipReason reason) |
void | testStarted ( TestDescription test, long startTime) |
void | testStarted ( TestDescription test) |
Константы
ERROR_DIVIDER
public static final String ERROR_DIVIDER
Постоянное значение: " ====Следующая ошибка==== "
Государственные строители
Общедоступные методы
addTestResult
public void addTestResult (TestDescription test, TestResult testResult)
| Параметры | |
|---|---|
test | TestDescription |
testResult | TestResult |
getCompletedTests
public Set<TestDescription> getCompletedTests ()
Получает набор завершенных тестов.
| Возвраты | |
|---|---|
Set< TestDescription > | |
getElapsedTime
public long getElapsedTime ()
Возвращает текущее время выполнения.
| Возвраты | |
|---|---|
long | |
getExpectedTestCount
public int getExpectedTestCount ()
Получает количество тестовых случаев, которое, по прогнозам, должно содержать этот TestRunResult. Фактическое число может быть меньше ожидаемого из-за сбоев тестов. Обычно такое несоответствие указывает на неудачный запуск теста.
| Возвраты | |
|---|---|
int | |
getFailedTests
public Set<TestDescription> getFailedTests ()
Получает набор неудачно пройденных тестов.
| Возвраты | |
|---|---|
Set< TestDescription > | |
getName
public String getName ()
| Возвраты | |
|---|---|
String | название тестового запуска |
getNumAllFailedTests
public int getNumAllFailedTests ()
Возвращает общее количество тестов, находящихся в состоянии сбоя (сбой, ошибка предположения).
| Возвраты | |
|---|---|
int | |
getNumCompleteTests
public int getNumCompleteTests ()
Получает количество полностью завершенных тестов в этом запуске, то есть со статусом, отличным от "незавершенный".
| Возвраты | |
|---|---|
int | |
getNumTests
public int getNumTests ()
Получает количество тестов в этом запуске.
| Возвраты | |
|---|---|
int | |
getNumTestsInState
public int getNumTestsInState (TestStatus status)
Получает количество тестов в заданном состоянии для данного запуска.
| Параметры | |
|---|---|
status | TestStatus |
| Возвраты | |
|---|---|
int | |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
Для обеспечения совместимости со старыми статусами используйте getNumTestsInState(TestStatus) вместо этого.
| Параметры | |
|---|---|
ddmlibStatus | TestResult.TestStatus |
| Возвраты | |
|---|---|
int | |
getPassedTests
public Set<TestDescription> getPassedTests ()
Получает набор пройденных тестов.
| Возвраты | |
|---|---|
Set< TestDescription > | |
getRunFailureDescription
public FailureDescription getRunFailureDescription ()
Возвращает дескриптор ошибки выполнения, null если выполнение не завершилось с ошибкой.
| Возвраты | |
|---|---|
FailureDescription | |
getRunFailureMessage
public String getRunFailureMessage ()
Возвращает сообщение об ошибке выполнения, null , если выполнение не завершилось с ошибкой.
| Возвраты | |
|---|---|
String | |
getRunLoggedFiles
public MultiMap<String, LogFile> getRunLoggedFiles ()
Возвращает копию карты, содержащую все файлы журналов, связанные с данным тестовым случаем.
| Возвраты | |
|---|---|
MultiMap <String, LogFile > | |
getRunMetrics
public Map<String, String> getRunMetrics ()
| Возвраты | |
|---|---|
Map<String, String> | Map метрик тестового запуска. |
getRunProtoMetrics
public HashMap<String, MetricMeasurement.Metric> getRunProtoMetrics ()
| Возвраты | |
|---|---|
HashMap<String, MetricMeasurement.Metric> | Map метрик тестового запуска в новом формате прототипа. |
getStartTime
public long getStartTime ()
Возвращает время начала первого вызова функции testRunStart.
| Возвраты | |
|---|---|
long | |
getTestEntriesInState
public Map<TestDescription, TestResult> getTestEntriesInState (Collection<TestStatus> statuses)
Получает набор тестов в заданных статусах.
| Параметры | |
|---|---|
statuses | Collection |
| Возвраты | |
|---|---|
Map< TestDescription , TestResult > | |
получитьРезультатыТестирования
public Map<TestDescription, TestResult> getTestResults ()
Возвращает карту результатов теста.
| Возвраты | |
|---|---|
Map< TestDescription , TestResult > | |
getTestsInState
public Set<TestDescription> getTestsInState (List<TestStatus> statuses)
Получает набор тестов в заданных статусах.
| Параметры | |
|---|---|
statuses | List |
| Возвраты | |
|---|---|
Set< TestDescription > | |
getTestsResultsInState
public List<TestResult> getTestsResultsInState (TestStatus status)
Возвращает все результаты TestResult в определенном состоянии.
| Параметры | |
|---|---|
status | TestStatus |
| Возвраты | |
|---|---|
List< TestResult > | |
getTextSummary
public String getTextSummary ()
Возвращает удобную для пользователя строку с описанием результатов.
| Возвраты | |
|---|---|
String | |
hasFailedTests
public boolean hasFailedTests ()
| Возвраты | |
|---|---|
boolean | true , если в ходе тестового запуска были обнаружены неудачные или ошибочные тесты. |
isRunComplete
public boolean isRunComplete ()
| Возвраты | |
|---|---|
boolean | true если выполнение теста завершено. |
isRunFailure
public boolean isRunFailure ()
| Возвраты | |
|---|---|
boolean | true если запуск теста завершился неудачей. |
слияние
public static TestRunResult merge (List<TestRunResult> testRunResults)
| Параметры | |
|---|---|
testRunResults | List |
| Возвраты | |
|---|---|
TestRunResult | |
См. также:
слияние
public static TestRunResult merge (List<TestRunResult> testRunResults, MergeStrategy strategy)
Объединяем несколько результатов TestRunResult с одинаковым именем теста. Если тестовый случай встречается в нескольких результатах TestRunResult, но имеет разные результаты (например, "boottest-device" запускается три раза с результатом FAIL-FAIL-PASS), мы объединяем все трассировки стека из неудачных запусков и доверяем окончательному результату запуска для получения информации о статусе, метриках, файлах журналов, времени начала/окончания.
| Параметры | |
|---|---|
testRunResults | List : Список результатов выполнения тестов (TestRunResult) для объединения. |
strategy | MergeStrategy : стратегия слияния, применяемая для объединения результатов. |
| Возвраты | |
|---|---|
TestRunResult | Итоговый результат TestRunResult, содержащий объединенные данные из результатов testRunResults. |
resetRunFailure
public void resetRunFailure ()
Сбросить статус ошибки выполнения.
Иногда при повторной попытке требуется сбросить статус сбоя выполнения. Это следует делать с осторожностью, чтобы избежать устранения реальной ошибки.
setAggregateMetrics
public void setAggregateMetrics (boolean metricAggregation)
| Параметры | |
|---|---|
metricAggregation | boolean |
setRunComplete
public void setRunComplete (boolean runComplete)
| Параметры | |
|---|---|
runComplete | boolean |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
| Параметры | |
|---|---|
test | TestDescription |
trace | String |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
| Параметры | |
|---|---|
test | TestDescription |
failure | FailureDescription |
тест завершен
public void testEnded (TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
| Параметры | |
|---|---|
test | TestDescription |
endTime | long |
testMetrics | HashMap |
тест завершен
public void testEnded (TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
| Параметры | |
|---|---|
test | TestDescription |
testMetrics | HashMap |
тест не пройден
public void testFailed (TestDescription test, FailureDescription failure)
| Параметры | |
|---|---|
test | TestDescription |
failure | FailureDescription |
тест не пройден
public void testFailed (TestDescription test, String trace)
| Параметры | |
|---|---|
test | TestDescription |
trace | String |
testLogSaved
public void testLogSaved (String dataName,
LogFile logFile)Информация о файле, который записывается в журнал, сохраняется и связывается с текущим тестовым случаем или запуском теста.
| Параметры | |
|---|---|
dataName | String : имя, указывающее на данные. |
logFile | LogFile : Объект LogFile , указывающий место сохранения объекта и содержащий информацию о нем. |
testRunEnded
public void testRunEnded (long elapsedTime,
HashMap<String, MetricMeasurement.Metric> runMetrics)Новый интерфейс, использующий новые протоколы метрик.
| Параметры | |
|---|---|
elapsedTime | long |
runMetrics | HashMap |
testRunEnded
public void testRunEnded (long elapsedTime,
Map<String, String> runMetrics)| Параметры | |
|---|---|
elapsedTime | long |
runMetrics | Map |
testRunFailed
public void testRunFailed (FailureDescription failureDescription)
| Параметры | |
|---|---|
failureDescription | FailureDescription |
testRunFailed
public void testRunFailed (String errorMessage)
| Параметры | |
|---|---|
errorMessage | String |
testRunStarted
public void testRunStarted (String runName,
int testCount,
long startTime)Уведомление о начале тестового запуска.
| Параметры | |
|---|---|
runName | String : имя, связанное с тестовым запуском для целей отслеживания. |
testCount | int : количество ожидаемых тестовых случаев, связанных с выполнением теста. |
startTime | long |
testRunStarted
public void testRunStarted (String runName,
int testCount)Уведомление о начале тестового запуска.
| Параметры | |
|---|---|
runName | String : имя, связанное с тестовым запуском для целей отслеживания. |
testCount | int : количество ожидаемых тестовых случаев, связанных с выполнением теста. |
testRunStopped
public void testRunStopped (long elapsedTime)
| Параметры | |
|---|---|
elapsedTime | long |
тест пропущен
public void testSkipped (TestDescription test, SkipReason reason)
| Параметры | |
|---|---|
test | TestDescription |
reason | SkipReason |
тест начат
public void testStarted (TestDescription test, long startTime)
| Параметры | |
|---|---|
test | TestDescription |
startTime | long |