Configuración global

public class GlobalConfiguration
extends Object implements IGlobalConfiguration

Objeto java.lang.
   ↳ com.android.tradefed.config.GlobalConfiguration


Una implementación de 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()

Se realiza una limpieza adecuada al realizar un intercambio de cierre.

File cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs)

Filtra GlobalConfiguration en función de una lista blanca y genera un archivo en formato XML.

File cloneConfigWithFilter( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)

Filtrar GlobalConfiguration en función de una lista blanca y, al mismo tiempo, permitir la manipulación de los valores de opción y el resultado en un archivo en formato XML.

File cloneConfigWithFilter(String... allowlistConfigs)

Filtra GlobalConfiguration según una lista permitida y da como resultado un archivo en formato XML.

static createGlobalConfiguration(String[] args)

Configura el singleton GlobalConfiguration para esta instancia de TF.

ICommandScheduler getCommandScheduler()

Obtiene el ICommandScheduler que se usará de la configuración.

Object getConfigurationObject(String typeName)

Obtiene el objeto de configuración personalizado con un nombre determinado.

ICredentialFactory getCredentialFactory()

Obtiene el ICredentialFactory para crear credenciales.

String getDescription()
DeviceManagementGrpcServer getDeviceManagementServer()

Muestra el objeto DeviceManagementGrpcServer o el valor nulo si no está definido.

IDeviceManager getDeviceManager()

Obtiene el IDeviceManager que se usará de la configuración.

static IDeviceManager getDeviceManagerInstance()

Muestra una referencia a la instancia singleton DeviceManager para este TF instancia.

getDeviceMonitors()

Obtiene la lista de IDeviceMonitor de la configuración global.

IDeviceSelection getDeviceRequirements()

Obtiene el IDeviceSelection que se usará de la configuración.

TradefedFeatureServer getFeatureServer()

Muestra el objeto TradefedFeatureServer o el valor nulo si no está definido.

IConfigurationServer getGlobalConfigServer()

Obtiene el servidor de configuración global.

static getHostMonitorInstances()
getHostMonitors()

Obtiene la lista de IHostMonitor de la configuración global.

IHostOptions getHostOptions()

Obtiene el IHostOptions que se usará de la configuración.

IHostResourceManager getHostResourceManager()

Obtiene el IHostResourceManager de la configuración global.

static IGlobalConfiguration getInstance()

Muestra una referencia a la instancia singleton GlobalConfiguration para este TF instancia.

IKeyStoreFactory getKeyStoreFactory()

Obtiene el IKeyStoreFactory que se usará de la configuración.

getMultiDeviceRecoveryHandlers()

Obtiene la lista de IMultiDeviceRecovery para usar de la configuración.

String getName()
getOptionValues(String optionName)

Obtén una lista de los valores de la opción.

getResourceMetricCollectors()

Obtiene la lista de IResourceMetricCollector de la configuración global.

ISandboxFactory getSandboxFactory()

Obtener una fábrica de zona de pruebas que se pueda usar para ejecutar una invocación

IShardHelper getShardingStrategy()

Muestra el IShardHelper que define la forma de fragmentar una configuración.

TestInvocationManagementServer getTestInvocationManagementSever()

Muestra el objeto TestInvocationManagementServer o el valor nulo si no está definido.

ITerribleFailureHandler getWtfHandler()

Obtiene el ITerribleFailureHandler que se usará de la configuración.

void injectOptionValue(String optionName, String optionValue)

Incorpora un valor de opción en el conjunto de objetos de configuración.

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

Incorpora un valor de opción en el conjunto de objetos de configuración.

void printCommandUsage(boolean importantOnly, PrintStream out)

Muestra un texto de ayuda de uso de la línea de comandos para esta configuración a printStream.

void setCommandScheduler(ICommandScheduler scheduler)

Establece el ICommandScheduler y reemplaza los valores existentes.

void setConfigurationFactory(IConfigurationFactory configFactory)

Establece el IConfigurationFactory para esta configuración.

void setConfigurationObject(String typeName, Object configObject)

Es un método genérico para establecer el objeto de configuración con el nombre dado y reemplazar cualquier valor existente.

