GlobalConfiguration

public class GlobalConfiguration
extends Object implements IGlobalConfiguration

java.lang.Object
   ↳ com.android.tradefed.config.GlobalConfiguration


Un'implementazione di IGlobalConfiguration che memorizza gli oggetti di configurazione caricati in una mappa

Riepilogo

Campi

public static final String CREDENTIAL_FACTORY_TYPE_NAME

public static final String DEVICE_MANAGER_TYPE_NAME

public static final String DEVICE_MONITOR_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

public static final String GLOBAL_CONFIG_SERVER

public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_VARIABLE

public static final String HOST_MONITOR_TYPE_NAME

public static final String HOST_OPTIONS_TYPE_NAME

public static final String HOST_RESOURCE_MANAGER_TYPE_NAME

public static final String KEY_STORE_TYPE_NAME

public static final String MULTI_DEVICE_RECOVERY_TYPE_NAME

public static final String RESOURCE_METRIC_COLLECTOR_TYPE_NAME

public static final String SANDBOX_FACTORY_TYPE_NAME

public static final String SCHEDULER_TYPE_NAME

public static final String SHARDING_STRATEGY_TYPE_NAME

public static final String TF_DEVICE_MANAGEMENT_SERVER_NAME

public static final String TF_FEATURE_SERVER_NAME

public static final String TF_INVOCATION_SERVER_NAME

public static final String WTF_HANDLER_TYPE_NAME

Metodi pubblici

void cleanup()

Pulizia corretta al termine dell'arresto di TradeFed.

File cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs)

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

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

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

File cloneConfigWithFilter(String... allowlistConfigs)

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

static createGlobalConfiguration(String[] args)

Configura l'oggetto singolo GlobalConfiguration per questa istanza TF.

ICommandScheduler getCommandScheduler()

Recupera il ICommandScheduler da utilizzare dalla configurazione.

Object getConfigurationObject(String typeName)

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

ICredentialFactory getCredentialFactory()

Recupera il ICredentialFactory per la creazione delle credenziali.

String getDescription()
DeviceManagementGrpcServer getDeviceManagementServer()

Restituisce DeviceManagementGrpcServer o null se non definito.

IDeviceManager getDeviceManager()

Recupera il IDeviceManager da utilizzare dalla configurazione.

static IDeviceManager getDeviceManagerInstance()

Restituisce un riferimento all'istanza singleton DeviceManager per questa istanza TF.

getDeviceMonitors()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

IDeviceSelection getDeviceRequirements()

Recupera il IDeviceSelection da utilizzare dalla configurazione.

TradefedFeatureServer getFeatureServer()

Restituisce TradefedFeatureServer o null se non definito.

IConfigurationServer getGlobalConfigServer()

Recupera il server di configurazione globale.

static getHostMonitorInstances()
getHostMonitors()

Recupera l'elenco di IHostMonitor dalla configurazione globale.

IHostOptions getHostOptions()

Recupera il IHostOptions da utilizzare dalla configurazione.

IHostResourceManager getHostResourceManager()

Recupera IHostResourceManager dalla configurazione globale.

static IGlobalConfiguration getInstance()

Restituisce un riferimento all'istanza singleton GlobalConfiguration per questa istanza TF.

IKeyStoreFactory getKeyStoreFactory()

Recupera il IKeyStoreFactory da utilizzare dalla configurazione.

getMultiDeviceRecoveryHandlers()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

String getName()
getOptionValues(String optionName)

Visualizza un elenco dei valori dell'opzione.

getResourceMetricCollectors()

Recupera l'elenco di IResourceMetricCollector dalla configurazione globale.

ISandboxFactory getSandboxFactory()

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

IShardHelper getShardingStrategy()

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

TestInvocationManagementServer getTestInvocationManagementSever()

Restituisce TestInvocationManagementServer o null se non definito.

ITerribleFailureHandler getWtfHandler()

Recupera il ITerribleFailureHandler da utilizzare dalla configurazione.

void injectOptionValue(String optionName, String optionValue)

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

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

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

