Configurazione globale

public class GlobalConfiguration
extends Object implements IGlobalConfiguration

java.lang.Object
🎞 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 quando la chiusura è trasferta.

File cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs)

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

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

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

File cloneConfigWithFilter(String... allowlistConfigs)

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

static createGlobalConfiguration(String[] args)

Configura il singleton GlobalConfiguration per questa istanza TF.

ICommandScheduler getCommandScheduler()

Ottiene 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()

Ottiene il IDeviceManager da utilizzare dalla configurazione.

static IDeviceManager getDeviceManagerInstance()

Restituisce un riferimento all'istanza singleton DeviceManager per questo TF in esecuzione in un'istanza Compute Engine.

getDeviceMonitors()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

IDeviceSelection getDeviceRequirements()

Ottiene 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()

Ottiene il IHostOptions da utilizzare dalla configurazione.

IHostResourceManager getHostResourceManager()

Ottiene il valore IHostResourceManager dalla configurazione globale.

static IGlobalConfiguration getInstance()

Restituisce un riferimento all'istanza singleton GlobalConfiguration per questo TF in esecuzione in un'istanza Compute Engine.

IKeyStoreFactory getKeyStoreFactory()

Ottiene il IKeyStoreFactory da utilizzare dalla configurazione.

getMultiDeviceRecoveryHandlers()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

String getName()
getOptionValues(String optionName)

Ottieni un elenco dei valori dell'opzione.

getResourceMetricCollectors()

Recupera l'elenco di IResourceMetricCollector dalla configurazione globale.

ISandboxFactory getSandboxFactory()

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

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

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

Restituisce un testo della guida per l'utilizzo della riga di comando per questa configurazione a PrintStream specificato.