void setConfigurationObjectList(String typeName, configList)

Método genérico para establecer la lista de objetos de configuración para el nombre dado y reemplazar cualquier objeto existente valor.

void setDeviceManagementServer(DeviceManagementGrpcServer server)

Establece el DeviceManagementGrpcServer.

void setDeviceManager(IDeviceManager manager)

Establece el IDeviceManager y reemplaza los valores existentes.

void setDeviceMonitor(IDeviceMonitor monitor)

Establece el IDeviceMonitor.

void setDeviceRequirements(IDeviceSelection devRequirements)

Establece el IDeviceSelection y reemplaza los valores existentes.

void setHostMonitors( hostMonitors)

Establece la lista IHostMonitor.

void setHostOptions(IHostOptions hostOptions)

Establece el IHostOptions y reemplaza los valores existentes.

void setHostResourceManager(IHostResourceManager hostResourceManager)

Establece el IHostResourceManager y reemplaza los valores existentes.

void setInvocationServer(TestInvocationManagementServer server)

Establece el TestInvocationManagementServer.

void setKeyStoreFactory(IKeyStoreFactory factory)

Establece el IKeyStoreFactory y reemplaza los valores existentes.

setOptionsFromCommandLineArgs( listArgs)

Establece los campos de configuración global Option con un conjunto determinado de argumentos de línea de comandos.

Consultar ArgsOptionParser para ver el formato esperado

void setOriginalConfig(String config)

Establece la configuración original que se usó para crear la configuración global.

void setResourceMetricCollector(IResourceMetricCollector collector)

Establece el IResourceMetricCollector.

void setSandboxFactory(ISandboxFactory factory)

Establece el ISandboxFactory y reemplaza los valores existentes.

void setShardingStrategy(IShardHelper sharding)

Establece el IShardHelper que se usará cuando se fragmente una configuración.

void setTradefedFeatureServer(TradefedFeatureServer server)

Establece el TradefedFeatureServer.

void setWtfHandler(ITerribleFailureHandler wtfHandler)

Establece el ITerribleFailureHandler.

void setup()

Configuración adecuada al comienzo del intercambio.

void validateOptions()

Valida 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

DISPOSITIVO_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

SERVIDOR_DE_CONFIGURACIÓN_GLOBAL

public static final String GLOBAL_CONFIG_SERVER

GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

VARIABLE_CONFIGURACIÓN_GLOBAL

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

NOMBRE DE TIPO_DE_RECUPERACIÓN_MULTI_DISPOSITIVO

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

NOMBRE DE TIPO DE ESTRATEGIA DE SHARDING_STRATEGY_NAME

public static final String SHARDING_STRATEGY_TYPE_NAME

NOMBRE DEL SERVIDOR_ADMINISTRACIÓN DE DISPOSITIVOS DE TF_DEVICE_MANAGEMENT_SERVER

public static final String TF_DEVICE_MANAGEMENT_SERVER_NAME

TF_FEATURE_SERVER_NAME

public static final String TF_FEATURE_SERVER_NAME

NOMBRE_DEL_SERVIDOR_de_INVOCATION_TF

public static final String TF_INVOCATION_SERVER_NAME

WTF_HANDLER_TYPE_NAME

public static final String WTF_HANDLER_TYPE_NAME

Métodos públicos

limpieza

public void cleanup ()

Se realiza una limpieza adecuada al realizar un intercambio de cierre.

clonConfigWithFilter

public File cloneConfigWithFilter ( exclusionPatterns, 
                String... allowlistConfigs)

Filtra GlobalConfiguration en función de una lista blanca y genera un archivo en formato XML.

Parámetros
exclusionPatterns : Es el patrón de nombre de clase que se excluirá del volcado.

allowlistConfigs String: Es un array de configuraciones String que se incluirá en el archivo en formato XML nuevo. Si se estableció en null, a default list should be used.

Muestra
File el archivo que contiene la nueva configuración global filtrada.

clonConfigWithFilter

public File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

Filtrar GlobalConfiguration en función de una lista blanca y, al mismo tiempo, permitir la manipulación de los valores de opción y el resultado en un archivo en formato XML.