void printCommandUsage(boolean importantOnly, PrintStream out)

Stampa un testo della guida all'utilizzo della riga di comando per questa configurazione nella stream di stampa specificata.

void setCommandScheduler(ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo eventuali valori esistenti.

void setConfigurationFactory(IConfigurationFactory configFactory)

Imposta IConfigurationFactory per questa configurazione.

void setConfigurationObject(String typeName, Object configObject)

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

void setConfigurationObjectList(String typeName, configList)

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

void setDeviceManagementServer(DeviceManagementGrpcServer server)

Imposta DeviceManagementGrpcServer.

void setDeviceManager(IDeviceManager manager)

Imposta IDeviceManager, sostituendo eventuali valori esistenti.

void setDeviceMonitor(IDeviceMonitor monitor)

Imposta IDeviceMonitor.

void setDeviceRequirements(IDeviceSelection devRequirements)

Imposta IDeviceSelection, sostituendo eventuali valori esistenti.

void setHostMonitors( hostMonitors)

Imposta l'elenco IHostMonitor.

void setHostOptions(IHostOptions hostOptions)

Imposta IHostOptions, sostituendo eventuali valori esistenti.

void setHostResourceManager(IHostResourceManager hostResourceManager)

Imposta IHostResourceManager, sostituendo eventuali valori esistenti.

void setInvocationServer(TestInvocationManagementServer server)

Imposta TestInvocationManagementServer.

void setKeyStoreFactory(IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo eventuali valori esistenti.

setOptionsFromCommandLineArgs( listArgs)

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

Per il formato previsto, consulta ArgsOptionParser

void setOriginalConfig(String config)

Imposta la configurazione originale utilizzata per creare la configurazione globale.

void setResourceMetricCollector(IResourceMetricCollector collector)

Imposta IResourceMetricCollector.

void setSandboxFactory(ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo eventuali valori esistenti.

void setShardingStrategy(IShardHelper sharding)

Imposta il IShardHelper da utilizzare per lo sharding di una configurazione.

void setTradefedFeatureServer(TradefedFeatureServer server)

Imposta TradefedFeatureServer.

void setWtfHandler(ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

void setup()

Configurazione corretta all'inizio di tradefed.

void validateOptions()

Convalida i valori delle opzioni.

Metodi protetti

IConfigurationFactory getConfigurationFactory()

Campi

CREDENTIAL_FACTORY_TYPE_NAME

public static final String CREDENTIAL_FACTORY_TYPE_NAME

DEVICE_MANAGER_TYPE_NAME

public static final String DEVICE_MANAGER_TYPE_NAME

DEVICE_MONITOR_TYPE_NAME

public static final String DEVICE_MONITOR_TYPE_NAME

DEVICE_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

GLOBAL_CONFIG_SERVER

public static final String GLOBAL_CONFIG_SERVER

GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

GLOBAL_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_VARIABLE

HOST_MONITOR_TYPE_NAME

public static final String HOST_MONITOR_TYPE_NAME

HOST_OPTIONS_TYPE_NAME

public static final String HOST_OPTIONS_TYPE_NAME

HOST_RESOURCE_MANAGER_TYPE_NAME

public static final String HOST_RESOURCE_MANAGER_TYPE_NAME

KEY_STORE_TYPE_NAME

public static final String KEY_STORE_TYPE_NAME

MULTI_DEVICE_RECOVERY_TYPE_NAME

public static final String MULTI_DEVICE_RECOVERY_TYPE_NAME

RESOURCE_METRIC_COLLECTOR_TYPE_NAME

public static final String RESOURCE_METRIC_COLLECTOR_TYPE_NAME

SANDBOX_FACTORY_TYPE_NAME

public static final String SANDBOX_FACTORY_TYPE_NAME

SCHEDULER_TYPE_NAME

public static final String SCHEDULER_TYPE_NAME

SHARDING_STRATEGY_TYPE_NAME

public static final String SHARDING_STRATEGY_TYPE_NAME

TF_DEVICE_MANAGEMENT_SERVER_NAME

public static final String TF_DEVICE_MANAGEMENT_SERVER_NAME

TF_FEATURE_SERVER_NAME

public static final String TF_FEATURE_SERVER_NAME

TF_INVOCATION_SERVER_NAME

public static final String TF_INVOCATION_SERVER_NAME

WTF_HANDLER_TYPE_NAME

public static final String WTF_HANDLER_TYPE_NAME

Metodi pubblici

pulizia

public void cleanup ()

Pulizia corretta al termine dell'arresto di TradeFed.

cloneConfigWithFilter

public 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 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 File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

Filtra GlobalConfiguration 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 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.

createGlobalConfiguration

public static  createGlobalConfiguration (String[] args)

Configura l'oggetto singolo GlobalConfiguration per questa istanza TF. Deve essere chiamato una sola volta, prima che qualsiasi operazione tenti di chiamare getInstance()

Parametri
args String

Ritorni

Lanci
IllegalStateException se viene chiamata più volte
ConfigurationException

getCommandScheduler

public ICommandScheduler getCommandScheduler ()

Recupera il ICommandScheduler da utilizzare dalla configurazione.

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

getConfigurationObject

public Object getConfigurationObject (String typeName)

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

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

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

getCredentialFactory

public ICredentialFactory getCredentialFactory ()

Recupera il ICredentialFactory per la creazione delle credenziali.

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

getDescription

public String getDescription ()

Ritorni
String una breve descrizione leggibile dall'utente Configuration

getDeviceManagementServer

public DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

Ritorni
DeviceManagementGrpcServer

getDeviceManager

public IDeviceManager getDeviceManager ()

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

Ritorni
IDeviceManager il IDeviceManager fornito nella configurazione.

getDeviceManagerInstance

public static IDeviceManager getDeviceManagerInstance ()

Restituisce un riferimento all'istanza singleton DeviceManager per questa istanza TF.

Ritorni
IDeviceManager

Lanci
IllegalStateException se createGlobalConfiguration(String[]) non è stato già chiamato.

getDeviceMonitors

public  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 IDeviceSelection getDeviceRequirements ()

Recupera 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 TradefedFeatureServer getFeatureServer ()

Restituisce TradefedFeatureServer o null se non definito.

Ritorni
TradefedFeatureServer

getGlobalConfigServer

public IConfigurationServer getGlobalConfigServer ()

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

Ritorni
IConfigurationServer

getHostMonitorInstances

public static  getHostMonitorInstances ()

Ritorni

getHostMonitors

public  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.

getHostOptions

public IHostOptions getHostOptions ()

Recupera il IHostOptions da utilizzare dalla configurazione.

Ritorni
IHostOptions il IDeviceManager fornito nella configurazione.

getHostResourceManager

public 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.

getInstance

public static IGlobalConfiguration getInstance ()

Restituisce un riferimento all'istanza singleton GlobalConfiguration per questa istanza TF.

Ritorni
IGlobalConfiguration

Lanci
IllegalStateException se createGlobalConfiguration(String[]) non è stato già chiamato.

getKeyStoreFactory

public IKeyStoreFactory getKeyStoreFactory ()

Recupera il IKeyStoreFactory da utilizzare dalla configurazione.

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

getMultiDeviceRecoveryHandlers

public  getMultiDeviceRecoveryHandlers ()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

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

getName

public String getName ()

Ritorni
String il nome di questo Configuration

getOptionValues

public  getOptionValues (String optionName)

Visualizza un elenco dei valori dell'opzione.

Parametri
optionName String: il nome dell'opzione mappa

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

getResourceMetricCollectors

public  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 ISandboxFactory getSandboxFactory ()

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

Ritorni
ISandboxFactory

getShardingStrategy

public IShardHelper getShardingStrategy ()

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

Ritorni
IShardHelper

getTestInvocationManagementSever

public TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

Ritorni
TestInvocationManagementServer

getWtfHandler

public 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 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

injectOptionValue

public 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 mappa

optionKey String: la chiave dell'opzione mappa

optionValue String: il valore dell'opzione mappa

Lanci
ConfigurationException

printCommandUsage

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

Stampa un testo della guida all'utilizzo della riga di comando per questa configurazione nella stream di stampa specificata.

Parametri
importantOnly boolean

out PrintStream: il ERROR(/PrintStream) da utilizzare.

Lanci
com.android.tradefed.config.ConfigurationException
ConfigurationException

setCommandScheduler

public void setCommandScheduler (ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo eventuali valori esistenti.

setConfigurationFactory

public void setConfigurationFactory (IConfigurationFactory configFactory)

Imposta IConfigurationFactory per questa configurazione.

Parametri
configFactory IConfigurationFactory

setConfigurationObject

public void setConfigurationObject (String typeName, 
                Object configObject)

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

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

configObject Object: l'oggetto config

Lanci
ConfigurationException

setConfigurationObjectList

public 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

setDeviceManagementServer

public void setDeviceManagementServer (DeviceManagementGrpcServer server)

Imposta DeviceManagementGrpcServer.

Parametri
server DeviceManagementGrpcServer

setDeviceManager

public void setDeviceManager (IDeviceManager manager)

Imposta IDeviceManager, sostituendo eventuali valori esistenti. Viene impostato il gestore per i dispositivi di test

setDeviceMonitor

public void setDeviceMonitor (IDeviceMonitor monitor)

Imposta IDeviceMonitor.

Parametri
monitor IDeviceMonitor: il monitor

setDeviceRequirements

public void setDeviceRequirements (IDeviceSelection devRequirements)

Imposta IDeviceSelection, sostituendo eventuali valori esistenti. Viene impostato un filtro globale dei dispositivi su cui DeviceManager può eseguire la visualizzazione.

setHostMonitors

public void setHostMonitors ( hostMonitors)

Imposta l'elenco IHostMonitor.

Parametri
hostMonitors : l'elenco dei monitor

setHostOptions

public void setHostOptions (IHostOptions hostOptions)

Imposta IHostOptions, sostituendo eventuali valori esistenti.

setHostResourceManager

public void setHostResourceManager (IHostResourceManager hostResourceManager)

Imposta IHostResourceManager, sostituendo eventuali valori esistenti.

setInvocationServer

public void setInvocationServer (TestInvocationManagementServer server)

Imposta TestInvocationManagementServer.

Parametri
server TestInvocationManagementServer

setKeyStoreFactory

public void setKeyStoreFactory (IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo eventuali valori esistenti.

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

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

Per il formato previsto, consulta ArgsOptionParser

Parametri
listArgs : gli argomenti della riga di comando

Ritorni
Gli argomenti non utilizzati

Lanci
ConfigurationException

setOriginalConfig

public void setOriginalConfig (String config)

Imposta la configurazione originale utilizzata per creare la configurazione globale.

Parametri
config String

setResourceMetricCollector

public void setResourceMetricCollector (IResourceMetricCollector collector)

Imposta IResourceMetricCollector.

Parametri
collector IResourceMetricCollector

setSandboxFactory

public void setSandboxFactory (ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo eventuali valori esistenti.

setShardingStrategy

public void setShardingStrategy (IShardHelper sharding)

Imposta il IShardHelper da utilizzare per lo sharding di una configurazione.

Parametri
sharding IShardHelper

setTradefedFeatureServer

public void setTradefedFeatureServer (TradefedFeatureServer server)

Imposta TradefedFeatureServer.

Parametri
server TradefedFeatureServer

setWtfHandler

public void setWtfHandler (ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

Parametri
wtfHandler ITerribleFailureHandler: l'handler WTF

configura

public void setup ()

Configurazione corretta all'inizio di tradefed.

Lanci
ConfigurationException

validateOptions

public void validateOptions ()

Convalida i valori delle opzioni.

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

Lanci
ConfigurationException

Metodi protetti

getConfigurationFactory

protected IConfigurationFactory getConfigurationFactory ()

Ritorni
IConfigurationFactory