Esta página foi traduzida pela API Cloud Translation.

BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object
↳	com.android.tradefed.postprocessor.BasePostProcessor

Subclasses diretas conhecidas

AggregatePostProcessor , AveragePostProcessor , BluetoothConnectionSuccessRatePostProcessor , MetricFilePostProcessor , PerfettoGenericPostProcessor , StatsdGenericPostProcessor

AggregatePostProcessor	Um agregador de métrica que fornece o mínimo, máximo, média, variância, desvio padrão, total, contagem e, opcionalmente, percentis para métricas numéricas coletadas durante execuções de teste de várias iterações, tratando-as como duplas.
AveragePostProcessor	Implementação de pós-processador que calcula a média da lista de métricas.
BluetoothConnectionSuccessRatePostProcessor	Implementação de pós-processador que calcula taxa de sucesso para um perfil bluetooth Use "metric-key-match" para especificar as métricas que contêm estados de conexão bluetooth no array numérico Exemplo [0, 1, 2, 3, 0, 1, 2, 3].
MetricFilePostProcessor	Usado para fazer upload do arquivo de log de métricas coletado durante o nível de teste e execução.
PerfettoGenericPostProcessor	Um pós-processador que processa o arquivo proto perfetto de métrica binária/texto em pares chave-valor, expandindo recursivamente as mensagens proto e os campos com valores de string até que o campo com valor numérico seja encontrado.
StatsdGenericPostProcessor	Um pós-processador que processa relatórios proto statsd binários em pares chave-valor, expandindo o relatório como uma estrutura de árvore.

Subclasses indiretas conhecidas

StatsdBeforeAfterGaugeMetricPostProcessor , StatsdEventMetricPostProcessor

StatsdBeforeAfterGaugeMetricPostProcessor	Um pós-processador que processa métricas de medição coletadas em uma abordagem "antes/depois", ou seja,
StatsdEventMetricPostProcessor	Um pós-processador que processa métricas de eventos em relatórios statsd em pares chave-valor, usando os formatadores especificados no processador.

O IPostProcessor base que toda implementação deve estender. Certifique-se de que os métodos de pós-processamento sejam chamados antes dos relatórios de resultados finais.

Resumo

Construtores públicos
`BasePostProcessor ()`

Métodos públicos
`final ITestInvocationListener`	`init ( ITestInvocationListener listener)` Etapa de inicialização do pós-processador.
`final void`	`invocationEnded (long elapsedTime)` Informa que a chamada foi finalizada, seja com sucesso ou devido a alguma condição de erro.
`final void`	`invocationFailed ( FailureDescription failure)` Relata uma invocação incompleta devido a alguma condição de erro.
`final void`	`invocationFailed (Throwable cause)` Relata uma invocação incompleta devido a alguma condição de erro.
`final void`	`invocationStarted ( IInvocationContext context)` Ouvintes de invocação para encaminhamento
`final boolean`	`isDisabled ()` Retorna True se o objeto inteiro estiver desabilitado (ignore a configuração e desmontagem).
`final void`	`logAssociation (String dataName, LogFile logFile)` Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente no `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` não é possível. Atualiza a associação log-to-test.
	`processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` `processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` Implemente este método para agregar métricas e logs em todos os testes.
`abstract`	`processRunMetricsAndLogs ( rawMetrics, runLogs)` `processRunMetricsAndLogs ( rawMetrics, runLogs)` `processRunMetricsAndLogs ( rawMetrics, runLogs)` Implemente esse método para gerar um conjunto de novas métricas a partir das métricas e logs existentes.
	`processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs)` `processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs)` `processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs)` Implemente este método para postar métricas de processo e logs de cada teste.