Parámetros
exclusionPatterns : Es el patrón de nombre de clase que se excluirá del volcado.

transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String: Es un array de configuraciones String que se incluirá en el nuevo XML. . Si se estableció en null, a default list should be used.

Muestra
File el archivo que contiene la nueva configuración global filtrada.

clonConfigWithFilter

public File cloneConfigWithFilter (String... allowlistConfigs)

Filtra GlobalConfiguration según una lista permitida y da como resultado un archivo en formato 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>

toda la configuración, excepto “key_store” se filtrará y generará un archivo de configuración con siguiente contenido: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Parámetros
allowlistConfigs String: Es un array de configuraciones String que se incluirá en el archivo en formato XML nuevo. Si se estableció en null, a default list should be used.

Muestra
File el archivo que contiene la nueva configuración global filtrada.

createGlobalConfiguration

public static  createGlobalConfiguration (String[] args)

Configura el singleton GlobalConfiguration para esta instancia de TF. Debe llamarse una sola vez, antes de que cualquier cosa intente llamar a getInstance()

Parámetros
args String

Muestra

Arroja
IllegalStateException si se lo llama más de una vez
ConfigurationException

getCommandScheduler

public ICommandScheduler getCommandScheduler ()

Obtiene el ICommandScheduler que se usará de la configuración.

Muestra
ICommandScheduler ICommandScheduler Nunca devolverá un valor nulo.

getConfigurationObject.

public Object getConfigurationObject (String typeName)

Obtiene el objeto de configuración personalizado con un nombre determinado.

Parámetros
typeName String: Es el tipo único del objeto de configuración.

Muestra
Object el objeto o nulo si no se encuentra un objeto con ese nombre

getCredentialFactory

public ICredentialFactory getCredentialFactory ()

Obtiene el ICredentialFactory para crear credenciales.

Muestra
ICredentialFactory ICredentialFactory o null si no se especificó ninguno.

getDescription

public String getDescription ()

Muestra
String una descripción breve legible por el usuario en este Configuration

getDeviceManagementServer

public DeviceManagementGrpcServer getDeviceManagementServer ()

Muestra el objeto DeviceManagementGrpcServer o el valor nulo si no está definido.

Muestra
DeviceManagementGrpcServer

getDeviceManager

public IDeviceManager getDeviceManager ()

Obtiene el IDeviceManager que se usará de la configuración. Administra el conjunto de recursos dispositivos para realizar pruebas

Muestra
IDeviceManager el IDeviceManager proporcionado en la configuración.

getDeviceManagerInstance

public static IDeviceManager getDeviceManagerInstance ()

Muestra una referencia a la instancia singleton DeviceManager para este TF instancia.

Muestra
IDeviceManager

Arroja
IllegalStateException si createGlobalConfiguration(String[]) no tiene ya se llamó.

getDeviceMonitors

public  getDeviceMonitors ()

Obtiene la lista de IDeviceMonitor de la configuración global.

Muestra
la lista de IDeviceMonitor de la configuración global, o null si no se especificó ninguno.

getDeviceRequirements

public IDeviceSelection getDeviceRequirements ()

Obtiene el IDeviceSelection que se usará de la configuración. Representa un filtro global en qué dispositivos puede ver DeviceManager.

Muestra
IDeviceSelection el IDeviceSelection proporcionado en la configuración.

getFeatureServer

public TradefedFeatureServer getFeatureServer ()

Muestra el objeto TradefedFeatureServer o el valor nulo si no está definido.

Muestra
TradefedFeatureServer

getGlobalConfigServer.

public IConfigurationServer getGlobalConfigServer ()

Obtiene el servidor de configuración global. El servidor de configuración global se usa para obtener los parámetros de configuración de host de un servidor en lugar de obtenerlos de archivos locales.

Muestra
IConfigurationServer

getHostMonitorInstances

public static  getHostMonitorInstances ()

Muestra

getHostMonitor

public  getHostMonitors ()

Obtiene la lista de IHostMonitor de la configuración global.

Muestra
la lista de IHostMonitor de la configuración global o null si no hay ninguno se especificó.

