Agregador de resultados
public
class
ResultAggregator
extends CollectingTestListener
java.lang.Object | ||
↳ | com.android.tradefed.result.CollectingTestListener (link em inglês) | |
↳ | com.android.tradefed.retry.ResultAggregator |
Encaminhador especial que agrega os resultados quando necessário, com base na estratégia de repetição que foi tomadas.
Resumo
Construtores públicos | |
---|---|
ResultAggregator(
|
Métodos públicos | |
---|---|
void
|
cleanEventsFiles()
|
final
void
|
forwardAggregatedInvocationLogs()
Encaminhar todos os registros no nível da invocação para os geradores de relatórios de resultados que não oferecem suporte ao resultados. |
void
|
invocationEnded(long elapsedTime)
Informa que a invocação foi encerrada, seja com sucesso ou devido a algum erro condição. |
void
|
invocationFailed(FailureDescription failure)
|
void
|
invocationFailed(Throwable cause)
Informa uma invocação incompleta devido a uma condição de erro. |
void
|
invocationSkipped(SkipReason reason)
Informa uma invocação como "ignorada" |
void
|
invocationStarted(IInvocationContext context)
Informa o início da invocação do teste. |
void
|
logAssociation(String dataName, LogFile logFile)
Em alguns casos, o registro deve ser fortemente associado a casos de teste, mas a oportunidade de fazer
assim no |
void
|
setLogSaver(ILogSaver logSaver)
|
void
|
setUpdatedReporting(boolean updatedReporting)
Define o novo relatório. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Chamado quando um teste atômico sinaliza que assume uma condição falsa |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Chamado quando um teste atômico sinaliza que assume uma condição falsa |
void
|
testEnded(TestDescription test, long endTime,
Alternativa a |
void
|
testFailed(TestDescription test, FailureDescription failure)
Relata a falha de um caso de teste individual. |
void
|
testFailed(TestDescription test, String trace)
Relata a falha de um caso de teste individual. |
void
|
testIgnored(TestDescription test)
Chamado quando um teste não é executado, geralmente porque um método de teste é anotado com "org.junit.Ignore". |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
|
void
|
testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
|
void
|
testModuleEnded()
Informa o final de uma execução de módulo. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Informa o início de um módulo em execução. |
void
|
testRunEnded(long elapsedTime,
Informa o fim da execução do teste. |
void
|
testRunFailed(FailureDescription failure)
A execução do teste de relatórios não foi concluída devido a uma falha descrita por |
void
|
testRunFailed(String errorMessage)
A execução do teste de relatórios não foi concluída devido a um erro fatal. |
void
|
testRunStarted(String name, int testCount, int attemptNumber, long startTime)
Informa o início de uma execução de teste. |
void
|
testSkipped(TestDescription test, SkipReason reason)
Chamado quando um teste é ignorado e não executado por um motivo que normalmente não é esperado. |
void
|
testStarted(TestDescription test, long startTime)
Alternativa a |
Métodos protegidos | |
---|---|
File[]
|
getEventsLogs()
|
Construtores públicos
Agregador de resultados
public ResultAggregator (listeners, RetryStrategy strategy)
Parâmetros | |
---|---|
listeners |
|
strategy |
RetryStrategy |
Métodos públicos
cleanEventsFiles
public void cleanEventsFiles ()
encaminharAggregatedInvocationLogs
public final void forwardAggregatedInvocationLogs ()
Encaminhar todos os registros no nível da invocação para os geradores de relatórios de resultados que não oferecem suporte ao resultados.
invocaçãoFinalizada
public void invocationEnded (long elapsedTime)
Informa que a invocação foi encerrada, seja com sucesso ou devido a algum erro condição.
Será chamado automaticamente pela estrutura TradeFederation.
Parâmetros | |
---|---|
elapsedTime |
long : o tempo decorrido da invocação em ms |
InvocationFailed
public void invocationFailed (FailureDescription failure)
Parâmetros | |
---|---|
failure |
FailureDescription |
InvocationFailed
public void invocationFailed (Throwable cause)
Informa uma invocação incompleta devido a uma condição de erro.
Será chamado automaticamente pela estrutura TradeFederation.
Parâmetros | |
---|---|
cause |
Throwable : a causa Throwable da falha. |
invocationSkipped
public void invocationSkipped (SkipReason reason)
Informa uma invocação como "ignorada"
Parâmetros | |
---|---|
reason |
SkipReason |
invocationStarted
public void invocationStarted (IInvocationContext context)
Informa o início da invocação do teste.
Será chamado automaticamente pela estrutura TradeFederation. Os informantes precisam substituir esse método para oferecer suporte à geração de relatórios de vários dispositivos.
Parâmetros | |
---|---|
context |
IInvocationContext : informações sobre a invocação. |
associação de registro
public void logAssociation (String dataName, LogFile logFile)
Em alguns casos, o registro deve ser fortemente associado a casos de teste, mas a oportunidade de fazer
assim no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
direto
de retorno de chamada não é possível. Assim, esse callback permite fornecer uma associação forte
explicitamente.
Parâmetros | |
---|---|
dataName |
String : o nome dos dados |
logFile |
LogFile : o LogFile que foi registrado antes e precisa ser associado ao
caso de teste. |
setUpdatedReporting
public void setUpdatedReporting (boolean updatedReporting)
Define o novo relatório.
Parâmetros | |
---|---|
updatedReporting |
boolean |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Chamado quando um teste atômico sinaliza que assume uma condição falsa
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
trace |
String : stack trace de falha |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Chamado quando um teste atômico sinaliza que assume uma condição falsa
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
failure |
FailureDescription : FailureDescription descrevendo a falha e o contexto. |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, em que podemos especificar o horário de término
diretamente. Combine com testStarted(com.android.tradefed.result.TestDescription, long)
para uma medição precisa.
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
endTime |
long : o horário de término do teste, medido por System.currentTimeMillis() . |
testMetrics |
: um ERROR(/Map) das métricas emitidas |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Relata a falha de um caso de teste individual.
Será chamado entre testStarted e testEnded.
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
failure |
FailureDescription : FailureDescription descrevendo a falha e o contexto. |
testFailed
public void testFailed (TestDescription test, String trace)
Relata a falha de um caso de teste individual.
Será chamado entre testStarted e testEnded.
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
trace |
String : stack trace de falha |
testIgnorado
public void testIgnored (TestDescription test)
Chamado quando um teste não é executado, geralmente porque um método de teste é anotado com "org.junit.Ignore".
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Parâmetros | |
---|---|
dataName |
String |
dataType |
LogDataType |
dataStream |
InputStreamSource |
testLogSaved
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Parâmetros | |
---|---|
dataName |
String |
dataType |
LogDataType |
dataStream |
InputStreamSource |
logFile |
LogFile |
testModuleEnded
public void testModuleEnded ()
Informa o final de uma execução de módulo.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Informa o início de um módulo em execução. Esse callback está associado a testModuleEnded()
e é opcional na sequência. Ela só é usada durante uma execução que usa
módulos: executores baseados em pacote.
Parâmetros | |
---|---|
moduleContext |
IInvocationContext : o IInvocationContext do módulo. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Informa o fim da execução do teste. FIXME: não podemos ter dois Map<> interfaces com tipos diferentes, então precisamos usar o HashMap aqui.
Parâmetros | |
---|---|
elapsedTime |
long : tempo decorrido informado pelo dispositivo, em milissegundos. |
runMetrics |
: pares de chave-valor informados no final de um teste com Metric . |
testRunFailed
public void testRunFailed (FailureDescription failure)
A execução do teste de relatórios não foi concluída devido a uma falha descrita por FailureDescription
.
Parâmetros | |
---|---|
failure |
FailureDescription : FailureDescription descrevendo a falha e o contexto. |
testRunFailed
public void testRunFailed (String errorMessage)
A execução do teste de relatórios não foi concluída devido a um erro fatal.
Parâmetros | |
---|---|
errorMessage |
String : String descrevendo o motivo da falha na execução. |
testRunStarted
public void testRunStarted (String name, int testCount, int attemptNumber, long startTime)
Informa o início de uma execução de teste.
Parâmetros | |
---|---|
name |
String : o nome da execução de teste. |
testCount |
int : número total de testes na execução do teste |
attemptNumber |
int : número do pedido, identificando as diferentes tentativas do mesmo runName
executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado sempre que um
uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro execuções no total
com o mesmo runName, e o tryNumber vai de 0 a 3. |
startTime |
long : o horário de início da corrida, medida usando System.currentTimeMillis() . |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Chamado quando um teste é ignorado e não executado por um motivo que normalmente não é esperado. Tentaremos realizar esses testes novamente para tentar obter uma execução adequada.
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
Alternativa a testStarted(com.android.tradefed.result.TestDescription)
, em que também especificamos quando o teste foi
iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
para uma medição precisa.
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
startTime |
long : o horário de início do teste, medido por System.currentTimeMillis() . |
Métodos protegidos
getEventsLogs
protected File[] getEventsLogs ()
Retorna | |
---|---|
File[] |