void setCommandScheduler(ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo i valori esistenti.

void setConfigurationFactory(IConfigurationFactory configFactory)

Imposta il 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 quelli esistenti valore.

void setDeviceManagementServer(DeviceManagementGrpcServer server)

Imposta il DeviceManagementGrpcServer.

void setDeviceManager(IDeviceManager manager)

Imposta IDeviceManager, sostituendo i 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 i valori esistenti.

void setHostResourceManager(IHostResourceManager hostResourceManager)

Imposta IHostResourceManager, sostituendo i valori esistenti.

void setInvocationServer(TestInvocationManagementServer server)

Imposta il TestInvocationManagementServer.

void setKeyStoreFactory(IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo i valori esistenti.

setOptionsFromCommandLineArgs( listArgs)

Imposta i campi Option della configurazione globale 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 il IResourceMetricCollector.

void setSandboxFactory(ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo i valori esistenti.

void setShardingStrategy(IShardHelper sharding)

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

void setTradefedFeatureServer(TradefedFeatureServer server)

Imposta il TradefedFeatureServer.

void setWtfHandler(ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

void setup()

Configurazione corretta all'inizio della trascrizione.

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

NOME_TIPO_SCHEDULER

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

NOME_TIPO_WTF_HANDLER

public static final String WTF_HANDLER_TYPE_NAME

Metodi pubblici

pulizia

public void cleanup ()

Pulizia corretta quando la chiusura è trasferta.

cloneConfigWithFilter

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

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

cloneConfigWithFilter

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

Filtra GlobalConfiguration in base a una lista bianca consentendo al contempo la manipolazione i 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 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 la GlobalConfiguration in base a un elenco consentito e genera 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>

tutte le configurazioni tranne "key_store" verrà escluso e il risultato sarà un file di configurazione i seguenti contenuti: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

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

createGlobalConfiguration

public static  createGlobalConfiguration (String[] args)

Configura il singleton GlobalConfiguration per questa istanza TF. Deve essere chiamato una volta e solo una volta, prima che qualsiasi cosa provi a chiamare getInstance()

Parametri
args String

Ritorni

Lanci
IllegalStateException se chiamato più di una volta
ConfigurationException

getCommandScheduler

public ICommandScheduler getCommandScheduler ()

Ottiene 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: tipo univoco dell'oggetto di configurazione

Ritorni
Object l'oggetto o nullo 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 ne è stato specificato nessuno.

getDescription

public String getDescription ()

Ritorni
String una breve descrizione leggibile dall'utente questo Configuration

getDeviceManagementServer

public DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

Ritorni
DeviceManagementGrpcServer

getDeviceManager

public IDeviceManager getDeviceManager ()

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

Ritorni
IDeviceManager IDeviceManager fornito nella configurazione.

getDeviceManagerInstance

public static IDeviceManager getDeviceManagerInstance ()

Restituisce un riferimento all'istanza singleton DeviceManager per questo TF in esecuzione in un'istanza Compute Engine.

Ritorni
IDeviceManager

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

getDeviceMonitors

public  getDeviceMonitors ()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

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

getDevicerequirements

public IDeviceSelection getDeviceRequirements ()

Ottiene il IDeviceSelection da utilizzare dalla configurazione. Rappresenta un filtro globale su quali dispositivi il 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 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 nessuno è stato specificato.

getHostOpzioni

public IHostOptions getHostOptions ()

Ottiene il IHostOptions da utilizzare dalla configurazione.

Ritorni
IHostOptions IDeviceManager fornito nella configurazione.

getHostResourceManager

public IHostResourceManager getHostResourceManager ()

Ottiene il valore IHostResourceManager dalla configurazione globale.

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

getInstance

public static IGlobalConfiguration getInstance ()

Restituisce un riferimento all'istanza singleton GlobalConfiguration per questo TF in esecuzione in un'istanza Compute Engine.

Ritorni
IGlobalConfiguration

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

getKeyStoreStore

public IKeyStoreFactory getKeyStoreFactory ()

Ottiene il IKeyStoreFactory da utilizzare dalla configurazione.

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

getMultiDeviceRecoveryGestoris

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

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.

getSandboxAzienda

public ISandboxFactory getSandboxFactory ()

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

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. Gestisci le operazioni da eseguire nel caso in cui un errore WTF (What a Terrible Failure) .

Ritorni
ITerribleFailureHandler il ITerribleFailureHandler fornito in o nullo se non è impostato alcun gestore

injectOptionValue

public void injectOptionValue (String optionName, 
                String optionValue)

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

optionValue String: il valore dell'opzione della mappa

Lanci
ConfigurationException

ComandoperstampaUtilizzo

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

Restituisce un testo della guida per l'utilizzo della riga di comando per questa configurazione a PrintStream specificato.

Parametri
importantOnly boolean

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

Lanci
com.android.tradefed.config.ConfigurationEccezione
ConfigurationException

setCommandScheduler

public void setCommandScheduler (ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo i valori esistenti.

setConfigurationManufacturer

public void setConfigurationFactory (IConfigurationFactory configFactory)

Imposta il 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 quelli esistenti valore.

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

configList : l'elenco degli oggetti di configurazione

Lanci
ConfigurationException

setDeviceManagementServer

public void setDeviceManagementServer (DeviceManagementGrpcServer server)

Imposta il DeviceManagementGrpcServer.

Parametri
server DeviceManagementGrpcServer

setDeviceManager

public void setDeviceManager (IDeviceManager manager)

Imposta IDeviceManager, sostituendo i valori esistenti. Imposta il gestore per 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 i valori esistenti. Imposta un dispositivo globale filtra in base ai dispositivi che l'DeviceManager può vedere.

setHostMonitors

public void setHostMonitors ( hostMonitors)

Imposta l'elenco IHostMonitor.

Parametri
hostMonitors : l'elenco dei monitor

ImpostaHostOpzioni

public void setHostOptions (IHostOptions hostOptions)

Imposta IHostOptions, sostituendo i valori esistenti.

setHostResourceManager

public void setHostResourceManager (IHostResourceManager hostResourceManager)

Imposta IHostResourceManager, sostituendo i valori esistenti.

setInvocationServer

public void setInvocationServer (TestInvocationManagementServer server)

Imposta il TestInvocationManagementServer.

Parametri
server TestInvocationManagementServer

setKeyStoreEarly

public void setKeyStoreFactory (IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo i valori esistenti.

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

Imposta i campi Option della configurazione globale 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 consumati

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

Parametri
collector IResourceMetricCollector

setSandboxfabbrica

public void setSandboxFactory (ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo i 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 il TradefedFeatureServer.

Parametri
server TradefedFeatureServer

setWtfGestori

public void setWtfHandler (ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

Parametri
wtfHandler ITerribleFailureHandler: il gestore WTF

configura

public void setup ()

Configurazione corretta all'inizio della trascrizione.

Lanci
ConfigurationException

convalidaOpzioni

public void validateOptions ()

Convalida i valori delle opzioni.

Al momento, questa operazione consente di verificare che tutte le opzioni obbligatorie siano state impostate.

Lanci
ConfigurationException

Metodi protetti

getConfigurazioneFabbrica

protected IConfigurationFactory getConfigurationFactory ()

Ritorni
IConfigurationFactory