getHostOptions

public IHostOptions getHostOptions ()

Obtiene el IHostOptions que se usará de la configuración.

Muestra
IHostOptions el IDeviceManager proporcionado en la configuración.

getHostResourceManager

public IHostResourceManager getHostResourceManager ()

Obtiene el IHostResourceManager de la configuración global.

Muestra
IHostResourceManager el IHostResourceManager de la configuración global o la implementación Es LocalHostResourceManager si no se especifica ninguno en la configuración del host.

getInstance

public static IGlobalConfiguration getInstance ()

Muestra una referencia a la instancia singleton GlobalConfiguration para este TF instancia.

Muestra
IGlobalConfiguration

Arroja
IllegalStateException si createGlobalConfiguration(String[]) no tiene ya se llamó.

getKeyStoreFactory

public IKeyStoreFactory getKeyStoreFactory ()

Obtiene el IKeyStoreFactory que se usará de la configuración.

Muestra
IKeyStoreFactory IKeyStoreFactory o un valor nulo si no se establece una fábrica de almacén de claves

getMultiDeviceRecoveryHandlers.

public  getMultiDeviceRecoveryHandlers ()

Obtiene la lista de IMultiDeviceRecovery para usar de la configuración.

Muestra
la lista de IMultiDeviceRecovery, o null si no está configurada.

getName

public String getName ()

Muestra
String el nombre de este/a Configuration

Valores de la opción getOption

public  getOptionValues (String optionName)

Obtén una lista de los valores de la opción.

Parámetros
optionName String: Es el nombre de la opción del mapa.

Muestra
una lista de los valores de la opción determinada. null si el nombre de la opción no existen.

getResourceMetricCollectors.

public  getResourceMetricCollectors ()

Obtiene la lista de IResourceMetricCollector de la configuración global.

Muestra
la lista de IResourceMetricCollector de la configuración global o null si no se especificó ninguno.

getSandboxFactory

public ISandboxFactory getSandboxFactory ()

Obtener una fábrica de zona de pruebas que se pueda usar para ejecutar una invocación

Muestra
ISandboxFactory

getShardingStrategy.

public IShardHelper getShardingStrategy ()

Muestra el IShardHelper que define la forma de fragmentar una configuración.

Muestra
IShardHelper

getTestInvocationManagementSever

public TestInvocationManagementServer getTestInvocationManagementSever ()

Muestra el objeto TestInvocationManagementServer o el valor nulo si no está definido.

Muestra
TestInvocationManagementServer

getWtfHandler

public ITerribleFailureHandler getWtfHandler ()

Obtiene el ITerribleFailureHandler que se usará de la configuración. Controla qué hacer en caso de que se produzca un WTF (What a Terrible Failure). de que ocurra.

Muestra
ITerribleFailureHandler el ITerribleFailureHandler proporcionado en la o nulo si no se establece ningún controlador

Valor de opción de inyección

public void injectOptionValue (String optionName, 
                String optionValue)

Incorpora un valor de opción en el conjunto de objetos de configuración.

Es útil para proporcionar valores para las opciones que se generan de forma dinámica.

Parámetros
optionName String: Es el nombre de la opción.

optionValue String: Son los valores de la opción.

Arroja
ConfigurationException

Valor de opción de inyección

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

Incorpora un valor de opción en el conjunto de objetos de configuración.

Es útil para proporcionar valores para las opciones que se generan de forma dinámica.

Parámetros
optionName String: Es el nombre de la opción del mapa.

optionKey String: Es la clave de opción del mapa.

optionValue String: Es el valor de la opción del mapa.

Arroja
ConfigurationException

Uso de printCommand

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

Muestra un texto de ayuda de uso de la línea de comandos para esta configuración a printStream.

Parámetros
importantOnly boolean

out PrintStream: Es el ERROR(/PrintStream) que se usará.

Arroja
com.android.tradefed.config.ConfigurationException
ConfigurationException

setCommandScheduler

public void setCommandScheduler (ICommandScheduler scheduler)

Establece el ICommandScheduler y reemplaza los valores existentes.

setConfigurationFactory

