Результат выполнения теста

public class TestRunResult
extends Object

java.lang.Object
com.android.tradefed.result.TestRunResult


Сохраняет результаты одного тестового запуска.

Ведет точный учет проведенных тестов и отслеживает незавершенные тесты.

Не потокобезопасно! Колбэки теста* должны вызываться по порядку.

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

Константы

String ERROR_DIVIDER

Государственные строители

TestRunResult ()

Создайте пустой объект 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 ()

Возвращает дескриптор ошибки выполнения, null если выполнение не завершилось с ошибкой.

String getRunFailureMessage ()

Возвращает сообщение об ошибке выполнения, null , если выполнение не завершилось с ошибкой.

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)

Возвращает все результаты TestResult в определенном состоянии.

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

Постоянное значение: " ====Следующая ошибка==== "

Государственные строители

Результат выполнения теста

public TestRunResult ()

Создайте пустой объект TestRunResult .

Общедоступные методы

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<TestDescriptionTestResult> getTestEntriesInState (Collection<TestStatus> statuses)

Получает набор тестов в заданных статусах.

Параметры
statuses Collection

Возвраты
Map< TestDescription , TestResult >

получитьРезультатыТестирования

public Map<TestDescriptionTestResult> 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

тест проигнорирован

public void testIgnored (TestDescription test)

Параметры
test TestDescription

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

тест начат

public void testStarted (TestDescription test)

Параметры
test TestDescription