IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration

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

Riepilogo

Metodi pubblici

abstract void cleanup()

Pulizia corretta all'arresto di Tradefed.

abstract File cloneConfigWithFilter(String... allowlistConfigs)

Filtra GlobalConfiguration in base a un elenco consentito e genera un file XML.

abstract File cloneConfigWithFilter(Set<String> exclusionPatterns, String... allowlistConfigs)

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

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

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

abstract ICommandScheduler getCommandScheduler()

Recupera il ICommandScheduler da utilizzare dalla configurazione.

abstract Object getConfigurationObject(String typeName)

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

abstract ICredentialFactory getCredentialFactory()

Recupera ICredentialFactory per la creazione delle credenziali.

abstract DeviceManagementGrpcServer getDeviceManagementServer()

Restituisce DeviceManagementGrpcServer o null se non è definito.

abstract IDeviceManager getDeviceManager()

Recupera il IDeviceManager da utilizzare dalla configurazione.

abstract List<IDeviceMonitor> getDeviceMonitors()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

abstract IDeviceSelection getDeviceRequirements()

Recupera 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 List<IHostMonitor> getHostMonitors()

Recupera l'elenco di IHostMonitor dalla configurazione globale.

abstract IHostOptions getHostOptions()

Recupera il IHostOptions da utilizzare dalla configurazione.

abstract IHostResourceManager getHostResourceManager()

Recupera IHostResourceManager dalla configurazione globale.

abstract IKeyStoreFactory getKeyStoreFactory()

Recupera il IKeyStoreFactory da utilizzare dalla configurazione.

abstract List<IMultiDeviceRecovery> getMultiDeviceRecoveryHandlers()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

abstract List<String> getOptionValues(String optionName)

Ottieni un elenco dei valori di un'opzione.

abstract List<IResourceMetricCollector> getResourceMetricCollectors()

Recupera l'elenco di IResourceMetricCollector dalla configurazione globale.

abstract ISandboxFactory getSandboxFactory()

Ottieni una factory sandbox che può essere utilizzata per eseguire una chiamata

abstract IShardHelper getShardingStrategy()

Restituisce IShardHelper che definisce il modo di partizionare una configurazione.

abstract TestInvocationManagementServer getTestInvocationManagementSever()

Restituisce TestInvocationManagementServer o null se non è definito.

abstract ITerribleFailureHandler getWtfHandler()

Recupera il ITerribleFailureHandler da utilizzare dalla configurazione.

abstract void injectOptionValue(String optionName, String optionValue)

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

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

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

abstract void setCommandScheduler(ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo eventuali valori esistenti.

abstract void setConfigurationFactory(IConfigurationFactory configFactory)

Imposta 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, List<?> configList)

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

abstract void setDeviceManagementServer(DeviceManagementGrpcServer server)

Imposta DeviceManagementGrpcServer.

abstract void setDeviceManager(IDeviceManager deviceManager)

Imposta IDeviceManager, sostituendo eventuali valori esistenti.

