NameMangleListener
public
abstract
class
NameMangleListener
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.NameMangleListener |
Um listener de proxy para traduzir métodos de teste, classes e nomes de pacotes conforme os resultados são informados.
Resumo
Construtores públicos | |
---|---|
NameMangleListener(ITestInvocationListener listener)
|
Métodos públicos | |
---|---|
TestSummary
|
getSummary()
Permite que o InvocationListener retorne um resumo. |
void
|
invocationEnded(long elapsedTime)
Informa que a invocação foi encerrada, seja com sucesso ou devido a algum erro condição. |
void
|
invocationFailed(Throwable cause)
Informa uma invocação incompleta devido a uma condição de erro. |
void
|
invocationStarted(IInvocationContext context)
Informa o início da invocação do teste. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Chamado quando um teste atômico sinaliza que assume uma condição falsa |
void
|
testEnded(TestDescription test,
Informa o final da execução 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)
Fornece o registro associado ou os dados de depuração da invocação de teste. |
void
|
testRunEnded(long elapsedTime,
Informa o fim da execução do teste. |
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 runName, int testCount)
Informa 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)
Informa o início de um caso de teste individual. |
Métodos protegidos | |
---|---|
TestDescription
|
mangleTestId(TestDescription test)
Esse método é executado em todos os |
String
|
mangleTestRunName(String name)
Esse método é executado em todos os nomes de execução de teste passados para o método
|
Construtores públicos
NameMangleListener
public NameMangleListener (ITestInvocationListener listener)
Parâmetros | |
---|---|
listener |
ITestInvocationListener |
Métodos públicos
getResumo
public TestSummary getSummary ()
Permite que o InvocationListener retorne um resumo.
Retorna | |
---|---|
TestSummary |
Um TestSummary que resume a execução ou é nulo. |
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 |
InvocationFalha
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. |
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. |
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 |
testEnded
public void testEnded (TestDescription test,testMetrics)
Informa o final da execução de um caso de teste individual.
Se testFailed(TestDescription, FailureDescription)
não foi invocado, o teste foi aprovado. Também retorna qualquer chave/valor
métricas que podem ter sido emitidas durante a execução do caso de teste.
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
testMetrics |
: um ERROR(/Map) das métricas emitidas |
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)
Fornece o registro associado ou os dados de depuração da invocação de teste.
Precisa ser chamado antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable))
ou
ERROR(/ITestInvocationListener#invocationEnded(long))
A estrutura da TradeFederation chamará automaticamente esse método, fornecendo o registro 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. os implementadores devem ser capazes de lidar
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 fechar o
InputStream quando concluído. Os autores da chamada precisam garantir que a fonte dos dados não seja alterada.
presente e acessível até que o método testLog seja concluído. |
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 (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 runName, int testCount)
Informa 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 na execução do teste |
testRunSStop
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: não usado no momento, considere remover
Parâmetros | |
---|---|
elapsedTime |
long : tempo decorrido informado pelo dispositivo, em milissegundos. |
testStarted
public void testStarted (TestDescription test)
Informa o início de um caso de teste individual. A interface mais antiga precisa usar testStarted(com.android.tradefed.result.TestDescription)
sempre que possível.
Parâmetros | |
---|---|
test |
TestDescription : identifica o teste. |
Métodos protegidos
mangleTestId
protected TestDescription mangleTestId (TestDescription test)
Esse método é executado em todos os TestDescription
s transmitidos aos callbacks testStarted(com.android.tradefed.result.TestDescription)
, testFailed(com.android.tradefed.result.TestDescription, String)
e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))
. O método deve retornar uma
TestDescription
possivelmente diferente que será transmitido para o ITestInvocationListener
downstream que foi especificado durante a construção.
A implementação precisa ter cuidado para não modificar o TestDescription
original.
A implementação padrão transmite o identificador de entrada não modificado.
Parâmetros | |
---|---|
test |
TestDescription |
Retorna | |
---|---|
TestDescription |
Nome da execução de teste mangle
protected String mangleTestRunName (String name)
Esse método é executado em todos os nomes de execução de teste passados para o método
testRunStarted(String, int)
. O método deve retornar uma resposta
que será transmitido ao ITestInvocationListener
downstream que foi
especificado durante a construção.
A implementação precisa ter cuidado para não modificar o nome da execução original.
A implementação padrão passa o nome da execução de teste recebida por não modificado.
Parâmetros | |
---|---|
name |
String |
Retorna | |
---|---|
String |