IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration


Una classe che comprende le informazioni di configurazione globale per una singola istanza della Trade Federation (che comprende un numero qualsiasi di invocazioni di configurazioni effettive).

Riepilogo

Metodi pubblici

abstract void cleanup ()

Pulizia adeguata durante l'arresto del tradefed.

abstract File cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs)

Filtra la GlobalConfiguration in base a una lista bianca e inviala in un file XML.

abstract File cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)

Filtra la GlobalConfiguration in base a una lista bianca consentendo al tempo stesso la manipolazione dei valori delle opzioni e l'output in un file XML.

abstract File cloneConfigWithFilter (String... allowlistConfigs)

Filtra la GlobalConfiguration in base a un elenco consentito e invia l'output a un file XML.

abstract ICommandScheduler getCommandScheduler ()

Ottiene l' ICommandScheduler da utilizzare dalla configurazione.

abstract Object getConfigurationObject (String typeName)

Ottiene l'oggetto di configurazione personalizzata con il nome specificato.

abstract ICredentialFactory getCredentialFactory ()

Ottiene ICredentialFactory per la creazione delle credenziali.

abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

abstract IDeviceManager getDeviceManager ()

Ottiene l' IDeviceManager da utilizzare dalla configurazione.

abstract getDeviceMonitors ()

Ottiene l'elenco di IDeviceMonitor dalla configurazione globale.

abstract IDeviceSelection getDeviceRequirements ()

Ottiene l' IDeviceSelection da utilizzare dalla configurazione.

abstract TradefedFeatureServer getFeatureServer ()

Restituisce TradefedFeatureServer o null se non definito.

abstract IConfigurationServer getGlobalConfigServer ()

Ottiene il server di configurazione globale.

abstract getHostMonitors ()

Ottiene l'elenco di IHostMonitor dalla configurazione globale.

abstract IHostOptions getHostOptions ()

Ottiene l' IHostOptions da utilizzare dalla configurazione.

abstract IHostResourceManager getHostResourceManager ()

Ottiene IHostResourceManager dalla configurazione globale.

abstract IKeyStoreFactory getKeyStoreFactory ()

Ottiene l' IKeyStoreFactory da utilizzare dalla configurazione.

abstract getMultiDeviceRecoveryHandlers ()

Ottiene l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

abstract getOptionValues (String optionName)

Ottieni un elenco dei valori delle opzioni.

abstract getResourceMetricCollectors ()

Ottiene l'elenco di IResourceMetricCollector dalla configurazione globale.

abstract ISandboxFactory getSandboxFactory ()

Ottieni una fabbrica sandbox che può essere utilizzata per eseguire un'invocazione

abstract IShardHelper getShardingStrategy ()

Restituisce IShardHelper che definisce il modo di partizionare una configurazione.

abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

abstract ITerribleFailureHandler getWtfHandler ()

Ottiene ITerribleFailureHandler da utilizzare dalla configurazione.

abstract void injectOptionValue (String optionName, String optionValue)

Iniettare un valore di opzione nell'insieme di oggetti di configurazione.

abstract void injectOptionValue (String optionName, String optionKey, String optionValue)

Iniettare un valore di opzione nell'insieme di oggetti di configurazione.

abstract void setCommandScheduler ( ICommandScheduler scheduler)

Imposta ICommandScheduler , sostituendo eventuali valori esistenti.

abstract void setConfigurationFactory ( IConfigurationFactory configFactory)

Imposta IConfigurationFactory per questa configurazione.

abstract void setConfigurationObject (String name, Object configObject)

Metodo generico per impostare l'oggetto di configurazione con il nome dato, sostituendo qualsiasi valore esistente.

abstract void setConfigurationObjectList (String typeName, configList) setConfigurationObjectList (String typeName, configList)

Metodo generico per impostare l'elenco degli oggetti di configurazione per il nome specificato, sostituendo qualsiasi valore esistente.