abstract void setDeviceMonitor(IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor.

abstract void setDeviceRequirements(IDeviceSelection deviceSelection)

Imposta IDeviceSelection, sostituendo eventuali valori esistenti.

abstract void setHostMonitors(List<IHostMonitor> hostMonitors)

Imposta l'elenco IHostMonitor.

abstract void setHostOptions(IHostOptions hostOptions)

Imposta IHostOptions, sostituendo eventuali valori esistenti.

abstract void setHostResourceManager(IHostResourceManager hostResourceManager)

Imposta IHostResourceManager, sostituendo eventuali valori esistenti.

abstract void setInvocationServer(TestInvocationManagementServer server)

Imposta TestInvocationManagementServer.

abstract void setKeyStoreFactory(IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo eventuali valori esistenti.

abstract List<String> setOptionsFromCommandLineArgs(List<String> listArgs)

Imposta i campi di configurazione globale Option con il set specificato di argomenti della riga di comando

Per il formato previsto, vedi ArgsOptionParser

abstract void setOriginalConfig(String config)

Imposta la configurazione originale utilizzata per creare la configurazione globale.

abstract void setResourceMetricCollector(IResourceMetricCollector collector)

Imposta IResourceMetricCollector.

abstract void setSandboxFactory(ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo eventuali valori esistenti.

abstract void setShardingStrategy(IShardHelper sharding)

Imposta IShardHelper da utilizzare durante lo sharding di una configurazione.

abstract void setTradefedFeatureServer(TradefedFeatureServer server)

Imposta TradefedFeatureServer.

abstract void setWtfHandler(ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

abstract void setup()

Configurazione corretta all'inizio di Tradefed.

abstract void validateOptions()

Convalida i valori delle opzioni.

Metodi pubblici

cleanup

public abstract void cleanup ()

Pulizia corretta all'arresto di Tradefed.

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

Filtra GlobalConfiguration in base a un elenco consentito e genera 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 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.
Resi
File il file contenente la nuova configurazione globale filtrata.
Genera
java.io.IOException
IOException

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (Set<String> exclusionPatterns, 
                String... allowlistConfigs)

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

Parametri
exclusionPatterns Set: 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.
Resi
File il file contenente la nuova configurazione globale filtrata.
Genera
java.io.IOException
IOException

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (Set<String> exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

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

Parametri
exclusionPatterns Set: 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.
Resi
File il file contenente la nuova configurazione globale filtrata.
Genera
IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Recupera il ICommandScheduler da utilizzare dalla configurazione.

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

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

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

Parametri
typeName String: il tipo univoco dell'oggetto di configurazione
Resi
Object l'oggetto o null se non viene trovato alcun oggetto con quel nome

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

Recupera ICredentialFactory per la creazione delle credenziali.

Resi
ICredentialFactory ICredentialFactory o null se non è stato specificato alcun valore.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Restituisce DeviceManagementGrpcServer o null se non è definito.

Resi
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

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

Resi
IDeviceManager IDeviceManager fornito nella configurazione.

getDeviceMonitors

public abstract List<IDeviceMonitor> getDeviceMonitors ()

Recupera l'elenco di IDeviceMonitor dalla configurazione globale.

Resi
List<IDeviceMonitor> l'elenco di IDeviceMonitor dalla configurazione globale o null se non è stato specificato alcun valore.

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

Recupera il IDeviceSelection da utilizzare dalla configurazione. Rappresenta un filtro globale sui dispositivi che DeviceManager può vedere.

Resi
IDeviceSelection IDeviceSelection fornito nella configurazione.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

Restituisce TradefedFeatureServer o null se non è definito.

Resi
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

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

Resi
IConfigurationServer

getHostMonitors

public abstract List<IHostMonitor> getHostMonitors ()

Recupera l'elenco di IHostMonitor dalla configurazione globale.

Resi
List<IHostMonitor> l'elenco di IHostMonitor dalla configurazione globale o null se non è stato specificato alcun valore.

getHostOptions

public abstract IHostOptions getHostOptions ()

Recupera il IHostOptions da utilizzare dalla configurazione.

Resi
IHostOptions IDeviceManager fornito nella configurazione.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Recupera IHostResourceManager dalla configurazione globale.

Resi
IHostResourceManager IHostResourceManager dalla configurazione globale o l'implementazione predefinita LocalHostResourceManager se non è specificata alcuna configurazione host.

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

Recupera il IKeyStoreFactory da utilizzare dalla configurazione.

Resi
IKeyStoreFactory IKeyStoreFactory o null se non è impostata alcuna fabbrica di archivio chiavi.

getMultiDeviceRecoveryHandlers

public abstract List<IMultiDeviceRecovery> getMultiDeviceRecoveryHandlers ()

Recupera l'elenco di IMultiDeviceRecovery da utilizzare dalla configurazione.

Resi
List<IMultiDeviceRecovery> l'elenco di IMultiDeviceRecovery o null se non è impostato.

getOptionValues

public abstract List<String> getOptionValues (String optionName)

Ottieni un elenco dei valori di un'opzione.

Parametri
optionName String: il nome dell'opzione della mappa
Resi
List<String> un elenco dei valori dell'opzione specificata. null se il nome dell'opzione non esiste.

getResourceMetricCollectors

public abstract List<IResourceMetricCollector> getResourceMetricCollectors ()

Recupera l'elenco di IResourceMetricCollector dalla configurazione globale.

Resi
List<IResourceMetricCollector> l'elenco di IResourceMetricCollector della configurazione globale o null se non è stato specificato alcun valore.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

Ottieni una factory sandbox che può essere utilizzata per eseguire una chiamata

Resi
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

Restituisce IShardHelper che definisce il modo di partizionare una configurazione.

Resi
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Restituisce TestInvocationManagementServer o null se non è definito.

Resi
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

Recupera il ITerribleFailureHandler da utilizzare dalla configurazione. Gestisce cosa fare nel caso in cui si verifichi un errore WTF (What a Terrible Failure).

Resi
ITerribleFailureHandler ITerribleFailureHandler fornito nella configurazione o null se non è impostato alcun gestore

injectOptionValue

public abstract 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: il valore o i valori dell'opzione
Genera
ConfigurationException se non è stato possibile impostare il valore dell'opzione

injectOptionValue

public abstract 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 della mappa
optionKey String: la chiave dell'opzione della mappa
optionValue String: il valore dell'opzione della mappa
Genera
ConfigurationException se non è stato possibile impostare il valore dell'opzione

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

Imposta ICommandScheduler, sostituendo eventuali valori esistenti.

setConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

Imposta 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
Genera
ConfigurationException se configObject non era del tipo corretto

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                List<?> 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 List: l'elenco di oggetti di configurazione
Genera
ConfigurationException se alcuni oggetti nell'elenco non sono del tipo corretto

setDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

Imposta DeviceManagementGrpcServer.

Parametri
server DeviceManagementGrpcServer

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

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

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Imposta IDeviceMonitor.

Parametri
deviceMonitor IDeviceMonitor: Il monitor
Genera
ConfigurationException se è già stato impostato un IDeviceMonitor.

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Imposta IDeviceSelection, sostituendo eventuali valori esistenti. In questo modo viene impostato un filtro globale dei dispositivi sui dispositivi che DeviceManager può vedere.

setHostMonitors

public abstract void setHostMonitors (List<IHostMonitor> hostMonitors)

Imposta l'elenco IHostMonitor.

Parametri
hostMonitors List: L'elenco dei monitor
Genera
ConfigurationException se è già stato impostato un IHostMonitor.

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

Imposta IHostOptions, sostituendo eventuali valori esistenti.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

Imposta IHostResourceManager, sostituendo eventuali valori esistenti.

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

Imposta TestInvocationManagementServer.

Parametri
server TestInvocationManagementServer

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Imposta IKeyStoreFactory, sostituendo eventuali valori esistenti.

setOptionsFromCommandLineArgs

public abstract List<String> setOptionsFromCommandLineArgs (List<String> listArgs)

Imposta i campi di configurazione globale Option con il set specificato di argomenti della riga di comando

Per il formato previsto, vedi ArgsOptionParser

Parametri
listArgs List: gli argomenti della riga di comando
Resi
List<String> gli argomenti non utilizzati
Genera
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 IResourceMetricCollector.

Parametri
collector IResourceMetricCollector

setSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

Imposta ISandboxFactory, sostituendo eventuali valori esistenti.

setShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

Imposta IShardHelper da utilizzare durante lo sharding di una configurazione.

Parametri
sharding IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

Imposta TradefedFeatureServer.

Parametri
server TradefedFeatureServer

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

Imposta ITerribleFailureHandler.

Parametri
wtfHandler ITerribleFailureHandler: il gestore WTF
Genera
ConfigurationException se è già stato impostato un ITerribleFailureHandler.

configurazione

public abstract void setup ()

Configurazione corretta all'inizio di Tradefed.

Genera
com.android.tradefed.config.ConfigurationException
ConfigurationException

validateOptions

public abstract void validateOptions ()

Convalida i valori delle opzioni.

Al momento, verrà solo verificato che siano state impostate tutte le opzioni obbligatorie

Genera
ConfigurationException se nella configurazione mancano campi obbligatori