IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

Contiene informazioni sull'invocazione a cui i test devono accedere, se necessario. I test non devono modificare il contesto contenuto qui, pertanto saranno disponibili solo i metodi getter, ad eccezione degli attributi di contesto a scopo di reporting.

Riepilogo

Costanti

String INVOCATION_ID

Chiave utilizzata per archiviare l'ID invocazione associato.

Metodi pubblici

abstract void addAllocatedDevice(Map<String, ITestDevice> deviceWithName)

Tieni traccia di una mappa del nome del dispositivo di configurazione associato a un ITestDevice.

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

Aggiungi un ITestDevice da monitorare in base ai metadati quando il dispositivo viene allocato.

abstract void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

Aggiungi un IBuildInfo da monitorare con il nome della configurazione del dispositivo.

abstract void addInvocationAttribute(String attributeName, String attributeValue)

Aggiungi un attributo Invocation.

abstract void addInvocationAttributes(MultiMap<String, String> attributesMap)

Aggiungi più attributi di invocazione contemporaneamente tramite un UniqueMultiMap.

default void addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)

Aggiungi una metrica di temporizzazione dell'invocazione.

abstract void addSerialsFromShard(Integer index, List<String> serials)

Aggiungi un numero di serie da monitorare come assegnato a uno degli shard che esegue alcuni test.

default String getAttribute(String key)

Un metodo pratico per recuperare l'attributo del contesto di invocazione come singola coppia chiave-valore.

abstract MultiMap<String, String> getAttributes()

Restituisce una copia della mappa contenente tutti gli attributi di invocazione.

abstract IBuildInfo getBuildInfo(String deviceName)

Restituisci IBuildInfo associato al nome della configurazione del dispositivo fornito.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

Restituisci IBuildInfo associato a ITestDevice

abstract String getBuildInfoName(IBuildInfo info)

Restituisce il nome del gruppo di dispositivi nella configurazione XML da IBuildInfo.

abstract List<IBuildInfo> getBuildInfos()

Restituisce tutti i IBuildInfo monitorati per questa chiamata.

abstract ConfigurationDescriptor getConfigurationDescriptor()

Restituisce il descrittore associato alla configurazione di test che ha avviato la chiamata

abstract ITestDevice getDevice(String deviceName)

Restituisci ITestDevice associato al nome della configurazione del dispositivo fornito.

abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

Restituisce la mappa dell'associazione tra dispositivo e informazioni sulla build

abstract ITestDevice getDeviceBySerial(String serial)

Restituisce il ITestDevice associato al numero di serie fornito.

abstract List<String> getDeviceConfigNames()

Restituisce l'elenco dei nomi delle configurazioni del dispositivo monitorato in questa chiamata

abstract String getDeviceName(ITestDevice device)

Restituisce il nome del gruppo di dispositivi nella configurazione XML da ITestDevice.

abstract List<ITestDevice> getDevices()

Restituisce tutti i dispositivi monitorati allocati per questa chiamata.

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

Restituisce la mappa contenente le metriche di temporizzazione delle chiamate.

abstract IInvocationContext getModuleInvocationContext()

Restituisce il contesto di invocazione del modulo durante l'esecuzione nell'ambito di una suite.

abstract int getNumDevicesAllocated()

Restituisce il numero di dispositivi allocati per l'invocazione.

abstract List<String> getSerials()

Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata

abstract Map<Integer, List<String>> getShardsSerials()

Restituisce la mappa di tutti i numeri di serie monitorati e del relativo shard coinvolto nello sharding.

abstract String getTestTag()

Restituisce il tag di test di chiamata.

abstract void markReleasedEarly()

Contrassegna i dispositivi come rilasciati in anticipo.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

Imposta il descrittore associato alla configurazione di test che ha avviato la chiamata

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

Imposta il contesto di invocazione del modulo durante l'esecuzione nell'ambito di una suite.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

Imposta il RecoveryMode di tutti i dispositivi che fanno parte del contesto

abstract void setTestTag(String testTag)

Imposta il test-tag di invocazione.

abstract InvocationContext.Context toProto()

Serializza un'istanza di contesto in un protobuf.

abstract boolean wasReleasedEarly()

Restituisce un valore che indica se i dispositivi sono stati rilasciati in anticipo e non verranno più utilizzati.

Costanti

INVOCATION_ID

public static final String INVOCATION_ID

Chiave utilizzata per archiviare l'ID invocazione associato.

Valore costante: "invocation-id"

Metodi pubblici

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

Tieni traccia di una mappa del nome del dispositivo di configurazione associato a un ITestDevice. Non cancella il monitoraggio precedente prima dell'aggiunta.

