ResultForwarder
public class ResultForwarder
extends Object
implements ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.ResultForwarder |
Um ITestInvocationListener
que encaminha os resultados da chamada para uma lista de outros ouvintes.
Resumo
Construtores públicos | |
---|---|
ResultForwarder ( listeners) ResultForwarder ( listeners) Crie um | |
ResultForwarder ( ITestInvocationListener... listeners) Construtor arg de variável alternativa para |
Construtores protegidos | |
---|---|
ResultForwarder () Crie um |
Métodos públicos | |
---|---|
TestSummary | getSummary () Permite que o InvocationListener retorne um resumo. |
void | invocationEnded (long elapsedTime) Informa que a chamada foi encerrada, seja com sucesso ou devido a alguma condição de erro. |
void | invocationFailed ( FailureDescription failure) Relata uma invocação incompleta devido a alguma condição de erro. |
void | invocationFailed (Throwable cause) Relata uma invocação incompleta devido a alguma condição de erro. |
void | invocationStarted ( IInvocationContext context) Relata o início da invocação de teste. |
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, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa para |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Relata o final da execução de um caso de teste individual. |
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 será executado, geralmente porque um método de teste é anotado com org.junit.Ignore. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Fornece o log associado ou os dados de depuração da chamada de teste. |
void | testModuleEnded () Relata o fim de uma execução de módulo. |
void | testModuleStarted ( IInvocationContext moduleContext) Relata o início de um módulo em execução. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Relata o fim da execução de teste. |
void | testRunFailed ( FailureDescription failure) Falha na execução do teste de relatórios devido a uma falha descrita por |
void | testRunFailed (String errorMessage) Falha na execução do teste de relatórios devido a um erro fatal. |
void | testRunStarted (String runName, int testCount, int attemptNumber) Relata o início de uma execução de teste. |
void | testRunStarted (String runName, int testCount) Relata o início de uma execução de teste. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Relata o início de uma execução de teste. |
void | testRunStopped (long elapsedTime) A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário. |
void | testStarted ( TestDescription test, long startTime) Alternativa para |
void | testStarted ( TestDescription test) Relata o início de um caso de teste individual. |
Métodos protegidos | |
---|---|
getListeners () Obtenha a lista de ouvintes. | |
void | setListeners ( listeners) setListeners ( listeners) Defina os ouvintes após a construção. |
void | setListeners ( ITestInvocationListener... listeners) Defina os ouvintes após a construção. |
Construtores públicos
ResultForwarder
public ResultForwarder (listeners)
Crie um ResultForwarder
.
Parâmetros | |
---|---|
listeners | ITestInvocationListener s para encaminhar resultados para |
ResultForwarder
public ResultForwarder (ITestInvocationListener... listeners)
Construtor arg de variável alternativa para ResultForwarder
.
Parâmetros | |
---|---|
listeners | ITestInvocationListener : os ITestInvocationListener s reais para encaminhar resultados para |
Construtores protegidos
ResultForwarder
protected ResultForwarder ()
Crie um ResultForwarder
com configuração de ouvinte adiado. Destinado apenas para uso por subclasses.
Métodos públicos
getResumo
public TestSummary getSummary ()
Permite que o InvocationListener retorne um resumo.
Devoluções | |
---|---|
TestSummary | Um TestSummary resumindo a execução, ou nulo |
invocaçãoTerminou
public void invocationEnded (long elapsedTime)
Informa que a chamada foi encerrada, seja com sucesso ou devido a alguma condição de erro.
Será chamado automaticamente pelo framework TradeFederation.Parâmetros | |
---|---|
elapsedTime | long : o tempo decorrido da invocação em ms |
invocação falhou
public void invocationFailed (FailureDescription failure)
Relata uma invocação incompleta devido a alguma condição de erro.
Será chamado automaticamente pelo framework TradeFederation.
Parâmetros | |
---|---|
failure | FailureDescription : a FailureDescription descrevendo a causa da falha |
invocação falhou
public void invocationFailed (Throwable cause)
Relata uma invocação incompleta devido a alguma condição de erro.
Será chamado automaticamente pelo framework TradeFederation.Parâmetros | |
---|---|
cause | Throwable : a causa Throwable da falha |
invocaçãoIniciada
public void invocationStarted (IInvocationContext context)
Relata o início da invocação de teste.
Será chamado automaticamente pelo framework TradeFederation. Os repórteres precisam substituir esse método para oferecer suporte a relatórios de vários dispositivos.
Parâmetros | |
---|---|
context | IInvocationContext : informações sobre a invocação |
testeAssunçãoFalha
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 : rastreamento de pilha de falha |
testeAssunçãoFalha
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 seu contexto. |
testeTerminado
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternativa para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
onde 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 : a hora em que o teste terminou, medido via System.currentTimeMillis() |
testMetrics | ERROR(/Map) das métricas emitidas |
testeTerminado
public void testEnded (TestDescription test,testMetrics)
Relata o final da execução de um caso de teste individual.
Se testFailed(TestDescription, FailureDescription)
não foi invocado, este teste foi aprovado. Também retorna quaisquer métricas de chave/valor que possam ter sido emitidas durante a execução do caso de teste.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
testMetrics | ERROR(/Map) das métricas emitidas |
teste falhou
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 seu contexto. |
teste falhou
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 : rastreamento de pilha de falha |
testeIgnorado
public void testIgnored (TestDescription test)
Chamado quando um teste não será 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)
Fornece o log associado ou os dados de depuração da chamada de teste.
Deve ser chamado antes deERROR(/ITestInvocationListener#invocationFailed(Throwable))
ou ERROR(/ITestInvocationListener#invocationEnded(long))
A estrutura TradeFederation chamará automaticamente esse método, fornecendo o log do host e, se aplicável, o logcat do dispositivo.Parâmetros | |
---|---|
dataName | String : um nome descritivo de String dos dados. por exemplo, "device_logcat". Observação dataName pode não ser exclusivo por invocação. ou seja, os implementadores devem ser capazes de lidar com várias chamadas com o mesmo dataName |
dataType | LogDataType : o LogDataType dos dados |
dataStream | InputStreamSource : o InputStreamSource dos dados. Os implementadores devem chamar createInputStream para começar a ler os dados e garantir o fechamento do InputStream resultante quando concluído. Os chamadores devem garantir que a fonte dos dados permaneça presente e acessível até que o método testLog seja concluído. |
testModuleEnded
public void testModuleEnded ()
Relata o fim de uma execução de módulo.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Relata o início de um módulo em execução. Esse retorno de chamada está associado a testModuleEnded()
e é opcional na sequência. Ele é usado apenas durante uma execução que usa módulos: executores baseados em suíte.
Parâmetros | |
---|---|
moduleContext | IInvocationContext : o IInvocationContext do módulo. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Relata o fim da execução de teste. FIXME: Não podemos ter duas interfaces Map<> com tipo diferente, então temos que usar HashMap aqui.
Parâmetros | |
---|---|
elapsedTime | long : o dispositivo relatou o tempo decorrido, em milissegundos |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (FailureDescription failure)
Falha na execução do teste de relatórios devido a uma falha descrita por FailureDescription
.
Parâmetros | |
---|---|
failure | FailureDescription : FailureDescription descrevendo a falha e seu contexto. |
testRunFailed
public void testRunFailed (String errorMessage)
Falha na execução do teste de relatórios devido a um erro fatal.
Parâmetros | |
---|---|
errorMessage | String : String que descreve o motivo da falha de execução. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Relata o início de uma execução de teste.
Parâmetros | |
---|---|
runName | String : o nome da execução de teste |
testCount | int : número total de testes em execução de teste |
attemptNumber | int : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas várias vezes. O tryNumber é indexado em 0 e deve ser incrementado sempre que uma nova execução ocorrer. Por exemplo, um teste granular é repetido 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Relata o início de uma execução de teste.
Parâmetros | |
---|---|
runName | String : o nome da execução de teste |
testCount | int : número total de testes em execução de teste |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Relata o início de uma execução de teste.
Parâmetros | |
---|---|
runName | String : o nome da execução de teste |
testCount | int : número total de testes em execução de teste |
attemptNumber | int : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas várias vezes. O tryNumber é indexado em 0 e deve ser incrementado sempre que uma nova execução ocorrer. Por exemplo, um teste granular é repetido 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3. |
startTime | long : a hora em que a execução começou, medida via System.currentTimeMillis() |
testeRunParado
public void testRunStopped (long elapsedTime)
A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.
TODO: atualmente não utilizado, considere remover
Parâmetros | |
---|---|
elapsedTime | long : o dispositivo relatou o tempo decorrido, em milissegundos |
testeIniciado
public void testStarted (TestDescription test, long startTime)
Alternativa para testStarted(com.android.tradefed.result.TestDescription)
onde também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
para uma medida precisa .
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
startTime | long : a hora em que o teste começou, medido via System.currentTimeMillis() |
testeIniciado
public void testStarted (TestDescription test)
Relata o início de um caso de teste individual. Interface mais antiga, deve usar testStarted(com.android.tradefed.result.TestDescription)
sempre que possível.
Parâmetros | |
---|---|
test | TestDescription : identifica o teste |
Métodos protegidos
getListeners
protectedgetListeners ()
Obtenha a lista de ouvintes. Destinado apenas para uso por subclasses.
Devoluções | |
---|---|
A lista de ITestInvocationListener s. |
setOuvintes
protected void setListeners (listeners)
Defina os ouvintes após a construção. Destinado apenas para uso por subclasses.
Parâmetros | |
---|---|
listeners | ITestInvocationListener s para encaminhar resultados para |
setOuvintes
protected void setListeners (ITestInvocationListener... listeners)
Defina os ouvintes após a construção. Destinado apenas para uso por subclasses.
Parâmetros | |
---|---|
listeners | ITestInvocationListener : os ITestInvocationListener s reais para encaminhar resultados para |