IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration

Una classe che comprende le informazioni di configurazione globale per una singola istanza della Federazione dei Mercanti (che comprende qualsiasi numero di invocazioni di configurazioni effettive).

Riepilogo

Metodi pubblici

abstract void cleanup ()

Pulizia corretta durante l'arresto di tradefed.

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

Filtra GlobalConfiguration in base a una lista bianca e genera un output in un file XML.

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

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

abstract File cloneConfigWithFilter (String... allowlistConfigs)

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

abstract ICommandScheduler getCommandScheduler ()

Ottiene l' ICommandScheduler da usare dalla configurazione.

abstract Object getConfigurationObject (String typeName)

Ottiene l'oggetto di configurazione personalizzato 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 usare dalla configurazione.

abstract getDeviceMonitors ()

Ottiene l'elenco di IDeviceMonitor dalla configurazione globale.

abstract IDeviceSelection getDeviceRequirements ()

Ottiene l' IDeviceSelection da usare 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 usare dalla configurazione.

abstract IHostResourceManager getHostResourceManager ()

Ottiene IHostResourceManager dalla configurazione globale.

abstract IKeyStoreFactory getKeyStoreFactory ()

Ottiene l' IKeyStoreFactory da usare dalla configurazione.

abstract getMultiDeviceRecoveryHandlers ()

Ottiene l'elenco di IMultiDeviceRecovery da usare dalla configurazione.

abstract getOptionValues (String optionName)

Ottenere un elenco di valori dell'opzione.

abstract getResourceMetricCollectors ()

Ottiene l'elenco di IResourceMetricCollector dalla configurazione globale.

abstract ISandboxFactory getSandboxFactory ()

Ottieni un factory sandbox che può essere utilizzato per eseguire un'invocazione

abstract IShardHelper getShardingStrategy ()

Restituisce IShardHelper che definisce il modo per partizionare una configurazione.

abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

abstract ITerribleFailureHandler getWtfHandler ()

Ottiene ITerribleFailureHandler da usare 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 tutti i valori esistenti.

abstract void setConfigurationFactory ( IConfigurationFactory configFactory)

Impostare IConfigurationFactory per questa configurazione.

abstract void setConfigurationObject (String name, Object configObject)

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

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

Metodo generico per impostare l'elenco di 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 tutti i valori esistenti.

abstract void setDeviceMonitor ( IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor .

abstract void setDeviceRequirements ( IDeviceSelection deviceSelection)

Imposta IDeviceSelection , sostituendo tutti i valori esistenti.

abstract void setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors)

Impostare l'elenco IHostMonitor .

abstract void setHostOptions ( IHostOptions hostOptions)

Imposta IHostOptions , sostituendo tutti i valori esistenti.

abstract void setHostResourceManager ( IHostResourceManager hostResourceManager)

Imposta IHostResourceManager , sostituendo tutti i valori esistenti.

abstract void setInvocationServer ( TestInvocationManagementServer server)

Imposta TestInvocationManagementServer .

abstract void setKeyStoreFactory ( IKeyStoreFactory factory)

Imposta IKeyStoreFactory , sostituendo tutti i valori esistenti.

abstract setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs)

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

Vedere 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 tutti i valori esistenti.

abstract void setShardingStrategy ( IShardHelper sharding)

Imposta IShardHelper da utilizzare durante il partizionamento 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 ()

Convalida i valori delle opzioni.

Metodi pubblici

ripulire

public abstract void cleanup ()

Pulizia corretta durante l'arresto di tradefed.

cloneConfigWithFilter

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

Filtra GlobalConfiguration in base a una lista bianca e genera un output 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.

Getta
IOException

cloneConfigWithFilter

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

Filtra GlobalConfiguration in base a una lista bianca consentendo al contempo 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 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.

Getta
IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Ottiene l' ICommandScheduler da usare dalla configurazione.

ritorna
ICommandScheduler il ICommandScheduler . Non restituirà mai null.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

