Configurazione globale

public class GlobalConfiguration
extends Object implements IGlobalConfiguration

java.lang.Oggetto
com.android.tradefed.config.GlobalConfiguration


Un'implementazione IGlobalConfiguration che archivia 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 durante l'arresto di tradefed.

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.

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.

File cloneConfigWithFilter (String... allowlistConfigs)

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

static createGlobalConfiguration (String[] args)

Imposta il singleton GlobalConfiguration per questa istanza TF.

ICommandScheduler getCommandScheduler ()

Ottiene l' ICommandScheduler da usare dalla configurazione.

Object getConfigurationObject (String typeName)

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

ICredentialFactory getCredentialFactory ()

Ottiene ICredentialFactory per la creazione delle credenziali.

String getDescription ()
DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

IDeviceManager getDeviceManager ()

Ottiene l' IDeviceManager da usare dalla configurazione.

static IDeviceManager getDeviceManagerInstance ()

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

getDeviceMonitors ()

Ottiene l'elenco di IDeviceMonitor dalla configurazione globale.

IDeviceSelection getDeviceRequirements ()

Ottiene l' IDeviceSelection da usare dalla configurazione.

TradefedFeatureServer getFeatureServer ()

Restituisce TradefedFeatureServer o null se non definito.

IConfigurationServer getGlobalConfigServer ()

Ottiene il server di configurazione globale.

static getHostMonitorInstances ()
getHostMonitors ()

Ottiene l'elenco di IHostMonitor dalla configurazione globale.

IHostOptions getHostOptions ()

Ottiene l' IHostOptions da usare dalla configurazione.

IHostResourceManager getHostResourceManager ()

Ottiene IHostResourceManager dalla configurazione globale.

static IGlobalConfiguration getInstance ()

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

IKeyStoreFactory getKeyStoreFactory ()

Ottiene l' IKeyStoreFactory da usare dalla configurazione.

getMultiDeviceRecoveryHandlers ()

Ottiene l'elenco di IMultiDeviceRecovery da usare dalla configurazione.

String getName ()
getOptionValues (String optionName)

Ottenere un elenco di valori dell'opzione.

getResourceMetricCollectors ()

Ottiene l'elenco di IResourceMetricCollector dalla configurazione globale.

ISandboxFactory getSandboxFactory ()

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

IShardHelper getShardingStrategy ()

Restituisce IShardHelper che definisce il modo per partizionare una configurazione.

TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

ITerribleFailureHandler getWtfHandler ()

Ottiene ITerribleFailureHandler da usare dalla configurazione.

void injectOptionValue (String optionName, String optionValue)

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

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

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

void printCommandUsage (boolean importantOnly, PrintStream out)

Invia un testo della guida sull'utilizzo della riga di comando per questa configurazione a un dato printStream.

void setCommandScheduler ( ICommandScheduler scheduler)

Imposta ICommandScheduler , sostituendo tutti i valori esistenti.

void setConfigurationFactory ( IConfigurationFactory configFactory)

Impostare 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) setConfigurationObjectList (String typeName, configList)

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

void setDeviceManagementServer ( DeviceManagementGrpcServer server)

Imposta DeviceManagementGrpcServer .

void setDeviceManager ( IDeviceManager manager)

Imposta IDeviceManager , sostituendo tutti i valori esistenti.

void setDeviceMonitor ( IDeviceMonitor monitor)

Imposta IDeviceMonitor .

void setDeviceRequirements ( IDeviceSelection devRequirements)

Imposta IDeviceSelection , sostituendo tutti i valori esistenti.

void setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors)

Impostare l'elenco IHostMonitor .

void setHostOptions ( IHostOptions hostOptions)

Imposta IHostOptions , sostituendo tutti i valori esistenti.

void setHostResourceManager ( IHostResourceManager hostResourceManager)

Imposta IHostResourceManager , sostituendo tutti i valori esistenti.

void setInvocationServer ( TestInvocationManagementServer server)

Imposta TestInvocationManagementServer .

void setKeyStoreFactory ( IKeyStoreFactory factory)

Imposta IKeyStoreFactory , sostituendo tutti i valori esistenti.

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

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

void setShardingStrategy ( IShardHelper sharding)

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

public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

GLOBAL_CONFIG_VARIABILE

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

ripulire

public void cleanup ()

Pulizia corretta durante l'arresto di tradefed.

cloneConfigWithFilter

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

cloneConfigWithFilter

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

createGlobalConfiguration

public static  createGlobalConfiguration (String[] args)

Imposta il singleton GlobalConfiguration per questa istanza TF. Deve essere chiamato una sola volta, prima che qualsiasi cosa tenti di chiamare getInstance()

Parametri
args String

ritorna

Getta
IllegalStateException se chiamato più di una volta
ConfigurationException

