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(
Filtra la GlobalConfiguration in base a una lista bianca e genera l'output in un file XML. |
abstract
File
|
cloneConfigWithFilter(
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 |
abstract
Object
|
getConfigurationObject(String typeName)
Restituisce l'oggetto di configurazione personalizzata con il nome specificato. |
abstract
ICredentialFactory
|
getCredentialFactory()
Recupera il |
abstract
DeviceManagementGrpcServer
|
getDeviceManagementServer()
Restituisce |
abstract
IDeviceManager
|
getDeviceManager()
Ottiene 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()
Ottiene il |
abstract
IHostResourceManager
|
getHostResourceManager()
Ottiene il valore |
abstract
IKeyStoreFactory
|
getKeyStoreFactory()
Ottiene il |
abstract
|
getMultiDeviceRecoveryHandlers()
Recupera l'elenco di |
abstract
|
getOptionValues(String optionName)
Ottieni 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 valore |
abstract
TestInvocationManagementServer
|
getTestInvocationManagementSever()
Restituisce |
abstract
ITerribleFailureHandler
|
getWtfHandler()
Ottiene il |
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 |
abstract
void
|
setConfigurationFactory(IConfigurationFactory configFactory)
Imposta il |
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,
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 |
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 il |
abstract
void
|
setKeyStoreFactory(IKeyStoreFactory factory)
Imposta |
abstract
|
setOptionsFromCommandLineArgs(
Imposta i campi
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 il |
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 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 |
Ritorni | |
---|---|
File |
il file contenente la nuova configurazione globale filtrata. |
Lanci | |
---|---|
|
Eccezione IO |
Vedi anche:
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 |
Ritorni | |
---|---|
File |
il file contenente la nuova configurazione globale filtrata. |
Vedi anche:
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 |
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 abstractgetDeviceMonitors ()
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 abstractgetHostMonitors ()
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 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)
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 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. |
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 abstractsetOptionsFromCommandLineArgs ( 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 |