`final void`	`setLogSaver ( ILogSaver logSaver)` Defina o `ILogSaver` para permitir que o implementador salve arquivos.
`void`	`setUp ()` Substitua esse método nos pós-processadores filho para inicializar antes da execução do teste.
`final void`	`testAssumptionFailure ( TestDescription test, String trace)` Chamado quando um teste atômico sinaliza que assume uma condição falsa
`final void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Chamado quando um teste atômico sinaliza que assume uma condição falsa
`final void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `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.
`final void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` Informa o fim da execução de um caso de teste individual.
`final void`	`testFailed ( TestDescription test, FailureDescription failure)` Relata a falha de um caso de teste individual.
`final void`	`testFailed ( TestDescription test, String trace)` Relata a falha de um caso de teste individual.
`final void`	`testIgnored ( TestDescription test)` Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`final void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Use este método para registrar um arquivo da implementação PostProcessor.
`final void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Chamado quando o log de teste é salvo.
`final void`	`testModuleEnded ()` Informa o fim da execução de um módulo.
`final void`	`testModuleStarted ( IInvocationContext moduleContext)` Informa o início da execução de um módulo.
`final void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` Informa o fim da execução do teste.
`final void`	`testRunFailed ( FailureDescription failure)` A execução do teste de relatórios falhou devido a uma falha descrita por `FailureDescription` .
`final void`	`testRunFailed (String errorMessage)` A execução do teste de relatórios não foi concluída devido a um erro fatal.
`final void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Informa o início de uma execução de teste.
`final void`	`testRunStarted (String runName, int testCount)` Callbacks de execução de teste
`final void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Informa o início de uma execução de teste.
`final 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.
`final 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 medição precisa .
`final void`	`testStarted ( TestDescription test)` Retornos de chamada de casos de teste

Métodos protegidos
`MetricMeasurement.DataType`	`getMetricType ()` Substitua esse método para alterar o tipo de métrica, se necessário.
`String`	`getRunName ()`

Construtores públicos

BasePostProcessor

public BasePostProcessor ()

Métodos públicos

iniciar

public final ITestInvocationListener init (ITestInvocationListener listener)

Etapa de inicialização do pós-processador. Certifique-se de ser chamado antes de qualquer um dos retornos de chamada de teste.

Parâmetros
`listener`	`ITestInvocationListener`

devoluções
`ITestInvocationListener`

invocaçãoEncerrada

public final void invocationEnded (long elapsedTime)

Informa que a chamada foi finalizada, seja com sucesso ou devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
`elapsedTime`	`long` : o tempo decorrido da invocação em ms

invocação falhou

public final void invocationFailed (FailureDescription failure)

Relata uma invocação incompleta devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
`failure`	`FailureDescription` : o `FailureDescription` que descreve a causa da falha

invocação falhou

public final void invocationFailed (Throwable cause)

Relata uma invocação incompleta devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
`cause`	`Throwable` : a causa `ERROR(/Throwable)` da falha

invocaçãoIniciado

public final void invocationStarted (IInvocationContext context)

Ouvintes de invocação para encaminhamento

Parâmetros
`context`	`IInvocationContext` : informações sobre a invocação

está desabilitado

public final boolean isDisabled ()

Retorna True se o objeto inteiro estiver desabilitado (ignore a configuração e desmontagem). Falso caso contrário.

devoluções
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Em alguns casos, o log deve estar fortemente associado a casos de teste, mas a oportunidade de fazê-lo diretamente no testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) não é possível. Assim, esse retorno de chamada permite fornecer explicitamente uma forte associação.

Atualiza a associação log-to-test. Se esse método for chamado durante um teste, o log pertencerá ao teste; caso contrário, será um log de execução.

Parâmetros
`dataName`	`String` : O nome dos dados
`logFile`	`LogFile` : o `LogFile` que foi registrado antes e deve ser associado ao caso de teste.

processAllTestMetricsAndLogs

public  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

Implemente este método para agregar métricas e logs em todos os testes. As métricas provenientes desse método serão relatadas como métricas de execução. Somente as métricas recém-geradas devem ser retornadas e com nome de chave exclusivo (nenhuma colisão com chaves existentes é permitida).

Parâmetros
`allTestMetrics`	`ListMultimap` : Um HashMultimap armazenando as métricas de cada teste agrupadas por nomes de métricas.
`allTestLogs`	: um mapa que armazena o mapa de cada teste de arquivos de log codificados por seus nomes de dados, usando a `TestDescription` de cada teste como chaves.

devoluções
	O conjunto de métricas recém-geradas de todas as métricas de teste.

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

Implemente esse método para gerar um conjunto de novas métricas a partir das métricas e logs existentes. Somente as métricas recém-geradas devem ser retornadas e com nome de chave exclusivo (nenhuma colisão com chaves existentes é permitida).

Parâmetros
`rawMetrics`	: o conjunto de métricas brutas disponíveis para a execução.
`runLogs`	: o conjunto de arquivos de log para a execução de teste.

devoluções
	O conjunto de métricas recém-geradas das métricas de execução.

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

Implemente este método para postar métricas de processo e logs de cada teste. Somente as métricas recém-geradas devem ser retornadas e com nome de chave exclusivo (nenhuma colisão com chaves existentes é permitida).

Parâmetros
`testDescription`	`TestDescription` : O objeto TestDescription que descreve o teste.
`testMetrics`	: o conjunto de métricas do teste.
`testLogs`	: O conjunto de arquivos registrados durante o teste.

devoluções
	O conjunto de métricas recém-geradas das métricas de teste.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Defina o ILogSaver para permitir que o implementador salve arquivos.

Parâmetros
`logSaver`	`ILogSaver` : o `ILogSaver`

configurar

public void setUp ()

Substitua esse método nos pós-processadores filho para inicializar antes da execução do teste.

testAssumptionFailure

public final 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

testAssumptionFailure

public final 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.

testeFinalizado

public final 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 medida precisa.

Parâmetros
`test`	`TestDescription` : identifica o teste
`endTime`	`long` : a hora em que o teste terminou, medido via `ERROR(/System#currentTimeMillis())`
`testMetrics`	: um `ERROR(/Map)` das métricas emitidas

testeFinalizado

public final void testEnded (TestDescription test, 
                 testMetrics)

Informa o fim da execução de um caso de teste individual.

Se testFailed(TestDescription, FailureDescription) não foi chamado, esse 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 final 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 final 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 final 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 final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Use este método para registrar um arquivo da implementação PostProcessor.

Parâmetros
`dataName`	`String` : um nome descritivo `ERROR(/String)` dos dados. por exemplo, "dispositivo_logcat". Observação 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.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Chamado quando o log de teste é salvo.

Deve ser usado no lugar de ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) .

