ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
   ↳ com.android.tradefed.result.ResultForwarder
     ↳ com.android.tradefed.invoker.ShardMainResultForwarder

Um ResultForwarder que combina os resultados de invocações de teste fragmentadas. Ele só informa a conclusão da invocação aos listeners depois que todas as invocações divididas são concluídas.

Esta classe não é segura para threads. Espera-se que os clientes travem nessa classe ao enviar resultados de teste para evitar que os callbacks de invocação sejam chamados fora de ordem.

Resumo

Construtores públicos

ShardMainResultForwarder( listeners, int expectedShards)

Crie um ShardMainResultForwarder.

Métodos públicos

getListeners()

Receba a lista de listeners.

void invocationEnded(long elapsedTime)

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

void invocationEnded(long elapsedTime, IInvocationContext context)

Callback mais detalhado para diferenciar qual fragmento foi concluído.

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

Informa que uma invocação foi pulada

void invocationStarted(IInvocationContext context)

Informa o início da invocação do teste.

void logAssociation(String dataName, LogFile logFile)

Em alguns casos, o registro precisa estar fortemente associado a casos de teste, mas não é possível fazer isso no callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto.

void testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)

Encaminha apenas o testLog, em vez de salvar o registro primeiro.

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

Chamado quando o registro de teste é salvo.

Construtores públicos

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

Crie um ShardMainResultForwarder.

Parâmetros
listeners : a lista de ITestInvocationListener para encaminhar resultados quando todos os fragmentos forem concluídos.
expectedShards int: o número de fragmentos

Métodos públicos

getListeners

public  getListeners ()

Receba a lista de listeners. Destinado apenas para uso por subclasses.

Retorna
A lista de ITestInvocationListeners.

invocationEnded

public void invocationEnded (long elapsedTime)

Informa que a invocação 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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Callback mais detalhado para diferenciar qual fragmento foi concluído.

Parâmetros
elapsedTime long

context IInvocationContext

invocationFailed

public void invocationFailed (FailureDescription failure)

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

Será chamado automaticamente pelo framework TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

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

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
cause Throwable: a causa Throwable da falha

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa que uma invocação foi pulada

Parâmetros
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Informa o início da invocação do teste.

Será chamado automaticamente pelo framework TradeFederation. Os repórteres precisam substituir esse método para oferecer suporte a 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 registro precisa estar fortemente associado a casos de teste, mas não é possível fazer isso no callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direto. Assim, esse callback permite fornecer uma associação forte explicitamente.

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

testLogForward

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

Encaminha apenas o testLog, em vez de salvar o registro primeiro.

Parâmetros
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

Chamado quando o registro de teste é salvo.

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

Parâmetros
dataName String: um nome descritivo String dos dados, por exemplo, "device_logcat". Observação O dataName pode não ser exclusivo por invocação. Ou seja, os implementadores precisam ser capazes de processar várias chamadas com o mesmo dataName.
dataType LogDataType: o LogDataType dos dados
dataStream InputStreamSource: o InputStreamSource dos dados. Os implementadores precisam chamar createInputStream para começar a ler os dados e garantir que o InputStream resultante seja fechado quando concluído.
logFile LogFile: o LogFile que contém os metadados do arquivo salvo.