IInvocationContext

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext

Classi di sottoclasse indirette note InvocationContext InvocationContext Implementazione generica di un IInvocationContext.

---

Contiene informazioni sull'invocazione a cui i test possono accedere, se necessario. I test non devono modificare il contesto contenuto qui, pertanto saranno disponibili solo i getter, ad eccezione degli attributi del contesto per la generazione di report.

Riepilogo

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

Metodi pubblici
abstract void	addAllocatedDevice( deviceWithName) Monitora una mappa del nome del dispositivo di configurazione associato a un ITestDevice.
abstract void	addAllocatedDevice(String deviceName, ITestDevice testDevice) Aggiungi un ITestDevice da monitorare 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 Invocation.
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 relativa ai tempi di chiamata.
abstract void	addSerialsFromShard(Integer index, serials) Aggiungi un numero di serie da monitorare come assegnato a uno dei frammenti che eseguono alcuni test.
default String	getAttribute(String key) Un metodo pratico per recuperare l'attributo del 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) Restituisce il IBuildInfo associato al nome della configurazione del dispositivo fornito.
abstract IBuildInfo	getBuildInfo(ITestDevice testDevice) Restituisce il IBuildInfo associato al ITestDevice
abstract String	getBuildInfoName(IBuildInfo info) Restituisce il nome del gruppo di dispositivi nella configurazione XML da IBuildInfo.
abstract	getBuildInfos() Restituisce tutti i IBuildInfo monitorati per questa chiamata.
abstract ConfigurationDescriptor	getConfigurationDescriptor() Restituisce il descrittore associato alla configurazione del test che ha avviato l'invocazione
abstract ITestDevice	getDevice(String deviceName) Restituisce il ITestDevice associato al nome della configurazione del dispositivo fornito.
abstract	getDeviceBuildMap() Restituisce la mappa dell'associazione delle informazioni del dispositivo/della build
abstract ITestDevice	getDeviceBySerial(String serial) Restituisce il ITestDevice associato al numero di serie fornito.
abstract	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 impostato nella configurazione XML da ITestDevice.
abstract	getDevices() Restituisce tutti i dispositivi allocati monitorati per questa chiamata.
abstract String	getInvocationId()
default	getInvocationTimingMetrics() Restituisce la mappa contenente le metriche relative ai tempi di chiamata.
abstract IInvocationContext	getModuleInvocationContext() Restituisce il contesto di chiamata del modulo durante l'esecuzione all'interno di una suite.
abstract int	getNumDevicesAllocated() Restituisce il numero di dispositivi allocati per l'invocazione.
abstract	getSerials() Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata
abstract	getShardsSerials() Restituisce la mappa di tutte le serie monitorate e dei relativi shard coinvolti nello sharding.
abstract String	getTestTag() Restituisce il tag test di chiamata.
abstract void	markReleasedEarly() Contrassegna i dispositivi che verranno rilasciati in anteprima.
abstract void	setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor) Imposta il descrittore associato alla configurazione del test che ha avviato l'invocazione
abstract void	setModuleInvocationContext(IInvocationContext invocationContext) Imposta il contesto di chiamata del modulo durante l'esecuzione all'interno 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 tag di test dell'invocazione.
abstract InvocationContext.Context	toProto() Serializza l'istanza di contesto in un protobuf.
abstract boolean	wasReleasedEarly() Restituisce se i dispositivi sono stati rilasciati in anteprima e non verranno più utilizzati.

Costanti

INVOCATION_ID

public static final String INVOCATION_ID

Chiave utilizzata per memorizzare l'ID chiamata associato.

Valore costante: "invocation-id"

Metodi pubblici

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

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

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

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Aggiungi un ITestDevice da monitorare dai metadati quando il dispositivo viene allocato. imposterà le informazioni sulla compilazione 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 chiamata contemporaneamente tramite un UniqueMultiMap.

Parametri
attributesMap	MultiMap

addInvocationTimingMetric

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

Aggiungi una metrica relativa ai tempi di chiamata.

Parametri
timingEvent	IInvocationContext.TimingEvent
durationMillis	Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

Aggiungi un numero di serie da monitorare come assegnato a uno dei frammenti che eseguono alcuni test.

Parametri
index	Integer: l'indice del frammento che utilizza i seriali
serials	: l'elenco dei numeri di serie da monitorare.

getAttribute

public String getAttribute (String key)

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

Parametri
key	String

Ritorni
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 chiamata.

Ritorni
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

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

Parametri
deviceName	String

Ritorni
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Restituisce il IBuildInfo associato al ITestDevice

Parametri
testDevice	ITestDevice

Ritorni
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

Ritorni
String

getBuildInfos

public abstract  getBuildInfos ()

Restituisce tutti i IBuildInfo monitorati per questa chiamata.

Ritorni

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

Restituisce il descrittore associato alla configurazione del test che ha avviato l'invocazione

Ritorni
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Restituisce il ITestDevice associato al nome della configurazione del dispositivo fornito.

Parametri
deviceName	String

Ritorni
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Restituisce la mappa dell'associazione delle informazioni del dispositivo/della build

Ritorni

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Restituisce il ITestDevice associato al numero di serie fornito. Evita di utilizzarlo troppo, perché non è la ricerca più rapida.

Parametri
serial	String

Ritorni
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

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

Ritorni

getDeviceName

public abstract String getDeviceName (ITestDevice device)

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

Parametri
device	ITestDevice

Ritorni
String

getDevices

public abstract  getDevices ()

Restituisce tutti i dispositivi allocati monitorati 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 relative ai tempi di chiamata.

Ritorni

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

Restituisce il contesto di chiamata del modulo durante l'esecuzione all'interno di una suite.

Ritorni
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

Restituisce il numero di dispositivi allocati per l'invocazione.

Ritorni
int

getSerials

public abstract  getSerials ()

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

Ritorni

getShardsSerials

public abstract  getShardsSerials ()

Restituisce la mappa di tutte le serie monitorate e dei relativi shard coinvolti nello sharding. Vuoto se non si tratta di una chiamata suddivisa in parti.

Ritorni

getTestTag

public abstract String getTestTag ()

Restituisce il tag test di chiamata.

Ritorni
String

markReleasedEarly

public abstract void markReleasedEarly ()

Contrassegna i dispositivi che verranno rilasciati in anteprima.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

Imposta il descrittore associato alla configurazione del test che ha avviato l'invocazione

Parametri
configurationDescriptor	ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Imposta il contesto di chiamata del modulo durante l'esecuzione all'interno 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 tag di test dell'invocazione.

Parametri
testTag	String

toProto

public abstract InvocationContext.Context toProto ()

Serializza l'istanza di contesto in un protobuf.

Ritorni
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

Restituisce se i dispositivi sono stati rilasciati in anteprima e non verranno più utilizzati.

Ritorni
boolean