abstract void setDeviceManagementServer ( DeviceManagementGrpcServer server)

Imposta DeviceManagementGrpcServer .

abstract void setDeviceManager ( IDeviceManager deviceManager)

Imposta IDeviceManager , sostituendo eventuali valori esistenti.

abstract void setDeviceMonitor ( IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor .

abstract void setDeviceRequirements ( IDeviceSelection deviceSelection)

Imposta IDeviceSelection , sostituendo eventuali valori esistenti.

abstract void setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors)

Imposta l'elenco IHostMonitor .

abstract void setHostOptions ( IHostOptions hostOptions)

Imposta IHostOptions , sostituendo eventuali valori esistenti.

abstract void setHostResourceManager ( IHostResourceManager hostResourceManager)

Imposta IHostResourceManager , sostituendo eventuali valori esistenti.

abstract void setInvocationServer ( TestInvocationManagementServer server)

Imposta TestInvocationManagementServer .

abstract void setKeyStoreFactory ( IKeyStoreFactory factory)

Imposta IKeyStoreFactory , sostituendo eventuali valori esistenti.

abstract setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs)

Imposta i campi Option di configurazione globale con un determinato set di argomenti della riga di comando

Vedi ArgsOptionParser per il formato previsto

abstract void setOriginalConfig (String config)

Imposta la configurazione originale utilizzata per creare la configurazione globale.

abstract void setResourceMetricCollector ( IResourceMetricCollector collector)

Imposta IResourceMetricCollector .

abstract void setSandboxFactory ( ISandboxFactory factory)

Imposta ISandboxFactory , sostituendo eventuali valori esistenti.

abstract void setShardingStrategy ( IShardHelper sharding)

Imposta IShardHelper da utilizzare durante lo sharding di una configurazione.

abstract void setTradefedFeatureServer ( TradefedFeatureServer server)

Imposta TradefedFeatureServer .

abstract void setWtfHandler ( ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler .

abstract void setup ()

Configurazione corretta all'inizio di tradefed.

abstract void validateOptions ()

Convalidare i valori delle opzioni.

Metodi pubblici

ripulire

public abstract void cleanup ()

Pulizia adeguata durante l'arresto del tradefed.

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                String... allowlistConfigs)

Filtra la GlobalConfiguration in base a una lista bianca e inviala in un file XML.

Parametri
exclusionPatterns : il modello del nome della classe da escludere dal dump.

allowlistConfigs String : un array String di configurazioni da includere nel nuovo file XML. Se è impostato su null , a default list should be used.
ritorna
File il file contenente la nuova configurazione globale filtrata.

Lancia
IOException

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

Filtra la GlobalConfiguration in base a una lista bianca consentendo al tempo stesso la manipolazione dei valori delle opzioni e l'output in un file XML.

Parametri
exclusionPatterns : il modello del nome della classe da escludere dal dump.

transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String : un array String di configurazioni da includere nel nuovo file XML. Se è impostato su null , a default list should be used.
ritorna
File il file contenente la nuova configurazione globale filtrata.

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

Filtra la GlobalConfiguration in base a un elenco consentito e invia l'output a un file XML.

Ad esempio, per la seguente configurazione: <xml> <configuration> <device_monitor class="com.android.tradefed.device.DeviceMonitorMultiplexer" /> <wtf_handler class="com.android.tradefed.log.TerribleFailureEmailHandler" /> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

tutta la configurazione tranne "key_store" verrà filtrata e risulterà un file di configurazione con il seguente contenuto: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Parametri
allowlistConfigs String : un array String di configurazioni da includere nel nuovo file XML. Se è impostato su null , a default list should be used.
ritorna
File il file contenente la nuova configurazione globale filtrata.

Lancia
IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Ottiene l' ICommandScheduler da utilizzare dalla configurazione.

ritorna
ICommandScheduler l' ICommandScheduler . Non restituirà mai null.

