IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration


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

Riepilogo

Metodi pubblici

abstract void cleanup()

Pulizia corretta al termine dell'arresto di TradeFed.

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

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

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

Filtra la configurazione globale in base a una lista consentita, 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 salva l'output in un file XML.

abstract ICommandScheduler getCommandScheduler()

Recupera il ICommandScheduler da utilizzare dalla configurazione.

abstract Object getConfigurationObject(String typeName)

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

abstract ICredentialFactory getCredentialFactory()

Recupera il ICredentialFactory per la creazione delle credenziali.

abstract DeviceManagementGrpcServer getDeviceManagementServer()

Restituisce DeviceManagementGrpcServer o null se non definito.

abstract IDeviceManager getDeviceManager()

Recupera il IDeviceManager da utilizzare dalla configurazione.

abstract getDeviceMonitors()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

abstract IDeviceSelection getDeviceRequirements()

Ottiene il IDeviceSelection da utilizzare dalla configurazione.

abstract TradefedFeatureServer getFeatureServer()

Restituisce TradefedFeatureServer o null se non definito.

abstract IConfigurationServer getGlobalConfigServer()

Recupera il server di configurazione globale.

abstract getHostMonitors()

Recupera l'elenco di IHostMonitor dalla configurazione globale.

abstract IHostOptions getHostOptions()

Recupera il IHostOptions da utilizzare dalla configurazione.

abstract IHostResourceManager getHostResourceManager()

Recupera IHostResourceManager dalla configurazione globale.

abstract IKeyStoreFactory getKeyStoreFactory()

Recupera il IKeyStoreFactory da utilizzare dalla configurazione.

abstract getMultiDeviceRecoveryHandlers()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

abstract getOptionValues(String optionName)

Visualizza un elenco dei valori dell'opzione.

abstract getResourceMetricCollectors()

Recupera l'elenco di IResourceMetricCollector dalla configurazione globale.

abstract ISandboxFactory getSandboxFactory()

Ottieni una sandbox di fabbrica che possa essere utilizzata per eseguire una chiamata

abstract IShardHelper getShardingStrategy()

Restituisce il IShardHelper che definisce il modo di suddividere una configurazione.

abstract TestInvocationManagementServer getTestInvocationManagementSever()

Restituisce TestInvocationManagementServer o null se non definito.

abstract ITerribleFailureHandler getWtfHandler()

Recupera il ITerribleFailureHandler da utilizzare dalla configurazione.

abstract void injectOptionValue(String optionName, String optionValue)

Inserisci un valore dell'opzione nell'insieme di oggetti di configurazione.

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

Inserisci un valore dell'opzione nell'insieme di oggetti di configurazione.

abstract void setCommandScheduler(ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo i valori esistenti.

abstract void setConfigurationFactory(IConfigurationFactory configFactory)

Imposta il IConfigurationFactory per questa configurazione.

abstract void setConfigurationObject(String name, Object configObject)

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

abstract void setConfigurationObjectList(String typeName, configList)

Metodo generico per impostare l'elenco di oggetti di configurazione per il nome specificato, sostituendo eventuali valori esistenti.

abstract void setDeviceManagementServer(DeviceManagementGrpcServer server)

Imposta il 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 i valori esistenti.

abstract void 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)

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

Consulta 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 il IResourceMetricCollector.

