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 umTestRunResult vazio.

Métodos públicos
void	addTestResult(TestDescription test, TestResult testResult)
Set<TestDescription>	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.
Set<TestDescription>	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.
Set<TestDescription>	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 com todos os arquivos registrados associados a esse caso de teste.
Map<String, String>	getRunMetrics()
HashMap<String, MetricMeasurement.Metric>	getRunProtoMetrics()
long	getStartTime() Retorna o horário de início da primeira chamada "testRunStart".
Map<TestDescription, TestResult>	getTestEntriesInState(Collection<TestStatus> statuses) Recebe o conjunto de testes nos status especificados.
Map<TestDescription, TestResult>	getTestResults() Retorna um mapa dos resultados do teste.
Set<TestDescription>	getTestsInState(List<TestStatus> statuses) Recebe o conjunto de testes nos status especificados.
List<TestResult>	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(List<TestRunResult> testRunResults)
static TestRunResult	merge(List<TestRunResult> 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, 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) As informações sobre um arquivo sendo registrado são armazenadas e associadas ao caso de teste ou à execução de teste em andamento.
void	testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics) Nova interface usando as novas métricas proto.
void	testRunEnded(long elapsedTime, Map<String, String> runMetrics)
void	testRunFailed(FailureDescription failureDescription)
void	testRunFailed(String errorMessage)
void	testRunStarted(String runName, int testCount, long startTime) Notifica que um teste foi iniciado.
void	testRunStarted(String runName, int testCount) Notifica que um teste foi iniciado.
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 umTestRunResult vazio.

Métodos públicos

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

Parâmetros
test	TestDescription
testResult	TestResult

getCompletedTests

public Set<TestDescription> getCompletedTests ()

Recebe o conjunto de testes concluídos.

Retorna
Set<TestDescription>

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 Set<TestDescription> getFailedTests ()

Recebe o conjunto de testes com falha.

Retorna
Set<TestDescription>

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(TestStatus).

Parâmetros
ddmlibStatus	TestResult.TestStatus

Retorna
int

getPassedTests

public Set<TestDescription> getPassedTests ()

Recebe o conjunto de testes aprovados.

Retorna
Set<TestDescription>

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 com todos os arquivos registrados associados a esse caso de teste.

Retorna
MultiMap<String, LogFile>

getRunMetrics

public Map<String, String> getRunMetrics ()

Retorna
Map<String, String>	um Map das métricas de execução do teste.

getRunProtoMetrics

public HashMap<String, MetricMeasurement.Metric> getRunProtoMetrics ()

Retorna
HashMap<String, MetricMeasurement.Metric>	um 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 Map<TestDescription, TestResult> getTestEntriesInState (Collection<TestStatus> statuses)

Recebe o conjunto de testes nos status especificados.

Parâmetros
statuses	Collection

Retorna
Map<TestDescription, TestResult>

getTestResults

public Map<TestDescription, TestResult> getTestResults ()

Retorna um mapa dos resultados do teste.

Retorna
Map<TestDescription, TestResult>

getTestsInState

public Set<TestDescription> getTestsInState (List<TestStatus> statuses)

Recebe o conjunto de testes nos status especificados.

Parâmetros
statuses	List

Retorna
Set<TestDescription>

getTestsResultsInState

public List<TestResult> getTestsResultsInState (TestStatus status)

Retorna todos os TestResult em um estado específico.

Parâmetros
status	TestStatus

Retorna
List<TestResult>

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.

merge

public static TestRunResult merge (List<TestRunResult> testRunResults)

Parâmetros
testRunResults	List

Retorna
TestRunResult

Confira também:

• merge(List,MergeStrategy)

merge

public static TestRunResult merge (List<TestRunResult> 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	List: 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 remoção 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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Parâmetros
test	TestDescription
endTime	long
testMetrics	HashMap

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Parâmetros
test	TestDescription
testMetrics	HashMap

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 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Nova interface usando as novas métricas proto.

Parâmetros
elapsedTime	long
runMetrics	HashMap

testRunEnded

public void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

Parâmetros
elapsedTime	long
runMetrics	Map

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 um teste foi iniciado.

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 um teste foi iniciado.

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