Configurazione globale

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration


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

Riepilogo

Metodi pubblici

abstract void cleanup()

Pulizia corretta quando la chiusura è trasferta.

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

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

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

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

abstract File cloneConfigWithFilter(String... allowlistConfigs)

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

abstract ICommandScheduler getCommandScheduler()

Ottiene il ICommandScheduler da utilizzare dalla configurazione.

abstract Object getConfigurationObject(String typeName)

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

abstract ICredentialFactory getCredentialFactory()

Recupera il ICredentialFactory per la creazione delle credenziali.

abstract DeviceManagementGrpcServer getDeviceManagementServer()

Restituisce DeviceManagementGrpcServer o null se non definito.

abstract IDeviceManager getDeviceManager()

Ottiene il IDeviceManager da utilizzare dalla configurazione.

abstract getDeviceMonitors()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

abstract IDeviceSelection getDeviceRequirements()

Ottiene il IDeviceSelection da utilizzare dalla configurazione.

abstract TradefedFeatureServer getFeatureServer()

Restituisce TradefedFeatureServer o null se non definito.

abstract IConfigurationServer getGlobalConfigServer()

Recupera il server di configurazione globale.

abstract getHostMonitors()

Recupera l'elenco di IHostMonitor dalla configurazione globale.

abstract IHostOptions getHostOptions()

Ottiene il IHostOptions da utilizzare dalla configurazione.

abstract IHostResourceManager getHostResourceManager()

Ottiene il valore IHostResourceManager dalla configurazione globale.

abstract IKeyStoreFactory getKeyStoreFactory()

Ottiene il IKeyStoreFactory da utilizzare dalla configurazione.

abstract getMultiDeviceRecoveryHandlers()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

abstract getOptionValues(String optionName)

Ottieni un elenco dei valori dell'opzione.

abstract getResourceMetricCollectors()

Recupera l'elenco di IResourceMetricCollector dalla configurazione globale.

abstract ISandboxFactory getSandboxFactory()

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

abstract IShardHelper getShardingStrategy()

Restituisce il valore IShardHelper che definisce il modo in cui eseguire lo sharding di una configurazione.

abstract TestInvocationManagementServer getTestInvocationManagementSever()

Restituisce TestInvocationManagementServer o null se non definito.

abstract ITerribleFailureHandler getWtfHandler()

Ottiene il ITerribleFailureHandler da utilizzare dalla configurazione.

abstract void injectOptionValue(String optionName, String optionValue)

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

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

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