abstract void setSandboxFactory(ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo eventuali valori esistenti.

abstract void setShardingStrategy(IShardHelper sharding)

Imposta IShardHelper da utilizzare per lo sharding di una configurazione.

abstract void setTradefedFeatureServer(TradefedFeatureServer server)

Imposta il TradefedFeatureServer.

abstract void setWtfHandler(ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

abstract void setup()

Configurazione corretta all'inizio della trascrizione.

abstract void validateOptions()

Convalida i valori delle opzioni.

Metodi pubblici

pulizia

public abstract void cleanup ()

Pulizia corretta al termine dell'arresto di TradeFed.

cloneConfigWithFilter

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

Filtra GlobalConfiguration in base a una lista consentita e salva in un file XML.

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

allowlistConfigs String: un array di configurazioni String da includere nel nuovo file XML. Se è impostato su null, a default list should be used.

Ritorni
File il file contenente la nuova configurazione globale filtrata.

Lanci
IOException

cloneConfigWithFilter

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

Filtra la configurazione globale in base a una lista consentita, consentendo al contempo la manipolazione dei valori delle opzioni e l'output in un file XML.

Parametri
exclusionPatterns : il pattern 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.

Ritorni
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 salva l'output in 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, ad eccezione di "key_store", verrà filtrata e verrà generato un file di configurazione con i seguenti contenuti: <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.

Ritorni
File il file contenente la nuova configurazione globale filtrata.

Lanci
Eccezione IO

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Recupera il ICommandScheduler da utilizzare dalla configurazione.

Ritorni
ICommandScheduler ICommandScheduler. Non restituirà mai un valore nullo.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

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

Parametri
typeName String: tipo univoco dell'oggetto di configurazione

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

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

Recupera il ICredentialFactory per la creazione delle credenziali.

Ritorni
ICredentialFactory ICredentialFactory o null se non è stato specificato nessuno.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

Ritorni
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

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

Ritorni
IDeviceManager IDeviceManager fornito nella configurazione.

getDeviceMonitors

public abstract  getDeviceMonitors ()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

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

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

Ottiene il IDeviceSelection da utilizzare dalla configurazione. Rappresenta un filtro globale su quali dispositivi DeviceManager può essere visualizzato.

Ritorni
IDeviceSelection il IDeviceSelection fornito nella configurazione.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

Restituisce TradefedFeatureServer o null se non definito.

Ritorni
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

Recupera il server di configurazione globale. Il server di configurazione globale viene utilizzato per recuperare le configurazioni host da un server anziché da file locali.

Ritorni
IConfigurationServer

getHostMonitors

public abstract  getHostMonitors ()

Recupera l'elenco di IHostMonitor dalla configurazione globale.

Ritorni
l'elenco di IHostMonitor dalla configurazione globale o null se non è stato specificato alcun valore.

getHostOpzioni

public abstract IHostOptions getHostOptions ()

Ottiene il IHostOptions da utilizzare dalla configurazione.

Ritorni
IHostOptions il IDeviceManager fornito nella configurazione.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Recupera IHostResourceManager dalla configurazione globale.

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

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

Ottiene il IKeyStoreFactory da utilizzare dalla configurazione.

Ritorni
IKeyStoreFactory IKeyStoreFactory o null se non è impostato alcun valore di fabbrica dell'archivio chiavi.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

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

getOptionValues

public abstract  getOptionValues (String optionName)

Visualizza un elenco dei valori dell'opzione.

Parametri
optionName String: il nome dell'opzione della mappa

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

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

Recupera l'elenco di IResourceMetricCollector dalla configurazione globale.

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

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

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

Ritorni
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

Restituisce il IShardHelper che definisce il modo di suddividere una configurazione.

Ritorni
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

Ritorni
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

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

Ritorni
ITerribleFailureHandler il ITerribleFailureHandler fornito nella configurazione o null se non è impostato alcun gestore

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

Inserisci un valore dell'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

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

injectOptionValue

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

Inserisci un valore dell'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 di opzione della mappa.

optionValue String: il valore dell'opzione della mappa

Lanci
ConfigurationException if failed to set the option's value

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

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

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

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

configObject Object: l'oggetto config

Lanci
ConfigurationException se 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 eventuali valori esistenti.

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

configList : l'elenco di oggetti di configurazione

Lanci
ConfigurationException se gli oggetti nell'elenco non sono 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. Viene impostato il gestore per i dispositivi di test

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor.

Parametri
deviceMonitor IDeviceMonitor: il monitor

Lanci
ConfigurationException se è già stato impostato un IDeviceMonitor.

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Imposta IDeviceSelection, sostituendo eventuali valori esistenti. Viene impostato un filtro dei dispositivi globali che DeviceManager può vedere.

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

Imposta l'elenco IHostMonitor.

Parametri
hostMonitors : l'elenco dei monitor

Lanci
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 il TestInvocationManagementServer.

Parametri
server TestInvocationManagementServer

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo i valori esistenti.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

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

Consulta ArgsOptionParser per il formato previsto

Parametri
listArgs : gli argomenti della riga di comando

Ritorni
Gli argomenti non utilizzati

Lanci
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

setSandboxfabbrica

public abstract void setSandboxFactory (ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo eventuali valori esistenti.

setShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

Imposta IShardHelper da utilizzare per 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

Lanci
ConfigurationException se è stato già impostato un valore ITerribleFailureHandler.

configura

public abstract void setup ()

Configurazione corretta all'inizio di tradefed.

Lanci
com.android.tradefed.config.ConfigurationException
ConfigurationException

validateOptions

public abstract void validateOptions ()

Convalida i valori delle opzioni.

Al momento, viene solo convalidato che tutte le opzioni obbligatorie sono state impostate

Lanci
ConfigurationException if configuration is missing mandatory fields