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 quando la chiusura è stata trasferta.

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

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)

Restituisce 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 valore IShardHelper che definisce il modo in cui eseguire lo sharding di 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 di opzione nell'insieme di oggetti di configurazione.

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

Inserisci un valore di 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 di configurazione 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 i 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 il 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

Consulta ArgsOptionParser per il formato previsto

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

TIPO_DI_FACTORY_CREDENTIAL_FACTORY

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

SERVER_CONFIG_GLOBAL_CONFIG

public static final String GLOBAL_CONFIG_SERVER

SERVER_CONFIG_VARIABLE_GLOBAL_CONFIG_SERVER

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 quando la chiusura è stata trasferta.

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

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 chiamato più volte
ConfigurationException

getCommandScheduler

public ICommandScheduler getCommandScheduler ()

Recupera il ICommandScheduler da utilizzare dalla configurazione.

Ritorni
ICommandScheduler ICommandScheduler. Non restituirà mai null.

getConfigurationObject

public Object getConfigurationObject (String typeName)

Restituisce 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 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 sui dispositivi che l'DeviceManager può vedere.

Ritorni
IDeviceSelection 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 ne è stato specificato nessuno.

getHostOptions

public IHostOptions getHostOptions ()

Ottiene il IHostOptions da utilizzare dalla configurazione.

Ritorni
IHostOptions il IDeviceManager fornito nella configurazione.

getHostResourceManager

public IHostResourceManager getHostResourceManager ()

Recupera IHostResourceManager dalla configurazione globale.

Ritorni
IHostResourceManager IHostResourceManager dalla configurazione globale o implementazione predefinita LocalHostResourceManager se nessuno è specificato nella configurazione 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)

Ottieni 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  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 valore IShardHelper che definisce il modo in cui eseguire lo sharding di una configurazione.

Ritorni
IShardHelper

getTestInvocationManagementSever

public TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

Ritorni
TestInvocationManagementServer

getWtfGestori

public ITerribleFailureHandler getWtfHandler ()

Ottiene 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 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 opzioni generate dinamicamente.

Parametri
optionName String: il nome dell'opzione della 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 i 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 di configurazione con il nome specificato, sostituendo qualsiasi valore esistente.

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

configObject Object: l'oggetto di configurazione

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. Imposta 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 dei dispositivi globali che DeviceManager può vedere.

setHostMonitors

public void setHostMonitors ( hostMonitors)

Imposta l'elenco IHostMonitor.

Parametri
hostMonitors : l'elenco dei monitor

impostazioniHostOptions

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

Consulta ArgsOptionParser per il formato previsto

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 della trascrizione.

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