abstract void setCommandScheduler(ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo i valori esistenti.

abstract void setConfigurationFactory(IConfigurationFactory configFactory)

Imposta il IConfigurationFactory per questa configurazione.

abstract void setConfigurationObject(String name, Object configObject)

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

abstract void setConfigurationObjectList(String typeName, configList)

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

abstract void setDeviceManagementServer(DeviceManagementGrpcServer server)

Imposta il DeviceManagementGrpcServer.

abstract void setDeviceManager(IDeviceManager deviceManager)

Imposta IDeviceManager, sostituendo i valori esistenti.

abstract void setDeviceMonitor(IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor.

abstract void setDeviceRequirements(IDeviceSelection deviceSelection)

Imposta IDeviceSelection, sostituendo i valori esistenti.

abstract void setHostMonitors( hostMonitors)

Imposta l'elenco IHostMonitor.

abstract void setHostOptions(IHostOptions hostOptions)

Imposta IHostOptions, sostituendo i valori esistenti.

abstract void setHostResourceManager(IHostResourceManager hostResourceManager)

Imposta IHostResourceManager, sostituendo i valori esistenti.

abstract void setInvocationServer(TestInvocationManagementServer server)

Imposta il TestInvocationManagementServer.

abstract void setKeyStoreFactory(IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo i valori esistenti.

abstract 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

abstract void setOriginalConfig(String config)

Imposta la configurazione originale utilizzata per creare la configurazione globale.

abstract void setResourceMetricCollector(IResourceMetricCollector collector)

Imposta il IResourceMetricCollector.

abstract void setSandboxFactory(ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo i valori esistenti.

abstract void setShardingStrategy(IShardHelper sharding)

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

abstract void setTradefedFeatureServer(TradefedFeatureServer server)

Imposta il TradefedFeatureServer.

abstract void setWtfHandler(ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

abstract void setup()

Configurazione corretta all'inizio della trascrizione.

abstract void validateOptions()

Convalida i valori delle opzioni.

Metodi pubblici

pulizia

public abstract void cleanup ()

Pulizia corretta quando la chiusura è trasferta.

cloneConfigWithFilter

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

Lanci
Eccezione IO

cloneConfigWithFilter

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

Lanci
Eccezione IO

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Ottiene il ICommandScheduler da utilizzare dalla configurazione.

Ritorni
ICommandScheduler ICommandScheduler. Non restituirà mai null.

getConfigurationObject

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

Recupera il ICredentialFactory per la creazione delle credenziali.

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

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non definito.

Ritorni
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

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

Ritorni
IDeviceManager IDeviceManager fornito nella configurazione.

getDeviceMonitors

public abstract  getDeviceMonitors ()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

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

getDevicerequirements

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

Restituisce TradefedFeatureServer o null se non definito.

Ritorni
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

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

Ritorni
IConfigurationServer

getHostMonitors

public abstract  getHostMonitors ()

Recupera l'elenco di IHostMonitor dalla configurazione globale.

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

getHostOpzioni

public abstract IHostOptions getHostOptions ()

Ottiene il IHostOptions da utilizzare dalla configurazione.

Ritorni
IHostOptions IDeviceManager fornito nella configurazione.

getHostResourceManager

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

getKeyStoreStore

public abstract IKeyStoreFactory getKeyStoreFactory ()

Ottiene il IKeyStoreFactory da utilizzare dalla configurazione.

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

getMultiDeviceRecoveryGestoris

public abstract  getMultiDeviceRecoveryHandlers ()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

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

getOptionValues

public abstract  getOptionValues (String optionName)

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

Recupera l'elenco di IResourceMetricCollector dalla configurazione globale.

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

getSandboxAzienda

public abstract ISandboxFactory getSandboxFactory ()

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

Ritorni
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

Restituisce il valore IShardHelper che definisce il modo in cui eseguire lo sharding di una configurazione.

Ritorni
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non definito.

Ritorni
TestInvocationManagementServer

getWtfGestori

public abstract 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 abstract 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 se non è stato possibile impostare il valore dell'opzione

injectOptionValue

public abstract 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 se non è stato possibile impostare il valore dell'opzione

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo i valori esistenti.

setConfigurationManufacturer

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

Imposta il IConfigurationFactory per questa configurazione.

Parametri
configFactory IConfigurationFactory

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

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

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

configObject Object: l'oggetto di configurazione

Lanci
ConfigurationException se configObject non era del tipo corretto

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

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

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

configList : l'elenco degli oggetti di configurazione

Lanci
ConfigurationException se qualche oggetto nell'elenco non è del tipo corretto

setDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

Imposta il DeviceManagementGrpcServer.

Parametri
server DeviceManagementGrpcServer

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

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

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor.

Parametri
deviceMonitor IDeviceMonitor: il monitor

Lanci
ConfigurationException se è già stato impostato un IDeviceMonitor.

setDevicerequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Imposta IDeviceSelection, sostituendo i valori esistenti. Imposta un dispositivo globale filtra in base ai dispositivi che l'DeviceManager può vedere.

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

Imposta l'elenco IHostMonitor.

Parametri
hostMonitors : l'elenco dei monitor

Lanci
ConfigurationException se è già stato impostato un IHostMonitor.

ImpostaHostOpzioni

public abstract void setHostOptions (IHostOptions hostOptions)

Imposta IHostOptions, sostituendo i valori esistenti.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

Imposta IHostResourceManager, sostituendo i valori esistenti.

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

Imposta il TestInvocationManagementServer.

Parametri
server TestInvocationManagementServer

setKeyStoreEarly

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo i valori esistenti.

setOptionsFromCommandLineArgs

public abstract  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 abstract void setOriginalConfig (String config)

Imposta la configurazione originale utilizzata per creare la configurazione globale.

Parametri
config String

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

Imposta il IResourceMetricCollector.

Parametri
collector IResourceMetricCollector

setSandboxfabbrica

public abstract void setSandboxFactory (ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo i valori esistenti.

setShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

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

Parametri
sharding IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

Imposta il TradefedFeatureServer.

Parametri
server TradefedFeatureServer

setWtfGestori

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

Parametri
wtfHandler ITerribleFailureHandler: il gestore WTF

Lanci
ConfigurationException se ITerribleFailureHandler ha è già stata impostata.

configura

public abstract void setup ()

Configurazione corretta all'inizio della trascrizione.

Lanci
com.android.tradefed.config.ConfigurationEccezione
ConfigurationException

convalidaOpzioni

public abstract void validateOptions ()

Convalida i valori delle opzioni.

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

Lanci
ConfigurationException se nella configurazione mancano campi obbligatori