IIInvocationContext
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 del contesto a scopo di reporting.
Riepilogo
Costanti | |
---|---|
String | INVOCATION_ID Chiave utilizzata per archiviare l'ID di chiamata associato. |
Metodi pubblici | |
---|---|
abstract void | addAllocatedDevice ( deviceWithName) addAllocatedDevice ( deviceWithName) Traccia una mappa del nome del dispositivo di configurazione associato a un |
abstract void | addAllocatedDevice (String deviceName, ITestDevice testDevice) Aggiungere un ITestDevice da tenere traccia dei metadati quando il dispositivo viene allocato. |
abstract void | addDeviceBuildInfo (String deviceName, IBuildInfo buildinfo) Aggiungere un |
abstract void | addInvocationAttribute (String attributeName, String attributeValue) Aggiungi un attributo Invocazione. |
abstract void | addInvocationAttributes ( MultiMap <String, String> attributesMap) Aggiungi diversi attributi di chiamata contemporaneamente tramite un |
default void | addInvocationTimingMetric ( IInvocationContext.TimingEvent timingEvent, Long durationMillis) Aggiungi una metrica di temporizzazione delle chiamate. |
abstract void | addSerialsFromShard (Integer index, serials) addSerialsFromShard (Integer index, serials) Aggiungi un seriale da tracciare come assegnato a uno degli shard che esegue 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 chiamata. |
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 la chiamata |
abstract ITestDevice | getDevice (String deviceName) Restituisce l' |
abstract | getDeviceBuildMap () Restituisce la mappa dell'associazione di informazioni dispositivo/build |
abstract ITestDevice | getDeviceBySerial (String serial) Restituisce l' |
abstract | getDeviceConfigNames () Restituisce l'elenco dei nomi di configurazione del dispositivo del dispositivo monitorato in questa chiamata |
abstract String | getDeviceName ( ITestDevice device) Restituisce il nome del dispositivo impostato nella configurazione xml da |
abstract | getDevices () Restituisci tutti i dispositivi allocati monitorati 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 allocati per la chiamata. |
abstract | getSerials () Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata |
abstract | getShardsSerials () Restituisce la mappa di tutti i serial tracciati e il relativo frammento coinvolto nello sharding. |
abstract String | getTestTag () Restituisce l'invocazione test-tag. |
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 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 |
abstract void | setTestTag (String testTag) Imposta il test-tag di chiamata. |
abstract InvocationContext.Context | toProto () Serializza un'istanza di 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 chiamata associato.
Valore costante: "invocation-id"
Metodi pubblici
addAllocatedDevice
public abstract void addAllocatedDevice (deviceWithName)
Traccia una mappa del nome del dispositivo di configurazione associato a un ITestDevice
. Non cancella il tracciamento precedente prima dell'aggiunta.
Parametri | |
---|---|
deviceWithName | ERROR(/Map) del dispositivo aggiuntivo da tracciare |
addAllocatedDevice
public abstract void addAllocatedDevice (String deviceName, ITestDevice testDevice)
Aggiungere un ITestDevice da tenere traccia dei 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)
Aggiungere un IBuildInfo
da tenere traccia 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 Invocazione.
Parametri | |
---|---|
attributeName | String |
attributeValue | String |
addInvocationAttributes
public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)
Aggiungi diversi attributi di chiamata contemporaneamente tramite un UniqueMultiMap
.
Parametri | |
---|---|
attributesMap | MultiMap |
addInvocationTimingMetric
public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, Long durationMillis)
Aggiungi una metrica di temporizzazione delle chiamate.
Parametri | |
---|---|
timingEvent | IInvocationContext.TimingEvent |
durationMillis | Long |
addSerialsFromShard
public abstract void addSerialsFromShard (Integer index,serials)
Aggiungi un seriale da tracciare come assegnato a uno degli shard che esegue alcuni test.
Parametri | |
---|---|
index | Integer : l'indice dello shard che utilizza 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, altrimenti il valore. |
getAttributes
public abstract MultiMap<String, String> getAttributes ()
Restituisce una copia della mappa contenente tutti gli attributi di chiamata.
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 trovare una corrispondenza per deviceName.
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 trovare una corrispondenza per IBuildInfo
Parametri | |
---|---|
info | IBuildInfo |
ritorna | |
---|---|
String |
getBuildInfos
public abstractgetBuildInfos ()
Restituisce tutto l' IBuildInfo
rilevato per questa chiamata.
ritorna | |
---|---|
getConfigurationDescriptor
public abstract ConfigurationDescriptor getConfigurationDescriptor ()
Restituisce il descrittore associato alla configurazione di test che ha avviato la chiamata
ritorna | |
---|---|
ConfigurationDescriptor |
getDispositivo
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 di informazioni dispositivo/build
ritorna | |
---|---|
getDeviceBySerial
public abstract ITestDevice getDeviceBySerial (String serial)
Restituisce l' ITestDevice
associato al seriale fornito. Evita di usarne troppo perché non è la ricerca più veloce.
Parametri | |
---|---|
serial | String |
ritorna | |
---|---|
ITestDevice |
getDeviceConfigNames
public abstractgetDeviceConfigNames ()
Restituisce l'elenco dei nomi di configurazione del dispositivo del dispositivo monitorato 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 trovare una corrispondenza con ITestDevice.
Parametri | |
---|---|
device | ITestDevice |
ritorna | |
---|---|
String |
getDevices
public abstractgetDevices ()
Restituisci tutti i dispositivi allocati monitorati per questa chiamata.
ritorna | |
---|---|
getInvocationId
public abstract String getInvocationId ()
ritorna | |
---|---|
String | ID chiamata associato o null se non collegato a una chiamata |
getInvocationTimingMetrics
publicgetInvocationTimingMetrics ()
Restituisce la mappa contenente le metriche dei tempi di chiamata.
ritorna | |
---|---|
getModuleInvocationContext
public abstract IInvocationContext getModuleInvocationContext ()
Restituisce il contesto di chiamata del modulo durante l'esecuzione come parte di una suite.
ritorna | |
---|---|
IInvocationContext |
getNumDevicesAllocated
public abstract int getNumDevicesAllocated ()
Restituisce il numero di dispositivi allocati per la chiamata.
ritorna | |
---|---|
int |
getSerials
public abstractgetSerials ()
Restituisce l'elenco dei numeri di serie del dispositivo monitorato in questa chiamata
ritorna | |
---|---|
getShardsSerials
public abstractgetShardsSerials ()
Restituisce la mappa di tutti i serial tracciati e il relativo frammento coinvolto nello sharding. Vuoto se non un'invocazione frammentata.
ritorna | |
---|---|
getTestTag
public abstract String getTestTag ()
Restituisce l'invocazione test-tag.
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 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 |
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 chiamata.
Parametri | |
---|---|
testTag | String |
toProto
public abstract InvocationContext.Context toProto ()
Serializza un'istanza di contesto in un protobuf.
ritorna | |
---|---|
InvocationContext.Context |
è stato rilasciato in anticipo
public abstract boolean wasReleasedEarly ()
Restituisce se i dispositivi sono stati rilasciati in anticipo e non verranno più utilizzati.
ritorna | |
---|---|
boolean |