TestRunResult

public class TestRunResult
extends Object

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


Contém resultados de uma única execução de teste.

Mantém uma contagem precisa de testes e rastreia testes incompletos.

Não é thread safe! Os callbacks test* precisam ser chamados em ordem

Resumo

Constantes

String ERROR_DIVIDER

Construtores públicos

TestRunResult()

Crie um TestRunResult vazio.

Métodos públicos

void addTestResult(TestDescription test, TestResult testResult)
getCompletedTests()

Recebe o conjunto de testes concluídos.

long getElapsedTime()

Retorna o tempo decorrido da execução atual.

int getExpectedTestCount()

Recebe o número de casos de teste que este TestRunResult espera ter.

getFailedTests()

Recebe o conjunto de testes com falha.

String getName()
int getNumAllFailedTests()

Retorna o número total de testes em um estado de falha (falha, falha de proposição).

int getNumCompleteTests()

Recebe o número de testes concluídos nesta execução, ou seja, com status != incompleto.

int getNumTests()

Recebe o número de testes nesta execução.

int getNumTestsInState(TestStatus status)

Recebe o número de testes no estado especificado para esta execução.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

PARA COMPATIBILIDADE com status mais antigos.

getPassedTests()

Recebe o conjunto de testes aprovados.

FailureDescription getRunFailureDescription()

Retorna o descritor de falha da execução, null se a execução não falhar.

String getRunFailureMessage()

Retorna a mensagem de erro de falha da execução, null se a execução não falhou.

MultiMap<String, LogFile> getRunLoggedFiles()

Retorna uma cópia do mapa que contém todos os arquivos registrados associados a esse caso de teste.

getRunMetrics()
getRunProtoMetrics()
long getStartTime()

Retorna o horário de início da primeira chamada "testRunStart".

getTestEntriesInState( statuses)

Recebe o conjunto de testes nos status especificados.

getTestResults()

Retorna um mapa dos resultados do teste.

getTestsInState( statuses)

Recebe o conjunto de testes nos status especificados.

getTestsResultsInState(TestStatus status)

Retorna todos os TestResult em um estado específico.

String getTextSummary()

Retorna uma string fácil de usar que descreve os resultados.

boolean hasFailedTests()
boolean isRunComplete()
boolean isRunFailure()
static TestRunResult merge( testRunResults)
static TestRunResult merge( testRunResults, MergeStrategy strategy)

Mescla vários TestRunResults do mesmo testRunName.

void resetRunFailure()

Redefine o status de falha da execução.

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, testMetrics)
void testEnded(TestDescription test, testMetrics)
void testFailed(TestDescription test, FailureDescription failure)
void testFailed(TestDescription test, String trace)
void testIgnored(TestDescription test)
void testLogSaved(String dataName, LogFile logFile)

As informações sobre um arquivo que está sendo registrado são armazenadas e associadas ao caso de teste ou à execução de teste em andamento.

void testRunEnded(long elapsedTime, runMetrics)
void testRunFailed(FailureDescription failureDescription)
void testRunFailed(String errorMessage)
void testRunStarted(String runName, int testCount, long startTime)

Notifica que uma execução de teste foi iniciada.

void testRunStarted(String runName, int testCount)

Notifica que uma execução de teste foi iniciada.

void testRunStopped(long elapsedTime)
void testSkipped(TestDescription test, SkipReason reason)
void testStarted(TestDescription test, long startTime)
void testStarted(TestDescription test)

Constantes

ERROR_DIVIDER

public static final String ERROR_DIVIDER

Valor da constante: " ====Próximo erro==== "

Construtores públicos

TestRunResult

public TestRunResult ()

Crie um TestRunResult vazio.

Métodos públicos

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

Parâmetros
test TestDescription

testResult TestResult

getCompletedTests

public  getCompletedTests ()

Recebe o conjunto de testes concluídos.

Retorna

getElapsedTime

public long getElapsedTime ()

Retorna o tempo decorrido da execução atual.

Retorna
long

getExpectedTestCount

public int getExpectedTestCount ()

Recebe o número de casos de teste que este TestRunResult espera ter. O número real pode ser menor que o esperado devido a falhas no teste. Normalmente, essa incompatibilidade indica uma falha na execução do teste.

Retorna
int

getFailedTests

public  getFailedTests ()

Recebe o conjunto de testes com falha.

Retorna

getName

public String getName ()

Retorna
String o nome da execução de teste

getNumAllFailedTests

public int getNumAllFailedTests ()

Retorna o número total de testes em um estado de falha (falha, falha de proposição).

Retorna
int

getNumCompleteTests

public int getNumCompleteTests ()

Recebe o número de testes concluídos nesta execução, ou seja, com status != incompleto.

Retorna
int

getNumTests

public int getNumTests ()

Recebe o número de testes nesta execução.

