IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

Sottoclassi indirette note Contesto di chiamata Contesto di chiamata Implementazione generica di un IInvocationContext.

---

Conserva le informazioni sulla chiamata per consentire l'accesso ai test, se necessario. I test non devono modificare il contesto qui contenuto quindi saranno disponibili solo i getter, ad eccezione degli attributi di contesto per la generazione di report.

Riepilogo

Costanti
String	INVOCATION_ID Chiave utilizzata per archiviare l'ID di chiamata associato.

Metodi pubblici
abstract void	addAllocatedDevice( deviceWithName) Monitora una mappa del nome del dispositivo di configurazione associato a ITestDevice.
abstract void	addAllocatedDevice(String deviceName, ITestDevice testDevice) Aggiungi un ITestDevice che verrà monitorato dai 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 di chiamata.
abstract void	addInvocationAttributes(MultiMap<String, String> attributesMap) Aggiungi più attributi di chiamata contemporaneamente tramite un UniqueMultiMap.
default void	addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis) Aggiungi una metrica di tempistica di chiamata.
abstract void	addSerialsFromShard(Integer index, serials) Aggiungi un numero seriale da tracciare come assegnato a uno degli shard che eseguono alcuni test.
default String	getAttribute(String key) Un metodo pratico per recuperare l'attributo contesto di chiamata come singola coppia chiave-valore.
abstract MultiMap<String, String>	getAttributes() Restituisce una copia della mappa contenente tutti gli attributi di chiamata.
abstract IBuildInfo	getBuildInfo(String deviceName) Restituisci il valore IBuildInfo associato al nome della configurazione del dispositivo fornito.
abstract IBuildInfo	getBuildInfo(ITestDevice testDevice) Restituisce il valore IBuildInfo associato a ITestDevice
abstract String	getBuildInfoName(IBuildInfo info) Restituisce il nome del set di dispositivi nella configurazione XML da IBuildInfo.
abstract	getBuildInfos() Restituisci 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 il valore ITestDevice associato al nome della configurazione del dispositivo fornito.
abstract	getDeviceBuildMap() Restituire la mappa dell'associazione informazioni dispositivo/costruzione
abstract ITestDevice	getDeviceBySerial(String serial) Restituisce il valore ITestDevice associato al numero di serie fornito.
abstract	getDeviceConfigNames() Restituisce l'elenco di nomi di configurazione del dispositivo monitorato in questa chiamata
abstract String	getDeviceName(ITestDevice device) Restituisce il nome del set di dispositivi nella configurazione XML da ITestDevice.
abstract	getDevices() Restituisce tutti i dispositivi allocati tracciati per questa chiamata.
abstract String	getInvocationId()
default	getInvocationTimingMetrics() Restituisce la mappa contenente le metriche dei tempi di chiamata.
abstract IInvocationContext	getModuleInvocationContext() Restituisce il contesto di chiamata del modulo durante l'esecuzione come parte di una suite.
abstract int	getNumDevicesAllocated() Restituisce il numero di dispositivi assegnati per la chiamata.
abstract	getSerials() Restituisce l'elenco di serie del dispositivo monitorato in questa chiamata
abstract	getShardsSerials() Restituisce la mappa di tutti i serial monitorati e del relativo shard coinvolto nello sharding.
abstract String	getTestTag() Restituisce il tag di prova delle chiamate.
abstract void	markReleasedEarly() Segnali in anticipo che i dispositivi verranno rilasciati.
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 chiamata del modulo durante l'esecuzione come parte di una suite.
abstract void	setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode) Imposta il valore RecoveryMode di tutti i dispositivi nel contesto
abstract void	setTestTag(String testTag) Imposta il tag di test delle chiamate.
abstract InvocationContext.Context	toProto() Serializza un'istanza di contesto in un protobuf.
abstract boolean	wasReleasedEarly() Indica se i dispositivi sono stati rilasciati in anticipo e non verranno più utilizzati.

Costanti

ID_INVOCAZIONE

public static final String INVOCATION_ID

Chiave utilizzata per archiviare l'ID di chiamata associato.

Valore costante: "ID chiamata"

Metodi pubblici

aggiungiDispositivo Allocato

public abstract void addAllocatedDevice ( deviceWithName)

Monitora una mappa del nome del dispositivo di configurazione associato a ITestDevice. Non si cancella il monitoraggio precedente prima di aggiungerlo.

