GlobalConfiguration
public class GlobalConfiguration
extends Object
implements IGlobalConfiguration
java.lang.Object | |
↳ | com.android.tradefed.config.GlobalConfiguration |
Uma implementação IGlobalConfiguration
que armazena os objetos de configuração carregados em um mapa
Resumo
Campos | |
---|---|
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
|
Métodos públicos | |
---|---|
void | cleanup () Limpeza adequada quando o desligamento for alimentado. |
File | cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) Filtre o GlobalConfiguration com base em uma lista branca e envie para um arquivo XML. |
File | cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) Filtre o GlobalConfiguration com base em uma lista branca enquanto permite a manipulação de valores de opção e saída para um arquivo XML. |
File | cloneConfigWithFilter (String... allowlistConfigs) Filtre o GlobalConfiguration com base em uma lista permitida e envie para um arquivo XML. |
static | createGlobalConfiguration (String[] args) Configura o singleton |
ICommandScheduler | getCommandScheduler () Obtém o |
Object | getConfigurationObject (String typeName) Obtém o objeto de configuração personalizada com o nome fornecido. |
ICredentialFactory | getCredentialFactory () Obtém o |
String | getDescription () |
DeviceManagementGrpcServer | getDeviceManagementServer () Retorna o |
IDeviceManager | getDeviceManager () Obtém o |
static IDeviceManager | getDeviceManagerInstance () Retorna uma referência à instância |
getDeviceMonitors () Obtém a lista de | |
IDeviceSelection | getDeviceRequirements () Obtém o |
TradefedFeatureServer | getFeatureServer () Retorna o |
IConfigurationServer | getGlobalConfigServer () Obtém o servidor de configuração global. |
static | getHostMonitorInstances () |
getHostMonitors () Obtém a lista de | |
IHostOptions | getHostOptions () Obtém as |
IHostResourceManager | getHostResourceManager () Obtém o |
static IGlobalConfiguration | getInstance () Retorna uma referência à instância singleton |
IKeyStoreFactory | getKeyStoreFactory () Obtém o |
getMultiDeviceRecoveryHandlers () Obtém a lista de | |
String | getName () |
getOptionValues (String optionName) Obtenha uma lista de valores de opção. | |
getResourceMetricCollectors () Obtém a lista de | |
ISandboxFactory | getSandboxFactory () Obtenha uma fábrica de sandbox que pode ser usada para executar uma invocação |
IShardHelper | getShardingStrategy () Retorna o |
TestInvocationManagementServer | getTestInvocationManagementSever () Retorna o |
ITerribleFailureHandler | getWtfHandler () Obtém o |
void | injectOptionValue (String optionName, String optionValue) Injete um valor de opção no conjunto de objetos de configuração. |
void | injectOptionValue (String optionName, String optionKey, String optionValue) Injete um valor de opção no conjunto de objetos de configuração. |
void | printCommandUsage (boolean importantOnly, PrintStream out) Gera um texto de ajuda de uso de linha de comando para esta configuração para determinado printStream. |
void | setCommandScheduler ( ICommandScheduler scheduler) Defina o |
void | setConfigurationFactory ( IConfigurationFactory configFactory) Defina o |
void | setConfigurationObject (String typeName, Object configObject) Método genérico para definir o objeto de configuração com o nome fornecido, substituindo qualquer valor existente. |
void | setConfigurationObjectList (String typeName, configList) setConfigurationObjectList (String typeName, configList) Método genérico para definir a lista de objetos de configuração para o nome fornecido, substituindo qualquer valor existente. |
void | setDeviceManagementServer ( DeviceManagementGrpcServer server) Define o |
void | setDeviceManager ( IDeviceManager manager) Defina o |
void | setDeviceMonitor ( IDeviceMonitor monitor) Defina o |
void | setDeviceRequirements ( IDeviceSelection devRequirements) Defina o |
void | setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors) Defina a lista |
void | setHostOptions ( IHostOptions hostOptions) Defina |
void | setHostResourceManager ( IHostResourceManager hostResourceManager) Defina o |
void | setInvocationServer ( TestInvocationManagementServer server) Define o |
void | setKeyStoreFactory ( IKeyStoreFactory factory) Defina o |
setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs) Defina os campos ArgsOptionParser para o formato esperado | |
void | setOriginalConfig (String config) Define a configuração original usada para criar a configuração global. |
void | setResourceMetricCollector ( IResourceMetricCollector collector) Define o |
void | setSandboxFactory ( ISandboxFactory factory) Defina o |
void | setShardingStrategy ( IShardHelper sharding) Define o |
void | setTradefedFeatureServer ( TradefedFeatureServer server) Define o |
void | setWtfHandler ( ITerribleFailureHandler wtfHandler) Defina o |
void | setup () Configuração adequada no início do tradefed. |
void | validateOptions () Valide os valores das opções. |
Métodos protegidos | |
---|---|
IConfigurationFactory | getConfigurationFactory () |
Campos
CREDENTIAL_FACTORY_TYPE_NAME
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
GLOBAL_CONFIG_SERVER
public static final String GLOBAL_CONFIG_SERVER
GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE
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
SCHEDULER_TYPE_NAME
public static final String SCHEDULER_TYPE_NAME
SARDING_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
WTF_HANDLER_TYPE_NAME
public static final String WTF_HANDLER_TYPE_NAME
Métodos públicos
limpar
public void cleanup ()
Limpeza adequada quando o desligamento for alimentado.
cloneConfigWithFilter
public File cloneConfigWithFilter (exclusionPatterns, String... allowlistConfigs)
Filtre o GlobalConfiguration com base em uma lista branca e envie para um arquivo XML.
Parâmetros | |
---|---|
exclusionPatterns | |
allowlistConfigs | String : uma matriz ERROR(/String) de configurações a serem incluídas no novo arquivo XML. Se estiver definido como null |
devoluções | |
---|---|
File | o arquivo contendo a nova configuração global filtrada. |
cloneConfigWithFilter
public File cloneConfigWithFilter (exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)
Filtre o GlobalConfiguration com base em uma lista branca enquanto permite a manipulação de valores de opção e saída para um arquivo XML.
Parâmetros | |
---|---|
exclusionPatterns | |
transformer | IConfigOptionValueTransformer |
deepCopy | boolean |
allowlistConfigs | String : uma matriz ERROR(/String) de configurações a serem incluídas no novo arquivo XML. Se estiver definido como null |
devoluções | |
---|---|
File | o arquivo contendo a nova configuração global filtrada. |
cloneConfigWithFilter
public File cloneConfigWithFilter (String... allowlistConfigs)
Filtre o GlobalConfiguration com base em uma lista permitida e envie para um arquivo XML.
Por exemplo, para a seguinte configuração: <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>
todas as configurações, exceto "key_store", serão filtradas e resultarão em um arquivo de configuração com o seguinte conteúdo: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>
Parâmetros | |
---|---|
allowlistConfigs | String : uma matriz ERROR(/String) de configurações a serem incluídas no novo arquivo XML. Se estiver definido como null |
devoluções | |
---|---|
File | o arquivo contendo a nova configuração global filtrada. |
createGlobalConfiguration
public staticcreateGlobalConfiguration (String[] args)
Configura o singleton GlobalConfiguration
para esta instância TF. Deve ser chamado uma vez e apenas uma vez, antes de qualquer tentativa de chamar getInstance()
Parâmetros | |
---|---|
args | String |
devoluções | |
---|---|
lances | |
---|---|
| se for chamado mais de uma vez |
ConfigurationException |
getCommandScheduler
public ICommandScheduler getCommandScheduler ()
Obtém o ICommandScheduler
a ser usado na configuração.
devoluções | |
---|---|
ICommandScheduler | o ICommandScheduler . Nunca retornará nulo. |
getConfigurationObject
public Object getConfigurationObject (String typeName)
Obtém o objeto de configuração personalizada com o nome fornecido.
Parâmetros | |
---|---|
typeName | String : o tipo único do objeto de configuração |
devoluções | |
---|---|
Object | o objeto ou nulo se o objeto com esse nome não for encontrado |
getCredentialFactory
public ICredentialFactory getCredentialFactory ()
Obtém o ICredentialFactory
para criar credenciais.
devoluções | |
---|---|
ICredentialFactory | ICredentialFactory ou null se nenhum foi especificado. |
getDescription
public String getDescription ()
devoluções | |
---|---|
String | uma breve descrição legível pelo usuário desta Configuration |
getDeviceManagementServer
public DeviceManagementGrpcServer getDeviceManagementServer ()
Retorna o DeviceManagementGrpcServer
ou nulo se indefinido.
devoluções | |
---|---|
DeviceManagementGrpcServer |
getDeviceManager
public IDeviceManager getDeviceManager ()
Obtém o IDeviceManager
para usar na configuração. Gerencia o conjunto de dispositivos disponíveis para teste
devoluções | |
---|---|
IDeviceManager | o IDeviceManager fornecido na configuração. |
getDeviceManagerInstance
public static IDeviceManager getDeviceManagerInstance ()
Retorna uma referência à instância DeviceManager
singleton para esta instância do TF.
devoluções | |
---|---|
IDeviceManager |
lances | |
---|---|
| se createGlobalConfiguration(String[]) ainda não tiver sido chamado. |
getDeviceMonitors
publicgetDeviceMonitors ()
Obtém a lista de IDeviceMonitor
da configuração global.
devoluções | |
---|---|
a lista de IDeviceMonitor da configuração global ou null se nenhum foi especificado. |
getDeviceRequirements
public IDeviceSelection getDeviceRequirements ()
Obtém o IDeviceSelection
a ser usado na configuração. Representa um filtro global em quais dispositivos o DeviceManager
pode ver.
devoluções | |
---|---|
IDeviceSelection | o IDeviceSelection fornecido na configuração. |
getFeatureServer
public TradefedFeatureServer getFeatureServer ()
Retorna o TradefedFeatureServer
ou nulo se indefinido.
devoluções | |
---|---|
TradefedFeatureServer |
getGlobalConfigServer
public IConfigurationServer getGlobalConfigServer ()
Obtém o servidor de configuração global. O servidor de configuração global é usado para obter configurações de host de um servidor em vez de obtê-lo de arquivos locais.
devoluções | |
---|---|
IConfigurationServer |
getHostMonitorInstances
public staticgetHostMonitorInstances ()
devoluções | |
---|---|
getHostMonitors
publicgetHostMonitors ()
Obtém a lista de IHostMonitor
da configuração global.
devoluções | |
---|---|
a lista de IHostMonitor da configuração global ou null se nenhum foi especificado. |
getHostOptions
public IHostOptions getHostOptions ()
Obtém as IHostOptions
a serem usadas na configuração.
devoluções | |
---|---|
IHostOptions | o IDeviceManager fornecido na configuração. |
getHostResourceManager
public IHostResourceManager getHostResourceManager ()
Obtém o IHostResourceManager
da configuração global.
devoluções | |
---|---|
IHostResourceManager | o IHostResourceManager da configuração global ou implementação padrão LocalHostResourceManager se nenhum for especificado na configuração do host. |
getInstance
public static IGlobalConfiguration getInstance ()
Retorna uma referência à instância singleton GlobalConfiguration
para esta instância TF.
devoluções | |
---|---|
IGlobalConfiguration |
lances | |
---|---|
| se createGlobalConfiguration(String[]) ainda não tiver sido chamado. |
getKeyStoreFactory
public IKeyStoreFactory getKeyStoreFactory ()
Obtém o IKeyStoreFactory
a ser usado na configuração.
devoluções | |
---|---|
IKeyStoreFactory | o IKeyStoreFactory ou nulo se nenhuma fábrica de armazenamento de chaves estiver definida. |
getMultiDeviceRecoveryHandlers
publicgetMultiDeviceRecoveryHandlers ()
Obtém a lista de IMultiDeviceRecovery
a ser usada na configuração.
devoluções | |
---|---|
a lista de IMultiDeviceRecovery ou null se não estiver definido. |
getOptionValues
publicgetOptionValues (String optionName)
Obtenha uma lista de valores de opção.
Parâmetros | |
---|---|
optionName | String : o nome da opção do mapa |
devoluções | |
---|---|
uma lista dos valores da opção dada. null se o nome da opção não existir. |
getResourceMetricCollectors
publicgetResourceMetricCollectors ()
Obtém a lista de IResourceMetricCollector
da configuração global.
devoluções | |
---|---|
a lista de IResourceMetricCollector da configuração global ou null se nenhum foi especificado. |
getSandboxFactory
public ISandboxFactory getSandboxFactory ()
Obtenha uma fábrica de sandbox que pode ser usada para executar uma invocação
devoluções | |
---|---|
ISandboxFactory |
getShardingStrategy
public IShardHelper getShardingStrategy ()
Retorna o IShardHelper
que define a maneira de fragmentar uma configuração.
devoluções | |
---|---|
IShardHelper |
getTestInvocationManagementSever
public TestInvocationManagementServer getTestInvocationManagementSever ()
Retorna o TestInvocationManagementServer
ou nulo se indefinido.
devoluções | |
---|---|
TestInvocationManagementServer |
getWtfHandler
public ITerribleFailureHandler getWtfHandler ()
Obtém o ITerribleFailureHandler
para usar na configuração. Lida com o que fazer no caso de ocorrer um WTF (What a Terrible Failure).
devoluções | |
---|---|
ITerribleFailureHandler | o ITerribleFailureHandler fornecido na configuração ou nulo se nenhum manipulador for definido |
injectOptionValue
public void injectOptionValue (String optionName, String optionValue)
Injete um valor de opção no conjunto de objetos de configuração.
Útil para fornecer valores para opções que são geradas dinamicamente.Parâmetros | |
---|---|
optionName | String : o nome da opção |
optionValue | String : o(s) valor(es) da opção |
lances | |
---|---|
ConfigurationException |
injectOptionValue
public void injectOptionValue (String optionName, String optionKey, String optionValue)
Injete um valor de opção no conjunto de objetos de configuração.
Útil para fornecer valores para opções que são geradas dinamicamente.Parâmetros | |
---|---|
optionName | String : o nome da opção do mapa |
optionKey | String : a chave de opção do mapa |
optionValue | String : o valor da opção do mapa |
lances | |
---|---|
ConfigurationException |
printCommandUsage
public void printCommandUsage (boolean importantOnly, PrintStream out)
Gera um texto de ajuda de uso de linha de comando para esta configuração para determinado printStream.
Parâmetros | |
---|---|
importantOnly | boolean |
out | PrintStream : o ERROR(/PrintStream) a ser usado. |
lances | |
---|---|
| com.android.tradefed.config.ConfigurationException |
ConfigurationException |
setCommandScheduler
public void setCommandScheduler (ICommandScheduler scheduler)
Defina o ICommandScheduler
, substituindo quaisquer valores existentes.
setConfigurationFactory
public void setConfigurationFactory (IConfigurationFactory configFactory)
Defina o IConfigurationFactory
para esta configuração.
Parâmetros | |
---|---|
configFactory | IConfigurationFactory |
setConfigurationObject
public void setConfigurationObject (String typeName, Object configObject)
Método genérico para definir o objeto de configuração com o nome fornecido, substituindo qualquer valor existente.
Parâmetros | |
---|---|
typeName | String : o nome exclusivo do tipo de objeto de configuração. |
configObject | Object : o objeto de configuração |
lances | |
---|---|
ConfigurationException |
setConfigurationObjectList
public void setConfigurationObjectList (String typeName,configList)
Método genérico para definir a lista de objetos de configuração para o nome fornecido, substituindo qualquer valor existente.
Parâmetros | |
---|---|
typeName | String : o nome exclusivo do tipo de objeto de configuração. |
configList |
lances | |
---|---|
ConfigurationException |
setDeviceManagementServer
public void setDeviceManagementServer (DeviceManagementGrpcServer server)
Define o DeviceManagementGrpcServer
.
Parâmetros | |
---|---|
server | DeviceManagementGrpcServer |
setDeviceManager
public void setDeviceManager (IDeviceManager manager)
Defina o IDeviceManager
, substituindo quaisquer valores existentes. Isso define o gerenciador para os dispositivos de teste
definirDeviceMonitor
public void setDeviceMonitor (IDeviceMonitor monitor)
Defina o IDeviceMonitor
.
Parâmetros | |
---|---|
monitor | IDeviceMonitor : O monitor |
setDeviceRequirements
public void setDeviceRequirements (IDeviceSelection devRequirements)
Defina o IDeviceSelection
, substituindo quaisquer valores existentes. Isso define um filtro de dispositivo global em quais dispositivos o DeviceManager
pode ver.
setHostMonitors
public void setHostMonitors (hostMonitors)
Defina a lista IHostMonitor
.
Parâmetros | |
---|---|
hostMonitors |
setHostOptions
public void setHostOptions (IHostOptions hostOptions)
Defina IHostOptions
, substituindo quaisquer valores existentes.
setHostResourceManager
public void setHostResourceManager (IHostResourceManager hostResourceManager)
Defina o IHostResourceManager
, substituindo quaisquer valores existentes.
setInvocationServer
public void setInvocationServer (TestInvocationManagementServer server)
Define o TestInvocationManagementServer
.
Parâmetros | |
---|---|
server | TestInvocationManagementServer |
setKeyStoreFactory
public void setKeyStoreFactory (IKeyStoreFactory factory)
Defina o IKeyStoreFactory
, substituindo quaisquer valores existentes.
setOptionsFromCommandLineArgs
publicsetOptionsFromCommandLineArgs ( listArgs)
Defina os campos Option
de configuração global com determinado conjunto de argumentos de linha de comando
ArgsOptionParser
para o formato esperadoParâmetros | |
---|---|
listArgs |
devoluções | |
---|---|
os argumentos não consumidos |
lances | |
---|---|
ConfigurationException |
setOriginalConfig
public void setOriginalConfig (String config)
Define a configuração original usada para criar a configuração global.
Parâmetros | |
---|---|
config | String |
setResourceMetricCollector
public void setResourceMetricCollector (IResourceMetricCollector collector)
Define o IResourceMetricCollector
.
Parâmetros | |
---|---|
collector | IResourceMetricCollector |
setSandboxFactory
public void setSandboxFactory (ISandboxFactory factory)
Defina o ISandboxFactory
, substituindo quaisquer valores existentes.
setShardingStrategy
public void setShardingStrategy (IShardHelper sharding)
Define o IShardHelper
a ser usado ao fragmentar uma configuração.
Parâmetros | |
---|---|
sharding | IShardHelper |
setTradefedFeatureServer
public void setTradefedFeatureServer (TradefedFeatureServer server)
Define o TradefedFeatureServer
.
Parâmetros | |
---|---|
server | TradefedFeatureServer |
setWtfHandler
public void setWtfHandler (ITerribleFailureHandler wtfHandler)
Defina o ITerribleFailureHandler
.
Parâmetros | |
---|---|
wtfHandler | ITerribleFailureHandler : o manipulador WTF |
configurar
public void setup ()
Configuração adequada no início do tradefed.
lances | |
---|---|
ConfigurationException |
validaropções
public void validateOptions ()
Valide os valores das opções.
Atualmente, isso apenas validará que todas as opções obrigatórias foram definidas
lances | |
---|---|
ConfigurationException |
Métodos protegidos
getConfigurationFactory
protected IConfigurationFactory getConfigurationFactory ()
devoluções | |
---|---|
IConfigurationFactory |