Contesto di invocazione

public interface IInvocationContext

com.android.tradefed.invoker.IInvocationContext


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

Riepilogo

Costanti

String INVOCATION_ID

Chiave utilizzata per archiviare l'ID di invocazione associato.

Metodi pubblici

abstract void addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName)

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

abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)

Aggiungi un ITestDevice di cui tenere traccia tramite i 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 invocazione.

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

Aggiungi diversi attributi di invocazione contemporaneamente tramite UniqueMultiMap .

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

Aggiungi una metrica relativa ai tempi di invocazione.

abstract void addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials)

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

default String getAttribute (String key)

Un metodo conveniente per recuperare l'attributo del contesto di chiamata come una 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)

Restituisce l' IBuildInfo associato al nome di configurazione del dispositivo fornito.

abstract IBuildInfo getBuildInfo ( ITestDevice testDevice)

Restituisce l' IBuildInfo associato a ITestDevice

abstract String getBuildInfoName ( IBuildInfo info)

Restituisce il nome del dispositivo impostato nella configurazione xml da IBuildInfo .

abstract getBuildInfos ()

Restituisce tutto l' IBuildInfo tracciato per questa chiamata.

abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

abstract ITestDevice getDevice (String deviceName)

Restituisce l' ITestDevice associato al nome di configurazione del dispositivo fornito.

abstract getDeviceBuildMap ()

Restituisce la mappa dell'associazione delle informazioni sul dispositivo/build

abstract ITestDevice getDeviceBySerial (String serial)

Restituisce l' ITestDevice associato al seriale fornito.

abstract getDeviceConfigNames ()

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

abstract String getDeviceName ( ITestDevice device)

Restituisce il nome del dispositivo impostato nella configurazione xml da ITestDevice .

abstract getDevices ()

Restituisce tutto il dispositivo allocato tracciato per questa chiamata.

abstract String getInvocationId ()
default getInvocationTimingMetrics ()

Restituisce la mappa contenente le metriche relative ai tempi di invocazione.

abstract IInvocationContext getModuleInvocationContext ()

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

abstract int getNumDevicesAllocated ()

Restituisce il numero di dispositivi allocati per l'invocazione.

abstract getSerials ()

Restituisce l'elenco dei seriali del dispositivo tracciato in questa invocazione

abstract getShardsSerials ()

Restituisce la mappa di tutti i seriali tracciati e il relativo frammento coinvolto nello sharding.

abstract String getTestTag ()

Restituisce il tag test di invocazione.

abstract void markReleasedEarly ()

Segna che i dispositivi verranno rilasciati in anticipo.

abstract void setConfigurationDescriptor ( ConfigurationDescriptor configurationDescriptor)

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

abstract void setModuleInvocationContext ( IInvocationContext invocationContext)

Imposta il contesto di invocazione del modulo durante l'esecuzione come parte di una suite.

abstract void setRecoveryModeForAllDevices ( ITestDevice.RecoveryMode mode)

Imposta il RecoveryMode di tutti i dispositivi facenti parte del contesto

abstract void setTestTag (String testTag)

Imposta il tag test di invocazione.

abstract InvocationContext.Context toProto ()

Serializza un'istanza del contesto in un protobuf.

abstract boolean wasReleasedEarly ()

Restituisce 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 di invocazione associato.

Valore costante: "id-invocazione"

Metodi pubblici

addAllocatedDevice

public abstract void addAllocatedDevice ( deviceWithName)

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

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

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

Aggiungi un ITestDevice di cui tenere traccia tramite i 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 di configurazione del dispositivo.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

Aggiungi un attributo di invocazione.

Parametri
attributeName String

attributeValue String

aggiungiAttributi di invocazione

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

Aggiungi diversi attributi di invocazione contemporaneamente tramite UniqueMultiMap .

Parametri
attributesMap MultiMap

addInvocationTimingMetric

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

Aggiungi una metrica relativa ai tempi di invocazione.

Parametri
timingEvent IInvocationContext.TimingEvent

durationMillis Long

aggiungiSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                 serials)

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

Parametri
index Integer : l'indice del frammento utilizzando i seriali

serials : L'elenco dei periodici da monitorare.

getAttribute

public String getAttribute (String key)

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

Parametri
key String

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

getAttributi

public abstract MultiMap<String, String> getAttributes ()

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

ritorna
MultiMap <String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

Restituisce l' IBuildInfo associato al nome di configurazione del dispositivo fornito. Restituisce null, se non è possibile far corrispondere il nomedispositivo.

Parametri
deviceName String

ritorna
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

Restituisce l' IBuildInfo associato a ITestDevice

Parametri
testDevice ITestDevice

ritorna
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

Restituisce il nome del dispositivo impostato nella configurazione xml da IBuildInfo . Restituisce null se non è possibile far corrispondere IBuildInfo

Parametri
info IBuildInfo

ritorna
String

getBuildInfos

public abstract  getBuildInfos ()

Restituisce tutto l' IBuildInfo tracciato per questa chiamata.

ritorna

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

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

ritorna
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

Restituisce l' ITestDevice associato al nome di configurazione del dispositivo fornito.

Parametri
deviceName String

ritorna
ITestDevice

getDeviceBuildMap

public abstract  getDeviceBuildMap ()

Restituisce la mappa dell'associazione delle informazioni sul dispositivo/build

ritorna

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

Restituisce l' ITestDevice associato al seriale fornito. Astenersi dall'usarne troppi perché non è la ricerca più veloce.

Parametri
serial String

ritorna
ITestDevice

getDeviceConfigNames

public abstract  getDeviceConfigNames ()

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

ritorna

getNomeDispositivo

public abstract String getDeviceName (ITestDevice device)

Restituisce il nome del dispositivo impostato nella configurazione xml da ITestDevice . Restituisce null se non è possibile far corrispondere ITestDevice.

Parametri
device ITestDevice

ritorna
String

getDevices

public abstract  getDevices ()

Restituisce tutto il dispositivo allocato tracciato per questa chiamata.

ritorna

getInvocationId

public abstract String getInvocationId ()

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

getInvocationTimingMetrics

public  getInvocationTimingMetrics ()

Restituisce la mappa contenente le metriche relative ai tempi di invocazione.

ritorna

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

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

ritorna
IInvocationContext

getNumDispositiviAllocatati

public abstract int getNumDevicesAllocated ()

Restituisce il numero di dispositivi allocati per l'invocazione.

ritorna
int

getSerials

public abstract  getSerials ()

Restituisce l'elenco dei seriali del dispositivo tracciato in questa invocazione

ritorna

getShardsSerials

public abstract  getShardsSerials ()

Restituisce la mappa di tutti i seriali tracciati e il relativo frammento coinvolto nello sharding. Vuoto se non un'invocazione frammentata.

ritorna

getTestTag

public abstract String getTestTag ()

Restituisce il tag test di invocazione.

ritorna
String

markRilasciato in anticipo

public abstract void markReleasedEarly ()

Segna che i dispositivi verranno rilasciati in anticipo.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

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

Parametri
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

Imposta il contesto di invocazione del modulo durante l'esecuzione come parte di una suite.

Parametri
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

Imposta il RecoveryMode di tutti i dispositivi facenti parte del contesto

Parametri
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

Imposta il tag test di invocazione.

Parametri
testTag String

aProto

public abstract InvocationContext.Context toProto ()

Serializza un'istanza del contesto in un protobuf.

ritorna
InvocationContext.Context

è stato rilasciato presto

public abstract boolean wasReleasedEarly ()

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

ritorna
boolean