Ottiene l'oggetto di configurazione personalizzato 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 nessuno.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

ritorna
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

Ottiene l' IDeviceManager da usare dalla configurazione. Gestisce il set di dispositivi disponibili per il test

ritorna
IDeviceManager l' IDeviceManager fornito nella configurazione.

getDeviceMonitors

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 usare dalla configurazione. Rappresenta un filtro globale su cui DeviceManager può vedere i dispositivi.

ritorna
IDeviceSelection l' IDeviceSelection fornito 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 dell'host da un server invece di ottenerlo 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 usare dalla configurazione.

ritorna
IHostOptions l' IDeviceManager fornito nella configurazione.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Ottiene IHostResourceManager dalla configurazione globale.

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

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

Ottiene l' IKeyStoreFactory da usare 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 usare dalla configurazione.

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

getOptionValues

public abstract  getOptionValues (String optionName)

Ottenere un elenco di valori dell'opzione.

Parametri
optionName String : il nome dell'opzione della mappa

ritorna
un elenco dei valori dell'opzione data. 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 un factory sandbox che può essere utilizzato per eseguire un'invocazione

ritorna
ISandboxFactory

getShardingStrategia

public abstract IShardHelper getShardingStrategy ()

Restituisce IShardHelper che definisce il modo per 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 usare 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

injectOptionValue

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 che vengono generate dinamicamente.

Parametri
optionName String : il nome dell'opzione

optionValue String : il/i valore/i dell'opzione

Getta
ConfigurationException se non è stato possibile impostare il valore dell'opzione

injectOptionValue

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 che vengono generate dinamicamente.

Parametri
optionName String : il nome dell'opzione della mappa

optionKey String : la chiave di opzione della mappa

optionValue String : il valore dell'opzione della mappa

Getta
ConfigurationException se non è stato possibile impostare il valore dell'opzione

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

Imposta ICommandScheduler , sostituendo tutti i valori esistenti.

setConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

Impostare IConfigurationFactory per questa configurazione.

Parametri
configFactory IConfigurationFactory

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

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

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

configObject Object : l'oggetto di configurazione

Getta
ConfigurationException se il configObject non era del tipo corretto

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

Metodo generico per impostare l'elenco di 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

Getta
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 tutti i valori esistenti. Questo imposta il gestore per i dispositivi di test

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor .

Parametri
deviceMonitor IDeviceMonitor : il monitor

Getta
ConfigurationException se è già stato impostato un IDeviceMonitor .

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Imposta IDeviceSelection , sostituendo tutti i valori esistenti. Questo imposta un filtro dispositivo globale sui dispositivi che DeviceManager può vedere.

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

Impostare l'elenco IHostMonitor .

Parametri
hostMonitors : l'elenco dei monitor

Getta
ConfigurationException se è già stato impostato un IHostMonitor .

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

Imposta IHostOptions , sostituendo tutti i valori esistenti.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

Imposta IHostResourceManager , sostituendo tutti i valori esistenti.

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

Imposta TestInvocationManagementServer .

Parametri
server TestInvocationManagementServer

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Imposta IKeyStoreFactory , sostituendo tutti i valori esistenti.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

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

Vedere ArgsOptionParser per il formato previsto

Parametri
listArgs : gli argomenti della riga di comando

ritorna
gli argomenti non consumati

Getta
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 tutti i valori esistenti.

setShardingStrategia

public abstract void setShardingStrategy (IShardHelper sharding)

Imposta IShardHelper da utilizzare durante il partizionamento 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

Getta
ConfigurationException se è già stato impostato un ITerribleFailureHandler .

impostare

public abstract void setup ()

Configurazione corretta all'inizio di tradefed.

Getta
com.android.tradefed.config.ConfigurationException
ConfigurationException

validateOptions

public abstract void validateOptions ()

Convalida i valori delle opzioni.

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

Getta
ConfigurationException se nella configurazione mancano i campi obbligatori