Parâmetros
`dataName`	`String` : um nome descritivo `ERROR(/String)` dos dados. por exemplo, "dispositivo_logcat". Observação 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.
`logFile`	`LogFile` : o `LogFile` contendo os metadados do arquivo salvo.

testModuleEnded

public final void testModuleEnded ()

Informa o fim da execução de um módulo.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Informa o início da execução de um módulo. 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 suite.

Parâmetros
`moduleContext`	`IInvocationContext` : o `IInvocationContext` do módulo.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o fim 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 chave-valor relatados no final de uma execução de teste com `Metric` .

testRunFailed

public final void testRunFailed (FailureDescription failure)

A execução do teste de relatórios falhou devido a uma falha descrita por FailureDescription .

Parâmetros
`failure`	`FailureDescription` : `FailureDescription` descrevendo a falha e seu contexto.

testRunFailed

public final 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` : `ERROR(/String)` descrevendo o motivo da falha na execução.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Informa o início de uma execução de teste.

Parâmetros
`runName`	`String` : o nome da execução do 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 que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Callbacks de execução de teste

Parâmetros
`runName`	`String` : o nome da execução do teste
`testCount`	`int` : número total de testes na execução do teste

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Informa o início de uma execução de teste.

Parâmetros
`runName`	`String` : o nome da execução do 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 que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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 `ERROR(/System#currentTimeMillis())`

testRunStopped

public final 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

testStarted

public final 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 medição precisa .

Parâmetros
`test`	`TestDescription` : identifica o teste
`startTime`	`long` : a hora em que o teste começou, medido via `ERROR(/System#currentTimeMillis())`

testStarted

public final void testStarted (TestDescription test)

Retornos de chamada de casos de teste

Parâmetros
`test`	`TestDescription` : identifica o teste

Métodos protegidos

getMetricType

protected MetricMeasurement.DataType getMetricType ()

Substitua esse método para alterar o tipo de métrica, se necessário. Por padrão, a métrica é definida como tipo processado.

devoluções
`MetricMeasurement.DataType`

getRunName

protected String getRunName ()

devoluções
`String`