public void setConfigurationFactory (IConfigurationFactory configFactory)

Establece el IConfigurationFactory para esta configuración.

Parámetros
configFactory IConfigurationFactory

setConfigurationObject

public void setConfigurationObject (String typeName, 
                Object configObject)

Es un método genérico para establecer el objeto de configuración con el nombre dado y reemplazar cualquier valor existente.

Parámetros
typeName String: Es el nombre único del tipo de objeto de configuración.

configObject Object: Es el objeto de configuración.

Arroja
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 y reemplazar cualquier objeto existente valor.

Parámetros
typeName String: Es el nombre único del tipo de objeto de configuración.

configList : Es la lista de objetos de configuración.

Arroja
ConfigurationException

setDeviceManagementServer

public void setDeviceManagementServer (DeviceManagementGrpcServer server)

Establece el DeviceManagementGrpcServer.

Parámetros
server DeviceManagementGrpcServer

setDeviceManager

public void setDeviceManager (IDeviceManager manager)

Establece el IDeviceManager y reemplaza los valores existentes. Esto establece el administrador dispositivos de prueba

setDeviceMonitor

public void setDeviceMonitor (IDeviceMonitor monitor)

Establece el IDeviceMonitor.

Parámetros
monitor IDeviceMonitor: El monitor

setDeviceRequirements

public void setDeviceRequirements (IDeviceSelection devRequirements)

Establece el IDeviceSelection y reemplaza los valores existentes. De esta forma, se establece un dispositivo global filtrar según los dispositivos que DeviceManager puede ver.

setHostMonitor

public void setHostMonitors ( hostMonitors)

Establece la lista IHostMonitor.

Parámetros
hostMonitors : La lista de supervisores

setHostOptions

public void setHostOptions (IHostOptions hostOptions)

Establece el IHostOptions y reemplaza los valores existentes.

setHostResourceManager

public void setHostResourceManager (IHostResourceManager hostResourceManager)

Establece el IHostResourceManager y reemplaza los valores existentes.

setInvocationServer

public void setInvocationServer (TestInvocationManagementServer server)

Establece el TestInvocationManagementServer.

Parámetros
server TestInvocationManagementServer

setKeyStoreFactory

public void setKeyStoreFactory (IKeyStoreFactory factory)

Establece el IKeyStoreFactory y reemplaza los valores existentes.

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

Establece los campos de configuración global Option con un conjunto determinado de argumentos de línea de comandos.

Consultar ArgsOptionParser para ver el formato esperado

Parámetros
listArgs : Son los argumentos de la línea de comandos.

Muestra
los argumentos no consumidos

Arroja
ConfigurationException

setOriginalConfig

public void setOriginalConfig (String config)

Establece la configuración original que se usó para crear la configuración global.

Parámetros
config String

setResourceMetricCollector

public void setResourceMetricCollector (IResourceMetricCollector collector)

Establece el IResourceMetricCollector.

Parámetros
collector IResourceMetricCollector

setSandboxFactory

public void setSandboxFactory (ISandboxFactory factory)

Establece el ISandboxFactory y reemplaza los valores existentes.

setShardingStrategy

public void setShardingStrategy (IShardHelper sharding)

Establece el IShardHelper que se usará cuando se fragmente una configuración.

Parámetros
sharding IShardHelper

setTradefedFeatureServer

public void setTradefedFeatureServer (TradefedFeatureServer server)

Establece el TradefedFeatureServer.

Parámetros
server TradefedFeatureServer

setWtfHandler

public void setWtfHandler (ITerribleFailureHandler wtfHandler)

Establece el ITerribleFailureHandler.

Parámetros
wtfHandler ITerribleFailureHandler: Es el controlador de WTF.

configuración

public void setup ()

Configuración adecuada al comienzo del intercambio.

Arroja
ConfigurationException

ValidarOpciones

public void validateOptions ()

Valida los valores de las opciones.

Actualmente, esto validará que se hayan configurado todas las opciones obligatorias.

Arroja
ConfigurationException

Métodos protegidos

getConfigurationFactory

protected IConfigurationFactory getConfigurationFactory ()

Muestra
IConfigurationFactory