Esta página foi traduzida pela API Cloud Translation.

NomeMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Um ouvinte proxy para traduzir nomes de métodos de teste, classes e pacotes à medida que os resultados são relatados.

Resumo

Construtores públicos
`NameMangleListener ( ITestInvocationListener listener)`

Métodos públicos
`TestSummary`	`getSummary ()` Permite que o InvocationListener retorne um resumo.
`void`	`invocationEnded (long elapsedTime)` Relata que a invocação foi encerrada, seja com êxito ou 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)` Informa o início da chamada de teste.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` Chamado quando um teste atômico sinaliza que assume uma condição falsa
`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, 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 dados de depuração da invocação de teste.
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` Informa o final 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)` Relata o início de um caso de teste individual.

Métodos protegidos
`TestDescription`	`mangleTestId ( TestDescription test)` Este método é executado em todos `TestDescription` s que são passados para `testStarted(com.android.tradefed.result.TestDescription)` , `testFailed(com.android.tradefed.result.TestDescription, String)` e `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))` retornos de chamada.
`String`	`mangleTestRunName (String name)` Este método é executado em todos os nomes de execução de teste que são passados para o retorno de chamada `testRunStarted(String, int)` .

Construtores públicos

NomeMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parâmetros
`listener`	`ITestInvocationListener`

Métodos públicos

obter Resumo

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

Devoluções
`TestSummary`	Um `TestSummary` resumindo a execução ou nulo

invocaçãoEnded

public void invocationEnded (long elapsedTime)

Relata que a invocação foi encerrada, seja com êxito 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çãoFailed

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)

Informa o início da chamada 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

teste finalizado

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`	: um `ERROR(/Map)` das métricas emitidas

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

testeLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Fornece o log associado ou dados de depuração da invocação de teste.

Deve ser chamado antes de ERROR(/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 da `String` dos dados. por exemplo, "dispositivo_logcat". Nota dataName pode não ser exclusivo por chamada. 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 iniciar a leitura dos 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.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o final da execução do teste. FIXME: Não podemos ter duas interfaces Map<> com tipos diferentes, então temos que usar HashMap aqui.

Parâmetros
`elapsedTime`	`long` : tempo decorrido relatado pelo dispositivo, em milissegundos
`runMetrics`	: pares de valores-chave relatados no final de uma execução de 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` que descreve 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 em execução de teste

testRunStopped

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` : tempo decorrido relatado pelo dispositivo, em milissegundos

teste iniciado

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

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Este método é executado em todos TestDescription s que são passados para testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) e ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) retornos de chamada. O método deve retornar um TestDescription possivelmente diferente que será passado para o ITestInvocationListener downstream que foi especificado durante a construção.

A implementação deve ter cuidado para não modificar o TestDescription original.

A implementação padrão passa o identificador de entrada sem modificação.

Parâmetros
`test`	`TestDescription`

Devoluções
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Este método é executado em todos os nomes de execução de teste que são passados para o retorno de chamada testRunStarted(String, int) . O método deve retornar um nome de execução de teste possivelmente diferente que será passado para o ITestInvocationListener downstream que foi especificado durante a construção.

A implementação deve ter cuidado para não modificar o nome original da execução.

A implementação padrão passa o nome da execução de teste de entrada sem modificação.

Parâmetros
`name`	`String`

Devoluções
`String`