IGlobalConfiguration
public
interface
IGlobalConfiguration
com.android.tradefed.config.IGlobalConfiguration |
Una classe che comprende informazioni di configurazione globali per una singola istanza della Trade Federation (che comprende un numero qualsiasi di chiamate di configurazioni effettive).
Riepilogo
Metodi pubblici | |
---|---|
abstract
void
|
cleanup()
Pulizia corretta al termine dell'arresto di TradeFed. |
abstract
File
|
cloneConfigWithFilter(
Filtra la GlobalConfiguration in base a una lista bianca e genera l'output in un file XML. |
abstract
File
|
cloneConfigWithFilter(
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. |
abstract
File
|
cloneConfigWithFilter(String... allowlistConfigs)
Filtra GlobalConfiguration in base a un elenco consentito e salva l'output in un file XML. |
abstract
ICommandScheduler
|
getCommandScheduler()
Recupera il |
abstract
Object
|
getConfigurationObject(String typeName)
Recupera l'oggetto di configurazione personalizzata con il nome specificato. |
abstract
ICredentialFactory
|
getCredentialFactory()
Recupera il |
abstract
DeviceManagementGrpcServer
|
getDeviceManagementServer()
Restituisce |
abstract
IDeviceManager
|
getDeviceManager()
Recupera il |
abstract
|
getDeviceMonitors()
Recupera l'elenco di |
abstract
IDeviceSelection
|
getDeviceRequirements()
Ottiene il |
abstract
TradefedFeatureServer
|
getFeatureServer()
Restituisce |
abstract
IConfigurationServer
|
getGlobalConfigServer()
Recupera il server di configurazione globale. |
abstract
|
getHostMonitors()
Recupera l'elenco di |
abstract
IHostOptions
|
getHostOptions()
Recupera il |
abstract
IHostResourceManager
|
getHostResourceManager()
Recupera |
abstract
IKeyStoreFactory
|
getKeyStoreFactory()
Recupera il |
abstract
|
getMultiDeviceRecoveryHandlers()
Recupera l'elenco di |
abstract
|
getOptionValues(String optionName)
Visualizza un elenco dei valori dell'opzione. |
abstract
|
getResourceMetricCollectors()
Recupera l'elenco di |
abstract
ISandboxFactory
|
getSandboxFactory()
Ottieni una sandbox di fabbrica che possa essere utilizzata per eseguire una chiamata |
abstract
IShardHelper
|
getShardingStrategy()
Restituisce il |
abstract
TestInvocationManagementServer
|
getTestInvocationManagementSever()
Restituisce |
abstract
ITerribleFailureHandler
|
getWtfHandler()
Recupera il |
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 |
abstract
void
|
setConfigurationFactory(IConfigurationFactory configFactory)
Imposta il |
abstract
void
|
setConfigurationObject(String name, Object configObject)
Metodo generico per impostare l'oggetto config con il nome specificato, sostituendo qualsiasi valore esistente. |
abstract
void
|
setConfigurationObjectList(String typeName,
Metodo generico per impostare l'elenco di oggetti di configurazione per il nome specificato, sostituendo eventuali valori esistenti. |
abstract
void
|
setDeviceManagementServer(DeviceManagementGrpcServer server)
Imposta il |
abstract
void
|
setDeviceManager(IDeviceManager deviceManager)
Imposta |
abstract
void
|
setDeviceMonitor(IDeviceMonitor deviceMonitor)
Imposta |
abstract
void
|
setDeviceRequirements(IDeviceSelection deviceSelection)
Imposta |
abstract
void
|
setHostMonitors(
Imposta l'elenco |
abstract
void
|
setHostOptions(IHostOptions hostOptions)
Imposta |
abstract
void
|
setHostResourceManager(IHostResourceManager hostResourceManager)
Imposta |
abstract
void
|
setInvocationServer(TestInvocationManagementServer server)
Imposta |
abstract
void
|
setKeyStoreFactory(IKeyStoreFactory factory)
Imposta |
abstract
|
setOptionsFromCommandLineArgs(
Imposta i campi di configurazione globale
Consulta |
abstract
void
|
setOriginalConfig(String config)
Imposta la configurazione originale utilizzata per creare la configurazione globale. |
abstract
void
|
setResourceMetricCollector(IResourceMetricCollector collector)
Imposta il |
abstract
void
|
setSandboxFactory(ISandboxFactory factory)
Imposta |
abstract
void
|
setShardingStrategy(IShardHelper sharding)
Imposta |
abstract
void
|
setTradefedFeatureServer(TradefedFeatureServer server)
Imposta il |
abstract
void
|
setWtfHandler(ITerribleFailureHandler wtfHandler)
Imposta |
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 al termine dell'arresto di TradeFed.
cloneConfigWithFilter
public abstract 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 di configurazioni String da includere nel nuovo file XML.
Se è impostato su null |
Ritorni | |
---|---|
File |
il file contenente la nuova configurazione globale filtrata. |
Lanci | |
---|---|
|
IOException |
Vedi anche:
cloneConfigWithFilter
public abstract 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 String di configurazioni da includere nel nuovo file XML.
Se è impostato su null |
Ritorni | |
---|---|
File |
Il file contenente la nuova configurazione globale filtrata. |
Vedi anche:
cloneConfigWithFilter
public abstract 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 |
Ritorni | |
---|---|
File |
il file contenente la nuova configurazione globale filtrata. |
Lanci | |
---|---|
|
Eccezione IO |
getCommandScheduler
public abstract ICommandScheduler getCommandScheduler ()
Recupera il ICommandScheduler
da utilizzare dalla configurazione.
Ritorni | |
---|---|
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 : tipo univoco dell'oggetto di configurazione |
Ritorni | |
---|---|
Object |
l'oggetto o null 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 è stato specificato nessuno. |
getDeviceManagementServer
public abstract DeviceManagementGrpcServer getDeviceManagementServer ()
Restituisce DeviceManagementGrpcServer
o null se non definito.
Ritorni | |
---|---|
DeviceManagementGrpcServer |
getDeviceManager
public abstract IDeviceManager getDeviceManager ()
Recupera il IDeviceManager
da utilizzare dalla configurazione. Gestisce l'insieme di dispositivi disponibili per i test
Ritorni | |
---|---|
IDeviceManager |
IDeviceManager fornito nella configurazione. |
getDeviceMonitors
public abstractgetDeviceMonitors ()
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 abstract IDeviceSelection getDeviceRequirements ()
Ottiene il IDeviceSelection
da utilizzare dalla configurazione. Rappresenta un filtro globale su quali dispositivi DeviceManager
può essere visualizzato.
Ritorni | |
---|---|
IDeviceSelection |
il 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 abstractgetHostMonitors ()
Recupera l'elenco di IHostMonitor
dalla configurazione globale.
Ritorni | |
---|---|
|
l'elenco di IHostMonitor dalla configurazione globale o null se non è stato specificato alcun valore. |
getHostOpzioni
public abstract IHostOptions getHostOptions ()
Ottiene il IHostOptions
da utilizzare dalla configurazione.
Ritorni | |
---|---|
IHostOptions |
il IDeviceManager fornito nella configurazione. |
getHostResourceManager
public abstract IHostResourceManager getHostResourceManager ()
Recupera IHostResourceManager
dalla configurazione globale.
Ritorni | |
---|---|
IHostResourceManager |
il IHostResourceManager dalla configurazione globale o l'implementazione predefinita
LocalHostResourceManager se non ne è specificato nessuno nella configurazione dell'host. |
getKeyStoreFactory
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. |
getMultiDeviceRecoveryHandlers
public abstractgetMultiDeviceRecoveryHandlers ()
Recupera l'elenco di IMultiDeviceRecovery
da utilizzare dalla configurazione.
Ritorni | |
---|---|
|
l'elenco di IMultiDeviceRecovery o null se non impostato. |
getOptionValues
public abstractgetOptionValues (String optionName)
Visualizza 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 abstractgetResourceMetricCollectors ()
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 abstract ISandboxFactory getSandboxFactory ()
Ottieni una factory sandbox che può essere utilizzata per eseguire un'invocazione
Ritorni | |
---|---|
ISandboxFactory |
getShardingStrategy
public abstract IShardHelper getShardingStrategy ()
Restituisce il IShardHelper
che definisce il modo di suddividere una configurazione.
Ritorni | |
---|---|
IShardHelper |
getTestInvocationManagementSever
public abstract TestInvocationManagementServer getTestInvocationManagementSever ()
Restituisce TestInvocationManagementServer
o null se non definito.
Ritorni | |
---|---|
TestInvocationManagementServer |
getWtfHandler
public abstract ITerribleFailureHandler getWtfHandler ()
Recupera 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 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 : 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 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 di opzione della mappa. |
optionValue |
String : il valore dell'opzione della mappa |
Lanci | |
---|---|
ConfigurationException |
if failed to set the option's value |
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 config con il nome specificato, sostituendo qualsiasi valore esistente.
Parametri | |
---|---|
name |
String : il nome univoco del tipo di oggetto di configurazione. |
configObject |
Object : l'oggetto config |
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 valori esistenti.
Parametri | |
---|---|
typeName |
String : il nome univoco del tipo di oggetto di configurazione. |
configList |
: l'elenco di oggetti di configurazione |
Lanci | |
---|---|
ConfigurationException |
se gli 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. Viene impostato il gestore per i 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 eventuali valori esistenti. Viene impostato un
filtro dei dispositivi globali che 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 . |
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 il TestInvocationManagementServer
.
Parametri | |
---|---|
server |
TestInvocationManagementServer |
setKeyStoreFactory
public abstract void setKeyStoreFactory (IKeyStoreFactory factory)
Imposta IKeyStoreFactory
, sostituendo i valori esistenti.
setOptionsFromCommandLineArgs
public abstractsetOptionsFromCommandLineArgs ( 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 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 |
setSandboxfabbrica
public abstract void setSandboxFactory (ISandboxFactory factory)
Imposta ISandboxFactory
, sostituendo eventuali valori esistenti.
setShardingStrategy
public abstract void setShardingStrategy (IShardHelper sharding)
Imposta IShardHelper
da utilizzare per 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 |
Lanci | |
---|---|
ConfigurationException |
se è stato già impostato un valore ITerribleFailureHandler . |
configura
public abstract void setup ()
Configurazione corretta all'inizio di tradefed.
Lanci | |
---|---|
|
com.android.tradefed.config.ConfigurationException |
ConfigurationException |
validateOptions
public abstract void validateOptions ()
Convalida i valori delle opzioni.
Al momento, viene solo convalidato che tutte le opzioni obbligatorie sono state impostate
Lanci | |
---|---|
ConfigurationException |
if configuration is missing mandatory fields |