Parametri
deviceWithName Map: l'Map del dispositivo aggiuntivo da monitorare

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Aggiungi un ITestDevice da monitorare in base ai metadati quando il dispositivo viene allocato. imposterà le informazioni sulla build su null nella mappa.

Parametri
deviceName String: il nome della configurazione del dispositivo da associare a ITestDevice
testDevice ITestDevice: da aggiungere ai dispositivi allocati.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

Aggiungi un IBuildInfo da monitorare con il nome della configurazione del dispositivo.

Parametri
deviceName String: il nome della configurazione del dispositivo
buildinfo IBuildInfo: un IBuildInfo associato al nome della configurazione del dispositivo.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo Invocation.

Parametri
attributeName String

attributeValue String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

Aggiungi più attributi di invocazione contemporaneamente tramite un UniqueMultiMap.

Parametri
attributesMap MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

Aggiungi una metrica di temporizzazione dell'invocazione.

Parametri
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                List<String> serials)

Aggiungi un numero di serie da monitorare come assegnato a uno degli shard che esegue alcuni test.

Parametri
index Integer: l'indice dello shard che utilizza i numeri di serie
serials List: l'elenco dei numeri di serie da monitorare.

getAttribute

public String getAttribute (String key)

Un metodo pratico per recuperare l'attributo del contesto di invocazione come singola coppia chiave-valore. Non restituisce mai un valore nullo.

Parametri
key String

Resi
String stringa vuota se la chiave non esiste, altrimenti il valore.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

Restituisce una copia della mappa contenente tutti gli attributi di invocazione.

Resi
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Restituisci IBuildInfo associato al nome della configurazione del dispositivo fornito. Restituisce null se non è possibile trovare una corrispondenza per deviceName.

Parametri
deviceName String

Resi
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Restituisci IBuildInfo associato a ITestDevice

Parametri
testDevice ITestDevice

Resi
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Restituisce il nome del gruppo di dispositivi nella configurazione XML da IBuildInfo. Restituisce null se non è possibile trovare una corrispondenza per IBuildInfo

Parametri
info IBuildInfo

Resi
String

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Restituisce tutti i IBuildInfo monitorati per questa chiamata.

Resi
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Restituisce il descrittore associato alla configurazione di test che ha avviato la chiamata

Resi
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Restituisci ITestDevice associato al nome della configurazione del dispositivo fornito.

Parametri
deviceName String

Resi
ITestDevice

getDeviceBuildMap

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

Restituisce la mappa dell'associazione tra dispositivo e informazioni sulla build

Resi
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Restituisce il ITestDevice associato al numero di serie fornito. Evita di utilizzarne troppi, in quanto non è la ricerca più veloce.

Parametri
serial String

Resi
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

Restituisce l'elenco dei nomi delle configurazioni del dispositivo monitorato in questa chiamata

Resi
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

Restituisce il nome del gruppo di dispositivi nella configurazione XML da ITestDevice. Restituisce null se non è possibile trovare una corrispondenza per ITestDevice.

Parametri
device ITestDevice

Resi
String

getDevices

public abstract List<ITestDevice> getDevices ()

Restituisce tutti i dispositivi monitorati allocati per questa chiamata.

Resi
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

Resi
String ID invocazione associato o null se non collegato a un'invocazione

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

Restituisce la mappa contenente le metriche di temporizzazione delle chiamate.

Resi
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Restituisce il contesto di invocazione del modulo durante l'esecuzione nell'ambito di una suite.

Resi
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

Restituisce il numero di dispositivi allocati per l'invocazione.

Resi
int

getSerials

public abstract List<String> getSerials ()

Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata

Resi
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

Restituisce la mappa di tutti i numeri di serie monitorati e del relativo shard coinvolto nello sharding. Vuoto se non si tratta di una chiamata con partizionamento.

Resi
Map<Integer, List<String>>

getTestTag

public abstract String getTestTag ()

Restituisce il tag di test di chiamata.

Resi
String

markReleasedEarly

public abstract void markReleasedEarly ()

Contrassegna i dispositivi come rilasciati in anticipo.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Imposta il descrittore associato alla configurazione di test che ha avviato la chiamata

Parametri
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Imposta il contesto di invocazione del modulo durante l'esecuzione nell'ambito di una suite.

Parametri
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Imposta il RecoveryMode di tutti i dispositivi che fanno parte del contesto

Parametri
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Imposta il test-tag di invocazione.

Parametri
testTag String

toProto

public abstract InvocationContext.Context toProto ()

Serializza un'istanza di contesto in un protobuf.

Resi
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Restituisce un valore che indica se i dispositivi sono stati rilasciati in anticipo e non verranno più utilizzati.

Resi
boolean