Configuración global
public class GlobalConfiguration
extends Object
implements IGlobalConfiguration
java.lang.Objeto | |
↳ | com.android.tradefed.config.GlobalConfiguration |
Una implementación IGlobalConfiguration
que almacena los objetos de configuración cargados en un mapa
Resumen
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 () Limpieza adecuada cuando se apaga el comercio. |
File | cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) Filtre la configuración global según una lista blanca y envíela a un archivo XML. |
File | cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) Filtre la configuración global según una lista blanca y al mismo tiempo permita la manipulación de los valores de las opciones y la salida a un archivo XML. |
File | cloneConfigWithFilter (String... allowlistConfigs) Filtre la configuración global según una lista permitida y envíela a un archivo XML. |
static | createGlobalConfiguration (String[] args) Configura el singleton |
ICommandScheduler | getCommandScheduler () Obtiene el |
Object | getConfigurationObject (String typeName) Obtiene el objeto de configuración personalizado con el nombre de pila. |
ICredentialFactory | getCredentialFactory () Obtiene |
String | getDescription () |
DeviceManagementGrpcServer | getDeviceManagementServer () Devuelve |
IDeviceManager | getDeviceManager () Obtiene el |
static IDeviceManager | getDeviceManagerInstance () Devuelve una referencia a la instancia única |
getDeviceMonitors () Obtiene la lista de | |
IDeviceSelection | getDeviceRequirements () Obtiene el |
TradefedFeatureServer | getFeatureServer () Devuelve |
IConfigurationServer | getGlobalConfigServer () Obtiene el servidor de configuración global. |
static | getHostMonitorInstances () |
getHostMonitors () Obtiene la lista de | |
IHostOptions | getHostOptions () Obtiene las |
IHostResourceManager | getHostResourceManager () Obtiene |
static IGlobalConfiguration | getInstance () Devuelve una referencia a la instancia singleton |
IKeyStoreFactory | getKeyStoreFactory () Obtiene |
getMultiDeviceRecoveryHandlers () Obtiene la lista de | |
String | getName () |
getOptionValues (String optionName) Obtenga una lista de los valores de las opciones. | |
getResourceMetricCollectors () Obtiene la lista de | |
ISandboxFactory | getSandboxFactory () Obtenga una fábrica de espacio aislado que pueda usarse para ejecutar una invocación |
IShardHelper | getShardingStrategy () Devuelve |
TestInvocationManagementServer | getTestInvocationManagementSever () Devuelve |
ITerribleFailureHandler | getWtfHandler () Obtiene el |
void | injectOptionValue (String optionName, String optionValue) Inyecte un valor de opción en el conjunto de objetos de configuración. |
void | injectOptionValue (String optionName, String optionKey, String optionValue) Inyecte un valor de opción en el conjunto de objetos de configuración. |
void | printCommandUsage (boolean importantOnly, PrintStream out) Genera un texto de ayuda sobre el uso de la línea de comandos para esta configuración en printStream determinado. |
void | setCommandScheduler ( ICommandScheduler scheduler) Configure |
void | setConfigurationFactory ( IConfigurationFactory configFactory) Establezca |
void | setConfigurationObject (String typeName, Object configObject) Método genérico para configurar el objeto de configuración con el nombre dado, reemplazando cualquier valor existente. |
void | setConfigurationObjectList (String typeName, configList) setConfigurationObjectList (String typeName, configList) Método genérico para establecer la lista de objetos de configuración para el nombre dado, reemplazando cualquier valor existente. |
void | setDeviceManagementServer ( DeviceManagementGrpcServer server) Establece |
void | setDeviceManager ( IDeviceManager manager) Configure |
void | setDeviceMonitor ( IDeviceMonitor monitor) Configure el |
void | setDeviceRequirements ( IDeviceSelection devRequirements) Establezca |
void | setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors) Configure la lista |
void | setHostOptions ( IHostOptions hostOptions) Configure |
void | setHostResourceManager ( IHostResourceManager hostResourceManager) Configure |
void | setInvocationServer ( TestInvocationManagementServer server) Establece |
void | setKeyStoreFactory ( IKeyStoreFactory factory) Configure |
setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs) Establezca los campos ArgsOptionParser para conocer el formato esperado. | |
void | setOriginalConfig (String config) Establece la configuración original utilizada para crear la configuración global. |
void | setResourceMetricCollector ( IResourceMetricCollector collector) Establece |
void | setSandboxFactory ( ISandboxFactory factory) Establezca |
void | setShardingStrategy ( IShardHelper sharding) Establece |
void | setTradefedFeatureServer ( TradefedFeatureServer server) Establece |
void | setWtfHandler ( ITerribleFailureHandler wtfHandler) Configure |
void | setup () Configuración adecuada al inicio de tradefed. |
void | validateOptions () Validar los valores de las opciones. |
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
SHARDING_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
limpiar
public void cleanup ()
Limpieza adecuada cuando se apaga el comercio.
cloneConfigWithFilter
public File cloneConfigWithFilter (exclusionPatterns, String... allowlistConfigs)
Filtre la configuración global según una lista blanca y envíela a un archivo XML.
Parámetros | |
---|---|
exclusionPatterns | |
allowlistConfigs | String : una matriz String de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null |
Devoluciones | |
---|---|
File | el archivo que contiene la nueva configuración global filtrada. |
cloneConfigWithFilter
public File cloneConfigWithFilter (exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)
Filtre la configuración global según una lista blanca y al mismo tiempo permita la manipulación de los valores de las opciones y la salida a un archivo XML.
Parámetros | |
---|---|
exclusionPatterns | |
transformer | IConfigOptionValueTransformer |
deepCopy | boolean |
allowlistConfigs | String : una matriz String de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null |
Devoluciones | |
---|---|
File | el archivo que contiene la nueva configuración global filtrada. |
cloneConfigWithFilter
public File cloneConfigWithFilter (String... allowlistConfigs)
Filtre la configuración global según una lista permitida y envíela a un archivo XML.
Por ejemplo, para la siguiente configuración: <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 las configuraciones excepto "key_store" se filtrarán y el resultado será un archivo de configuración con el siguiente contenido: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>
Parámetros | |
---|---|
allowlistConfigs | String : una matriz String de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null |
Devoluciones | |
---|---|
File | el archivo que contiene la nueva configuración global filtrada. |
crear configuración global
public staticcreateGlobalConfiguration (String[] args)
Configura el singleton GlobalConfiguration
para esta instancia de TF. Debe llamarse una vez y sólo una vez, antes de que algo intente llamar getInstance()
Parámetros | |
---|---|
args | String |
Devoluciones | |
---|---|
Lanza | |
---|---|
IllegalStateException | si te llaman más de una vez |
ConfigurationException |
obtenerCommandScheduler
public ICommandScheduler getCommandScheduler ()
Obtiene el ICommandScheduler
que se utilizará desde la configuración.
Devoluciones | |
---|---|
ICommandScheduler | el ICommandScheduler . Nunca devolverá nulo. |
obtener objeto de configuración
public Object getConfigurationObject (String typeName)
Obtiene el objeto de configuración personalizado con el nombre de pila.
Parámetros | |
---|---|
typeName | String : el tipo único del objeto de configuración. |
Devoluciones | |
---|---|
Object | el objeto o nulo si no se encuentra el objeto con ese nombre |
obtenerCredentialFactory
public ICredentialFactory getCredentialFactory ()
Obtiene ICredentialFactory
para crear credenciales.
Devoluciones | |
---|---|
ICredentialFactory | ICredentialFactory o null si no se especificó ninguno. |
obtener descripción
public String getDescription ()
Devoluciones | |
---|---|
String | una breve descripción legible por el usuario de esta Configuration |
getDeviceManagementServer
public DeviceManagementGrpcServer getDeviceManagementServer ()
Devuelve DeviceManagementGrpcServer
o nulo si no está definido.
Devoluciones | |
---|---|
DeviceManagementGrpcServer |
obtenerAdministrador de dispositivos
public IDeviceManager getDeviceManager ()
Obtiene el IDeviceManager
que se utilizará desde la configuración. Gestiona el conjunto de dispositivos disponibles para realizar pruebas.
Devoluciones | |
---|---|
IDeviceManager | el IDeviceManager proporcionado en la configuración. |
getDeviceManagerInstancia
public static IDeviceManager getDeviceManagerInstance ()
Devuelve una referencia a la instancia única DeviceManager
para esta instancia de TF.
Devoluciones | |
---|---|
IDeviceManager |
Lanza | |
---|---|
IllegalStateException | si aún no se ha llamado createGlobalConfiguration(String[]) . |
getDeviceMonitores
publicgetDeviceMonitors ()
Obtiene la lista de IDeviceMonitor
de la configuración global.
Devoluciones | |
---|---|
la lista de IDeviceMonitor de la configuración global, o null si no se especificó ninguno. |
obtener requisitos del dispositivo
public IDeviceSelection getDeviceRequirements ()
Obtiene el IDeviceSelection
que se utilizará desde la configuración. Representa un filtro global sobre qué dispositivos puede ver el DeviceManager
.
Devoluciones | |
---|---|
IDeviceSelection | el IDeviceSelection proporcionado en la configuración. |
obtener servidor de funciones
public TradefedFeatureServer getFeatureServer ()
Devuelve TradefedFeatureServer
o nulo si no está definido.
Devoluciones | |
---|---|
TradefedFeatureServer |
obtenerGlobalConfigServer
public IConfigurationServer getGlobalConfigServer ()
Obtiene el servidor de configuración global. El servidor de configuración global se utiliza para obtener configuraciones de host de un servidor en lugar de obtenerlas de archivos locales.
Devoluciones | |
---|---|
IConfigurationServer |
getHostMonitorInstancias
public staticgetHostMonitorInstances ()
Devoluciones | |
---|---|
getHostMonitores
publicgetHostMonitors ()
Obtiene la lista de IHostMonitor
de la configuración global.
Devoluciones | |
---|---|
la lista de IHostMonitor de la configuración global, o null si no se especificó ninguno. |
getHostOptions
public IHostOptions getHostOptions ()
Obtiene las IHostOptions
que se utilizarán desde la configuración.
Devoluciones | |
---|---|
IHostOptions | el IDeviceManager proporcionado en la configuración. |
obtenerHostResourceManager
public IHostResourceManager getHostResourceManager ()
Obtiene IHostResourceManager
de la configuración global.
Devoluciones | |
---|---|
IHostResourceManager | el IHostResourceManager de la configuración global, o la implementación predeterminada LocalHostResourceManager si no se especifica ninguno en la configuración del host. |
obtener Instancia
public static IGlobalConfiguration getInstance ()
Devuelve una referencia a la instancia singleton GlobalConfiguration
para esta instancia TF.
Devoluciones | |
---|---|
IGlobalConfiguration |
Lanza | |
---|---|
IllegalStateException | si aún no se ha llamado createGlobalConfiguration(String[]) . |
getKeyStoreFábrica
public IKeyStoreFactory getKeyStoreFactory ()
Obtiene IKeyStoreFactory
para usar desde la configuración.
Devoluciones | |
---|---|
IKeyStoreFactory | IKeyStoreFactory o nulo si no se establece ninguna fábrica de almacén de claves. |
getMultiDeviceRecoveryHandlers
publicgetMultiDeviceRecoveryHandlers ()
Obtiene la lista de IMultiDeviceRecovery
para usar desde la configuración.
Devoluciones | |
---|---|
la lista de IMultiDeviceRecovery , o null si no está configurado. |
getOptionValues
publicgetOptionValues (String optionName)
Obtenga una lista de los valores de las opciones.
Parámetros | |
---|---|
optionName | String : el nombre de la opción del mapa. |
Devoluciones | |
---|---|
una lista de los valores de la opción dada. null si el nombre de la opción no existe. |
getResourceMetricCollectors
publicgetResourceMetricCollectors ()
Obtiene la lista de IResourceMetricCollector
de la configuración global.
Devoluciones | |
---|---|
la lista de IResourceMetricCollector de la configuración global o null si no se especificó ninguno. |
obtenerSandboxFactory
public ISandboxFactory getSandboxFactory ()
Obtenga una fábrica de espacio aislado que pueda usarse para ejecutar una invocación
Devoluciones | |
---|---|
ISandboxFactory |
getShardingStrategy
public IShardHelper getShardingStrategy ()
Devuelve IShardHelper
que define la forma de fragmentar una configuración.
Devoluciones | |
---|---|
IShardHelper |
getTestInvocationManagementSever
public TestInvocationManagementServer getTestInvocationManagementSever ()
Devuelve TestInvocationManagementServer
o nulo si no está definido.
Devoluciones | |
---|---|
TestInvocationManagementServer |
getWtfHandler
public ITerribleFailureHandler getWtfHandler ()
Obtiene el ITerribleFailureHandler
para usar desde la configuración. Maneja qué hacer en caso de que ocurra un WTF (Qué terrible falla).
Devoluciones | |
---|---|
ITerribleFailureHandler | el ITerribleFailureHandler proporcionado en la configuración, o nulo si no se establece ningún controlador |
inyectarValorOpción
public void injectOptionValue (String optionName, String optionValue)
Inyecte un valor de opción en el conjunto de objetos de configuración.
Útil para proporcionar valores para opciones que se generan dinámicamente.Parámetros | |
---|---|
optionName | String : el nombre de la opción |
optionValue | String : los valores de la opción |
Lanza | |
---|---|
ConfigurationException |
inyectarValorOpción
public void injectOptionValue (String optionName, String optionKey, String optionValue)
Inyecte un valor de opción en el conjunto de objetos de configuración.
Útil para proporcionar valores para opciones que se generan dinámicamente.Parámetros | |
---|---|
optionName | String : el nombre de la opción del mapa. |
optionKey | String : la clave de opción del mapa |
optionValue | String : el valor de la opción del mapa. |
Lanza | |
---|---|
ConfigurationException |
imprimirComandoUso
public void printCommandUsage (boolean importantOnly, PrintStream out)
Genera un texto de ayuda sobre el uso de la línea de comandos para esta configuración en printStream determinado.
Parámetros | |
---|---|
importantOnly | boolean |
out | PrintStream : el ERROR(/PrintStream) a utilizar. |
Lanza | |
---|---|
| com.android.tradefed.config.ConfigurationException |
ConfigurationException |
establecerCommandScheduler
public void setCommandScheduler (ICommandScheduler scheduler)
Configure ICommandScheduler
y reemplace los valores existentes.
setConfigurationFactory
public void setConfigurationFactory (IConfigurationFactory configFactory)
Establezca IConfigurationFactory
para esta configuración.
Parámetros | |
---|---|
configFactory | IConfigurationFactory |
establecerConfiguraciónObjeto
public void setConfigurationObject (String typeName, Object configObject)
Método genérico para configurar el objeto de configuración con el nombre dado, reemplazando cualquier valor existente.
Parámetros | |
---|---|
typeName | String : el nombre único del tipo de objeto de configuración. |
configObject | Object : el objeto de configuración |
Lanza | |
---|---|
ConfigurationException |
setConfigurationObjectList
public void setConfigurationObjectList (String typeName,configList)
Método genérico para establecer la lista de objetos de configuración para el nombre dado, reemplazando cualquier valor existente.
Parámetros | |
---|---|
typeName | String : el nombre único del tipo de objeto de configuración. |
configList |
Lanza | |
---|---|
ConfigurationException |
setDeviceManagementServer
public void setDeviceManagementServer (DeviceManagementGrpcServer server)
Establece DeviceManagementGrpcServer
.
Parámetros | |
---|---|
server | DeviceManagementGrpcServer |
establecerAdministrador de dispositivos
public void setDeviceManager (IDeviceManager manager)
Configure IDeviceManager
y reemplace los valores existentes. Esto configura el administrador para los dispositivos de prueba.
establecerDeviceMonitor
public void setDeviceMonitor (IDeviceMonitor monitor)
Configure el IDeviceMonitor
.
Parámetros | |
---|---|
monitor | IDeviceMonitor : El monitor |
establecer requisitos del dispositivo
public void setDeviceRequirements (IDeviceSelection devRequirements)
Establezca IDeviceSelection
y reemplace los valores existentes. Esto establece un filtro de dispositivo global sobre qué dispositivos puede ver el DeviceManager
.
setHostMonitores
public void setHostMonitors (hostMonitors)
Configure la lista IHostMonitor
.
Parámetros | |
---|---|
hostMonitors |
establecer opciones de host
public void setHostOptions (IHostOptions hostOptions)
Configure IHostOptions
y reemplace los valores existentes.
establecerHostResourceManager
public void setHostResourceManager (IHostResourceManager hostResourceManager)
Configure IHostResourceManager
y reemplace los valores existentes.
establecer servidor de invocación
public void setInvocationServer (TestInvocationManagementServer server)
Establece TestInvocationManagementServer
.
Parámetros | |
---|---|
server | TestInvocationManagementServer |
setKeyStoreFábrica
public void setKeyStoreFactory (IKeyStoreFactory factory)
Configure IKeyStoreFactory
y reemplace los valores existentes.
setOptionsFromCommandLineArgs
publicsetOptionsFromCommandLineArgs ( listArgs)
Establezca los campos Option
de configuración global con un conjunto dado de argumentos de línea de comando
ArgsOptionParser
para conocer el formato esperado.Parámetros | |
---|---|
listArgs |
Devoluciones | |
---|---|
los argumentos no consumidos |
Lanza | |
---|---|
ConfigurationException |
setOriginalConfig
public void setOriginalConfig (String config)
Establece la configuración original utilizada para crear la configuración global.
Parámetros | |
---|---|
config | String |
setResourceMetricCollector
public void setResourceMetricCollector (IResourceMetricCollector collector)
Establece IResourceMetricCollector
.
Parámetros | |
---|---|
collector | IResourceMetricCollector |
setSandboxFactory
public void setSandboxFactory (ISandboxFactory factory)
Establezca ISandboxFactory
y reemplace los valores existentes.
establecer estrategia de fragmentación
public void setShardingStrategy (IShardHelper sharding)
Establece IShardHelper
que se utilizará al fragmentar una configuración.
Parámetros | |
---|---|
sharding | IShardHelper |
setTradefedFeatureServer
public void setTradefedFeatureServer (TradefedFeatureServer server)
Establece TradefedFeatureServer
.
Parámetros | |
---|---|
server | TradefedFeatureServer |
setWtfHandler
public void setWtfHandler (ITerribleFailureHandler wtfHandler)
Configure ITerribleFailureHandler
.
Parámetros | |
---|---|
wtfHandler | ITerribleFailureHandler : el controlador WTF |
configuración
public void setup ()
Configuración adecuada al inicio de tradefed.
Lanza | |
---|---|
ConfigurationException |
validarOpciones
public void validateOptions ()
Validar los valores de las opciones.
Actualmente, esto solo validará que se hayan configurado todas las opciones obligatorias.
Lanza | |
---|---|
ConfigurationException |
Métodos protegidos
obtener configuración de fábrica
protected IConfigurationFactory getConfigurationFactory ()
Devoluciones | |
---|---|
IConfigurationFactory |