Esta página foi traduzida pela API Cloud Translation.

ShardListenerGenericName

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

Um ITestInvocationListener que coleta resultados de um estilhaço de invocação (também conhecido como uma divisão de invocação para executar em vários recursos em paralelo) e os encaminha para outro ouvinte.

Resumo

Construtores públicos
`ShardListener ( ITestInvocationListener main)` Crie um `ShardListener` .

Métodos públicos
	`getUnderlyingResultReporter ()`
`void`	`invocationEnded (long elapsedTime)` Informa que a chamada foi finalizada, 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 chamada de teste.
`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.
`void`	`setSupportGranularResults (boolean enableGranularResults)`
`boolean`	`supportGranularResults ()` Retorna True se o relator suportar resultados granulares, caso contrário, false.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornece o registro associado ou dados de depuração da chamada de teste.
`void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testModuleEnded ()` Informa o fim da execução de um módulo.
`void`	`testModuleStarted ( IInvocationContext moduleContext)` Informa o início da execução de um módulo.
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` Informa o fim da execução do teste.
`void`	`testRunFailed ( FailureDescription failure)` A execução do teste de relatórios falhou devido a uma falha descrita por `FailureDescription` .
`void`	`testRunFailed (String failureMessage)` A execução do teste de relatórios não foi concluída devido a um erro fatal.
`void`	`testRunStarted (String name, int numTests, int attemptNumber, long startTime)` Informa o início de uma execução de teste.

Construtores públicos

ShardListenerGenericName

public ShardListener (ITestInvocationListener main)

Crie um ShardListener .

Parâmetros
`main`	`ITestInvocationListener` : o `ITestInvocationListener` deve encaminhar os resultados. Para evitar colisões com outros `ShardListener` s, este objeto será sincronizado no `main` ao encaminhar os resultados. E os resultados serão enviados apenas quando o fragmento de invocação for concluído.

Métodos públicos

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

devoluções

invocaçãoEncerrada

public 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 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 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 void invocationStarted (IInvocationContext context)

Relata o início da chamada de teste.

Será chamado automaticamente pela estrutura 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

logAssociation

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

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parâmetros
`enableGranularResults`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Retorna True se o relator suportar resultados granulares, caso contrário, false.

devoluções
`boolean`

testLog

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

Fornece o registro associado ou dados de depuração da chamada 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 `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 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 fim da execução de um módulo.

testModuleStarted

public 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 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 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 void testRunFailed (String failureMessage)

A execução do teste de relatórios não foi concluída devido a um erro fatal.

Parâmetros
`failureMessage`	`String` : `ERROR(/String)` descrevendo o motivo da falha na execução.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

Parâmetros
`name`	`String` : o nome da execução do teste
`numTests`	`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())`