getConfigurazioneOggetto

public abstract Object getConfigurationObject (String typeName)

Ottiene l'oggetto di configurazione personalizzata con il nome specificato.

Parametri
typeName String : il tipo univoco dell'oggetto di configurazione

ritorna
Object l'oggetto o null se l'oggetto con quel nome non viene trovato

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

Ottiene ICredentialFactory per la creazione delle credenziali.

ritorna
ICredentialFactory ICredentialFactory o null se non ne è stato specificato alcuno.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

ritorna
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

Ottiene l' IDeviceManager da utilizzare dalla configurazione. Gestisce l'insieme di dispositivi disponibili per il test

ritorna
IDeviceManager l' IDeviceManager fornito nella configurazione.

getDeviceMonitor

public abstract  getDeviceMonitors ()

Ottiene l'elenco di IDeviceMonitor dalla configurazione globale.

ritorna
l'elenco di IDeviceMonitor dalla configurazione globale o null se non ne è stato specificato nessuno.

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

Ottiene l' IDeviceSelection da utilizzare dalla configurazione. Rappresenta un filtro globale su quali dispositivi il DeviceManager può vedere.

ritorna
IDeviceSelection l' IDeviceSelection fornita nella configurazione.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

Restituisce TradefedFeatureServer o null se non definito.

ritorna
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

Ottiene il server di configurazione globale. Il server di configurazione globale viene utilizzato per ottenere le configurazioni host da un server invece di ottenerle dai file locali.

ritorna
IConfigurationServer

getHostMonitors

public abstract  getHostMonitors ()

Ottiene l'elenco di IHostMonitor dalla configurazione globale.

ritorna
l'elenco di IHostMonitor dalla configurazione globale o null se non ne è stato specificato nessuno.

getHostOptions

public abstract IHostOptions getHostOptions ()

Ottiene l' IHostOptions da utilizzare dalla configurazione.

ritorna
IHostOptions l' IDeviceManager fornito nella configurazione.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Ottiene IHostResourceManager dalla configurazione globale.

ritorna
IHostResourceManager l' IHostResourceManager dalla configurazione globale o l'implementazione predefinita LocalHostResourceManager se non ne è specificato nessuno nella configurazione dell'host.

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

Ottiene l' IKeyStoreFactory da utilizzare dalla configurazione.

ritorna
IKeyStoreFactory IKeyStoreFactory o null se non è impostata alcuna factory dell'archivio chiavi.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

Ottiene l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

ritorna
l'elenco di IMultiDeviceRecovery o null se non impostato.

getOptionValues

public abstract  getOptionValues (String optionName)

Ottieni un elenco dei valori delle opzioni.

Parametri
optionName String : il nome dell'opzione della mappa

ritorna
un elenco dei valori dell'opzione specificata. null se il nome dell'opzione non esiste.

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

Ottiene l'elenco di IResourceMetricCollector dalla configurazione globale.

ritorna
l'elenco di IResourceMetricCollector dalla configurazione globale o null se non ne è stato specificato nessuno.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

Ottieni una fabbrica sandbox che può essere utilizzata per eseguire un'invocazione

ritorna
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

Restituisce IShardHelper che definisce il modo di partizionare una configurazione.

ritorna
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

ritorna
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

Ottiene ITerribleFailureHandler da utilizzare dalla configurazione. Gestisce cosa fare nel caso in cui si verifichi un WTF (What a Terrible Failure).

ritorna
ITerribleFailureHandler l' ITerribleFailureHandler fornito nella configurazione o null se non è impostato alcun gestore

iniettareOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

Iniettare un valore di opzione nell'insieme di oggetti di configurazione.

Utile per fornire valori per le opzioni generate dinamicamente.

Parametri
optionName String : il nome dell'opzione

optionValue String : i valori dell'opzione

Lancia
ConfigurationException se non è possibile impostare il valore dell'opzione

iniettareOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionKey, 
                String optionValue)

Iniettare un valore di opzione nell'insieme di oggetti di configurazione.

Utile per fornire valori per le opzioni generate dinamicamente.

Parametri
optionName String : il nome dell'opzione della mappa

optionKey String : la chiave dell'opzione della mappa

optionValue String : il valore dell'opzione della mappa

Lancia
ConfigurationException se non è possibile impostare il valore dell'opzione

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

Imposta ICommandScheduler , sostituendo eventuali valori esistenti.

setConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

Imposta IConfigurationFactory per questa configurazione.

Parametri
configFactory IConfigurationFactory

setConfigurazioneOggetto

public abstract void setConfigurationObject (String name, 
                Object configObject)

Metodo generico per impostare l'oggetto di configurazione con il nome dato, sostituendo qualsiasi valore esistente.

Parametri
name String : il nome univoco del tipo di oggetto di configurazione.

configObject Object : l'oggetto di configurazione

Lancia
ConfigurationException se configObject non era del tipo corretto

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

Metodo generico per impostare l'elenco degli oggetti di configurazione per il nome specificato, sostituendo qualsiasi valore esistente.

Parametri
typeName String : il nome univoco del tipo di oggetto di configurazione.

configList : l'elenco degli oggetti di configurazione

Lancia
ConfigurationException se qualche oggetto nell'elenco non è del tipo corretto

setDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

Imposta DeviceManagementGrpcServer .

Parametri
server DeviceManagementGrpcServer

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

Imposta IDeviceManager , sostituendo eventuali valori esistenti. Imposta il manager per i dispositivi di test

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor .

Parametri
deviceMonitor IDeviceMonitor : il monitor

Lancia
ConfigurationException se è già stato impostato un IDeviceMonitor .

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Imposta IDeviceSelection , sostituendo eventuali valori esistenti. Imposta un filtro dispositivo globale su quali dispositivi il DeviceManager può vedere.

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

Imposta l'elenco IHostMonitor .

Parametri
hostMonitors : l'elenco dei monitor

Lancia
ConfigurationException se è già stato impostato un IHostMonitor .

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

Imposta IHostOptions , sostituendo eventuali valori esistenti.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

Imposta IHostResourceManager , sostituendo eventuali valori esistenti.

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

Imposta TestInvocationManagementServer .

Parametri
server TestInvocationManagementServer

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Imposta IKeyStoreFactory , sostituendo eventuali valori esistenti.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

Imposta i campi Option di configurazione globale con un determinato set di argomenti della riga di comando

Vedi ArgsOptionParser per il formato previsto

Parametri
listArgs : gli argomenti della riga di comando

ritorna
gli argomenti non consumati

Lancia
ConfigurationException

setOriginalConfig

public abstract void setOriginalConfig (String config)

Imposta la configurazione originale utilizzata per creare la configurazione globale.

Parametri
config String

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

Imposta IResourceMetricCollector .

Parametri
collector IResourceMetricCollector

setSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

Imposta ISandboxFactory , sostituendo eventuali valori esistenti.

setShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

Imposta IShardHelper da utilizzare durante lo sharding di una configurazione.

Parametri
sharding IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

Imposta TradefedFeatureServer .

Parametri
server TradefedFeatureServer

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler .

Parametri
wtfHandler ITerribleFailureHandler : il gestore WTF

Lancia
ConfigurationException se è già stato impostato un ITerribleFailureHandler .

impostare

public abstract void setup ()

Configurazione corretta all'inizio di tradefed.

Lancia
com.android.tradefed.config.ConfigurationException
ConfigurationException

validateOptions

public abstract void validateOptions ()

Convalidare i valori delle opzioni.

Attualmente questo convaliderà solo che tutte le opzioni obbligatorie sono state impostate

Lancia
ConfigurationException se nella configurazione mancano i campi obbligatori