getCommandScheduler

public ICommandScheduler getCommandScheduler ()

Ottiene l' ICommandScheduler da usare dalla configurazione.

ritorna
ICommandScheduler il ICommandScheduler . Non restituirà mai null.

getConfigurationObject

public 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 ICredentialFactory getCredentialFactory ()

Ottiene ICredentialFactory per la creazione delle credenziali.

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

getDescription

public String getDescription ()

ritorna
String una breve descrizione leggibile dall'utente di questa Configuration

getDeviceManagementServer

public DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

ritorna
DeviceManagementGrpcServer

getDeviceManager

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

getDeviceManagerInstance

public static IDeviceManager getDeviceManagerInstance ()

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

ritorna
IDeviceManager

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

getDeviceMonitors

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

Restituisce TradefedFeatureServer o null se non definito.

ritorna
TradefedFeatureServer

getGlobalConfigServer

public 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

getHostMonitorInstances

public static  getHostMonitorInstances ()

ritorna

getHostMonitors

public  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 IHostOptions getHostOptions ()

Ottiene l' IHostOptions da usare dalla configurazione.

ritorna
IHostOptions l' IDeviceManager fornito nella configurazione.

getHostResourceManager

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

getInstance

public static IGlobalConfiguration getInstance ()

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

ritorna
IGlobalConfiguration

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

getKeyStoreFactory

public IKeyStoreFactory getKeyStoreFactory ()

Ottiene l' IKeyStoreFactory da usare dalla configurazione.

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

getMultiDeviceRecoveryHandlers

public  getMultiDeviceRecoveryHandlers ()

Ottiene l'elenco di IMultiDeviceRecovery da usare dalla configurazione.

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

getNome

public String getName ()

ritorna
String il nome di questa Configuration

getOptionValues

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

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

ritorna
ISandboxFactory

getShardingStrategia

public IShardHelper getShardingStrategy ()

Restituisce IShardHelper che definisce il modo per partizionare una configurazione.

ritorna
IShardHelper

getTestInvocationManagementSever

public TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

ritorna
TestInvocationManagementServer

getWtfHandler

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

injectOptionValue

public 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

printCommandUsage

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

Invia un testo della guida sull'utilizzo della riga di comando per questa configurazione a un dato printStream.

Parametri
importantOnly boolean

out PrintStream : l' ERROR(/PrintStream) da utilizzare.

Getta
com.android.tradefed.config.ConfigurationException
ConfigurationException

setCommandScheduler

public void setCommandScheduler (ICommandScheduler scheduler)

Imposta ICommandScheduler , sostituendo tutti i valori esistenti.

setConfigurationFactory

public void setConfigurationFactory (IConfigurationFactory configFactory)

Impostare 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

Getta
ConfigurationException

setConfigurationObjectList

public 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

setDeviceManagementServer

public void setDeviceManagementServer (DeviceManagementGrpcServer server)

Imposta DeviceManagementGrpcServer .

Parametri
server DeviceManagementGrpcServer

setDeviceManager

public void setDeviceManager (IDeviceManager manager)

Imposta IDeviceManager , sostituendo tutti i valori esistenti. Questo imposta il gestore per i dispositivi di prova

setDeviceMonitor

public void setDeviceMonitor (IDeviceMonitor monitor)

Imposta IDeviceMonitor .

Parametri
monitor IDeviceMonitor : il monitor

setDeviceRequirements

public void setDeviceRequirements (IDeviceSelection devRequirements)

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

setHostMonitors

public void setHostMonitors ( hostMonitors)

Impostare l'elenco IHostMonitor .

Parametri
hostMonitors : l'elenco dei monitor

setHostOptions

public void setHostOptions (IHostOptions hostOptions)

Imposta IHostOptions , sostituendo tutti i valori esistenti.

setHostResourceManager

public void setHostResourceManager (IHostResourceManager hostResourceManager)

Imposta IHostResourceManager , sostituendo tutti i valori esistenti.

setInvocationServer

public void setInvocationServer (TestInvocationManagementServer server)

Imposta TestInvocationManagementServer .

Parametri
server TestInvocationManagementServer

setKeyStoreFactory

public void setKeyStoreFactory (IKeyStoreFactory factory)

Imposta IKeyStoreFactory , sostituendo tutti i valori esistenti.

setOptionsFromCommandLineArgs

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

setShardingStrategia

public void setShardingStrategy (IShardHelper sharding)

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

impostare

public void setup ()

Configurazione corretta all'inizio di tradefed.

Getta
ConfigurationException

validateOptions

public void validateOptions ()

Convalida i valori delle opzioni.

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

Getta
ConfigurationException

Metodi protetti

getConfigurationFactory

protected IConfigurationFactory getConfigurationFactory ()

ritorna
IConfigurationFactory