Retorna
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Recebe o número de testes no estado especificado para esta execução.

Parâmetros
status TestStatus

Retorna
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

PARA COMPATIBILIDADE com status mais antigos. Use getNumTestsInState(com.android.tradefed.result.TestStatus)

Parâmetros
ddmlibStatus TestResult.TestStatus

Retorna
int

getPassedTests

public  getPassedTests ()

Recebe o conjunto de testes aprovados.

Retorna

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Retorna o descritor de falha da execução, null se a execução não falhar.

Retorna
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

Retorna a mensagem de erro de falha da execução, null se a execução não falhou.

Retorna
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Retorna uma cópia do mapa que contém todos os arquivos registrados associados a esse caso de teste.

Retorna
MultiMap<String, LogFile>

getRunMetrics

public  getRunMetrics ()

Retorna
um ERROR(/Map) das métricas de execução do teste.

getRunProtoMetrics

public  getRunProtoMetrics ()

Retorna
um ERROR(/Map) das métricas de execução do teste com o novo formato proto.

getStartTime

public long getStartTime ()

Retorna o horário de início da primeira chamada "testRunStart".

Retorna
long

getTestEntriesInState

public  getTestEntriesInState ( statuses)

Recebe o conjunto de testes nos status especificados.

Parâmetros
statuses

Retorna

getTestResults

public  getTestResults ()

Retorna um mapa dos resultados do teste.

Retorna

getTestsInState

public  getTestsInState ( statuses)

Recebe o conjunto de testes nos status especificados.

Parâmetros
statuses

Retorna

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

Retorna todos os TestResult em um estado específico.

Parâmetros
status TestStatus

Retorna

getTextSummary

public String getTextSummary ()

Retorna uma string fácil de usar que descreve os resultados.

Retorna
String

hasFailedTests

public boolean hasFailedTests ()

Retorna
boolean true se a execução de teste tiver testes com falha ou erro.

isRunComplete

public boolean isRunComplete ()

Retorna
boolean true se a execução do teste for concluída.

isRunFailure

public boolean isRunFailure ()

Retorna
boolean true se a execução do teste falhar.

mesclar

public static TestRunResult merge ( testRunResults)

Parâmetros
testRunResults

Retorna
TestRunResult

mesclar

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

Mescla vários TestRunResults do mesmo testRunName. Se um caso de teste aparecer em vários TestRunResults, mas tiver resultados diferentes (por exemplo, "boottest-device" é executado três vezes com o resultado FAIL-FAIL-PASS), vamos concatenar todos os rastreamentos de pilha das execuções com falha e confiar no resultado da execução final para status, métricas, arquivos de registro, hora de início/término.

Parâmetros
testRunResults : uma lista de TestRunResult a serem mesclados.

strategy MergeStrategy: a estratégia de fusão adotada para combinar resultados.

Retorna
TestRunResult o TestRunResult final que contém os dados mesclados dos testRunResults.

resetRunFailure

public void resetRunFailure ()

Redefine o status de falha da execução.

Às vezes, é necessário redefinir o status de falha da execução ao tentar de novo. Isso deve ser feito com cuidado para evitar a limpeza de uma falha real.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Parâmetros
metricAggregation boolean

setRunComplete

public void setRunComplete (boolean runComplete)

Parâmetros
runComplete boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parâmetros
test TestDescription

trace String

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parâmetros
test TestDescription

failure FailureDescription

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Parâmetros
test TestDescription

endTime long

testMetrics

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Parâmetros
test TestDescription

testMetrics

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parâmetros
test TestDescription

failure FailureDescription

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parâmetros
test TestDescription

trace String

testIgnored

public void testIgnored (TestDescription test)

Parâmetros
test TestDescription

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

As informações sobre um arquivo que está sendo registrado são armazenadas e associadas ao caso de teste ou à execução de teste em andamento.

Parâmetros
dataName String: o nome que faz referência aos dados.

logFile LogFile: o objeto LogFile que representa onde o objeto foi salvo e informações sobre ele.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parâmetros
elapsedTime long

runMetrics

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

Parâmetros
failureDescription FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

Parâmetros
errorMessage String

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                long startTime)

Notifica que uma execução de teste foi iniciada.

Parâmetros
runName String: o nome associado à execução do teste para fins de rastreamento.

testCount int: o número de casos de teste esperados associados à execução do teste.

startTime long

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Notifica que uma execução de teste foi iniciada.

Parâmetros
runName String: o nome associado à execução do teste para fins de rastreamento.

testCount int: o número de casos de teste esperados associados à execução do teste.

testRunStopped

public void testRunStopped (long elapsedTime)

Parâmetros
elapsedTime long

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Parâmetros
test TestDescription

reason SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parâmetros
test TestDescription

startTime long

testStarted

public void testStarted (TestDescription test)

Parâmetros
test TestDescription