Parametri
deviceWithName	: il ERROR(/Map) del dispositivo aggiuntivo da monitorare

aggiungiDispositivo Allocato

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Aggiungi un ITestDevice che verrà monitorato dai metadati quando il dispositivo viene allocato. le informazioni sulla build verranno impostate 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 valore IBuildInfo associato al nome della configurazione del dispositivo.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo di chiamata.

Parametri
attributeName	String
attributeValue	String

addInvocationAttribute

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

Aggiungi più attributi di chiamata contemporaneamente tramite un UniqueMultiMap.

Parametri
attributesMap	MultiMap

addInvocationTimingMetric

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

Aggiungi una metrica di tempistica di chiamata.

Parametri
timingEvent	IInvocationContext.TimingEvent
durationMillis	Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

Aggiungi un numero seriale da tracciare come assegnato a uno degli shard che eseguono alcuni test.

Parametri
index	Integer: l'indice dello shard utilizzando i numeri seriali
serials	: l'elenco di serie da monitorare.

getAttribute

public String getAttribute (String key)

Un metodo pratico per recuperare l'attributo contesto di chiamata come singola coppia chiave-valore. Non restituire mai null.

Parametri
key	String

Ritorni
String	stringa vuota quando la chiave non esiste, altrimenti il valore.

getAttribute

public abstract MultiMap<String, String> getAttributes ()

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

Ritorni
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Restituisci il valore IBuildInfo associato al nome della configurazione del dispositivo fornito. Resi nullo, se non è possibile trovare deviceName.

Parametri
deviceName	String

Ritorni
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Restituisce il valore IBuildInfo associato a ITestDevice

Parametri
testDevice	ITestDevice

Ritorni
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

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

Parametri
info	IBuildInfo

Ritorni
String

getBuildInfo

public abstract  getBuildInfos ()

Restituisci tutti i IBuildInfo monitorati per questa chiamata.

Ritorni

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

Ritorni
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Restituisci il valore ITestDevice associato al nome della configurazione del dispositivo fornito.

Parametri
deviceName	String

Ritorni
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Restituire la mappa dell'associazione informazioni dispositivo/costruzione

Ritorni

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Restituisce il valore ITestDevice associato al numero di serie fornito. Evita di usarlo troppo perché non si tratta della ricerca più veloce.

Parametri
serial	String

Ritorni
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

Restituisce l'elenco di nomi di configurazione del dispositivo monitorato in questa chiamata

Ritorni

getDeviceName

public abstract String getDeviceName (ITestDevice device)

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

Parametri
device	ITestDevice

Ritorni
String

getDispositivi

public abstract  getDevices ()

Restituisce tutti i dispositivi allocati tracciati per questa chiamata.

Ritorni

getInvocationId

public abstract String getInvocationId ()

Ritorni
String	ID chiamata associato o null se non è collegato a una chiamata

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

Restituisce la mappa contenente le metriche dei tempi di chiamata.

Ritorni

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Restituisce il contesto di chiamata del modulo durante l'esecuzione come parte di una suite.

Ritorni
IInvocationContext

getNumDevicesAllocati

public abstract int getNumDevicesAllocated ()

Restituisce il numero di dispositivi assegnati per la chiamata.

Ritorni
int

getSerials

public abstract  getSerials ()

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

Ritorni

getShardsSerials

public abstract  getShardsSerials ()

Restituisce la mappa di tutti i serial monitorati e del relativo shard coinvolto nello sharding. Vuoto se non è con sharding.

Ritorni

getTestTag

public abstract String getTestTag ()

Restituisce il tag di prova delle chiamate.

Ritorni
String

markReleasedEarly

public abstract void markReleasedEarly ()

Segnali in anticipo che i dispositivi verranno rilasciati.

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 chiamata del modulo durante l'esecuzione come parte di una suite.

Parametri
invocationContext	IInvocationContext

setRecoveryModePerTutti i dispositivi

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Imposta il valore RecoveryMode di tutti i dispositivi nel contesto

Parametri
mode	ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Imposta il tag di test delle chiamate.

Parametri
testTag	String

toProto

public abstract InvocationContext.Context toProto ()

Serializza un'istanza di contesto in un protobuf.

Ritorni
InvocationContext.Context

èstatoRilasciatoIn anticipo

public abstract boolean wasReleasedEarly ()

Indica se i dispositivi sono stati rilasciati in anticipo e non verranno più utilizzati.

Ritorni
boolean