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 |
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 |
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 |
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' |
abstract IBuildInfo | getBuildInfo ( ITestDevice testDevice) Restituisce l' |
abstract String | getBuildInfoName ( IBuildInfo info) Restituisce il nome del dispositivo impostato nella configurazione xml da |
abstract | getBuildInfos () Restituisce tutto l' |
abstract ConfigurationDescriptor | getConfigurationDescriptor () Restituisce il descrittore associato alla configurazione di test che ha avviato l'invocazione |
abstract ITestDevice | getDevice (String deviceName) Restituisce l' |
abstract | getDeviceBuildMap () Restituisce la mappa dell'associazione delle informazioni sul dispositivo/build |
abstract ITestDevice | getDeviceBySerial (String serial) Restituisce l' |
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 |
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 |
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 | 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 |
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 abstractgetBuildInfos ()
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 abstractgetDeviceBuildMap ()
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 abstractgetDeviceConfigNames ()
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 abstractgetDevices ()
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
publicgetInvocationTimingMetrics ()
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 abstractgetSerials ()
Restituisce l'elenco dei seriali del dispositivo tracciato in questa invocazione
ritorna | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
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 |