ConfiguraciónFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

Subclases directas conocidas GCSConfigurationFactory, RetryConfigurationFactory, SandboxConfigurationFactory GCSConfigurationFactory Un ConfigurationFactory carga configuraciones desde Google Cloud Storage.  RetryConfigurationFactory Es la fábrica que controla la reintento de un comando.  SandboxConfigurationFactory Es una fábrica de configuración especial para controlar la creación de configuraciones con fines de zona de pruebas.

---

Fábrica para crear IConfiguration.

Resumen

Clases anidadas
class	ConfigurationFactory.ConfigLoader Implementación de IConfigDefLoader que realiza un seguimiento de las configuraciones incluidas desde una configuración raíz y arroja una excepción en las inclusiones circulares.
class	ConfigurationFactory.ExceptionLoader

Constructores protegidos
ConfigurationFactory()

Métodos públicos
void	clearMapConfig() En algún caso particular, necesitamos borrar el mapa.
IConfiguration	createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs) Crea el IConfiguration a partir de los argumentos de la línea de comandos.
IConfiguration	createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient) Crea el IConfiguration a partir de los argumentos de la línea de comandos con un almacén de claves.
IConfiguration	createConfigurationFromArgs(String[] arrayArgs) Un método de conveniencia que llama a ERROR(/#createConfigurationFromArgs(String[],List)) con un segundo argumento null.
IGlobalConfiguration	createGlobalConfigurationFromArgs(String[] arrayArgs, remainingArgs) Crea un IGlobalConfiguration a partir de los argumentos de la línea de comandos.
IConfiguration	createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) Crea una configuración que solo contenga un conjunto de objetos seleccionados.
void	dumpConfig(String configName, PrintStream out) Vuelca el contenido de la configuración en el ERROR(/PrintStream) determinado
	getConfigList(String subPath, boolean loadFromEnv) Es una variación de getConfigList() en la que se puede especificar si también queremos cargar la configuración desde el entorno.
	getConfigList() Muestra la lista de nombres de todas las configuraciones que se encuentran en los archivos JAR de la ruta de clase.
static IConfigurationFactory	getInstance() Obtén la instancia singleton IConfigurationFactory.
void	loadAllConfigs(boolean discardExceptions) Carga todas las configuraciones que se encuentran en los directorios de ruta de clase y de casos de prueba.
void	loadAndPrintAllConfigs() Es un método de utilidad que comprueba que todos los parámetros de configuración se puedan cargar, analizar y todos los valores de opción establecidos.
void	printHelp(PrintStream out) Imprime el resultado de ayuda de esta fábrica.
void	printHelpForConfig(String[] args, boolean importantOnly, PrintStream out) Imprime el resultado de ayuda para el IConfiguration especificado en los argumentos de la línea de comandos. Si 'args' hace referencia a una configuración conocida, se creará un objeto IConfiguration de XML, y se mostrará la ayuda para ese IConfiguration.

Métodos protegidos
InputStream	getBundledConfigStream(String name)
String	getConfigPrefix() Muestra el prefijo de ruta de acceso de los archivos XML de configuración en el classpath Está expuesto para que las pruebas de unidades puedan simular.
BufferedInputStream	getConfigStream(String name) Carga un InputStream para un nombre de configuración determinado.
ConfigurationDef	getConfigurationDef(String name, boolean isGlobal, templateMap) Recupera los ConfigurationDef del nombre dado
	getMapConfig() Se expone para pruebas.
boolean	isDirectConfiguration(String configName)
String[]	reorderArgs(String[] args) Reordena los argumentos para que los argumentos template:map se muevan al frente.
IRemoteFileResolver.ResolvedFile	resolveRemoteFile(URI configURI, URI destDir)

Constructores protegidos

ConfiguraciónFactory

protected ConfigurationFactory ()

Métodos públicos

clearMapConfig

public void clearMapConfig ()

En algún caso particular, necesitamos borrar el mapa.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

Crea el IConfiguration a partir de los argumentos de la línea de comandos.

El formato esperado es "CONFIG [options]", en el que CONFIG es el nombre de la configuración integrada o una ruta de acceso a un archivo en formato XML de configuración.

Parámetros
arrayArgs	String: Los argumentos de la línea de comandos
unconsumedArgs	: Una lista que se propagará con los argumentos que no se que consumen los objetos asociados con la configuración especificada. Si esta es null, la implementación arrojará Es ConfigurationException si quedan argumentos sin procesar.

Muestra
IConfiguration	el IConfiguration cargado. Los campos Option del objeto delegado tienen con valores en args.

Arroja
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

Crea el IConfiguration a partir de los argumentos de la línea de comandos con un almacén de claves.

El formato esperado es “CONFIG [opciones]”, donde CONFIG es el nombre de la configuración integrada o una ruta de acceso a un archivo de configuración en formato XML.

Parámetros
arrayArgs	String: Los argumentos de la línea de comandos
unconsumedArgs	: Una lista que se propagará con los argumentos que no se que consumen los objetos asociados con la configuración especificada. Si esta es null, la implementación arrojará Es ConfigurationException si quedan argumentos sin procesar.
keyStoreClient	IKeyStoreClient: Un IKeyStoreClient que se usa para obtener información sensible en los argumentos.

Muestra
IConfiguration	el IConfiguration cargado. Los campos Option del objeto delegado tienen con valores en args.

Arroja
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Un método de conveniencia que llama a ERROR(/#createConfigurationFromArgs(String[],List)) con un segundo argumento de null. Por lo tanto, arrojará ConfigurationException si queda algún argumento sin consumir.

Parámetros
arrayArgs	String

Muestra
IConfiguration

Arroja
ConfigurationException

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

Crea un IGlobalConfiguration a partir de argumentos de línea de comandos.

El formato esperado es “CONFIG [opciones]”, donde CONFIG es el nombre de la configuración integrada o una ruta de acceso a un archivo de configuración en formato XML.

Parámetros
arrayArgs	String: Los argumentos de la línea de comandos
remainingArgs	: Una lista que se completará con los argumentos que no se procesados como argumentos globales

Muestra
IGlobalConfiguration	el IGlobalConfiguration cargado. Los campos Option del objeto delegado se propagaron con valores en args.

Arroja
ConfigurationException

createPartialConfigurationFromArgs

public IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                 allowedObjects, 
                TradefedDelegator delegator)

Crea una configuración que solo contenga un conjunto de objetos seleccionados.

Parámetros
arrayArgs	String: Los argumentos de la línea de comandos
keyStoreClient	IKeyStoreClient: Un IKeyStoreClient que se usa para obtener información sensible en los argumentos.
allowedObjects	: Es el conjunto de objetos permitidos que se crearán.
delegator	TradefedDelegator

Muestra
IConfiguration	Es el IConfiguration cargado.

Arroja
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

Vuelca el contenido de la configuración en el ERROR(/PrintStream) determinado

Parámetros
configName	String: Es el nombre de la configuración.
out	PrintStream: Es el ERROR(/PrintStream) al que se volcará el resultado.

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

Variación de getConfigList() en la que se puede especificar si también queremos cargar o no la configuración del entorno.

Parámetros
subPath	String: Es el nombre de los subdirectorios en los que se buscará la configuración. Si es nulo, tendrá el mismo comportamiento que getConfigList().
loadFromEnv	boolean: Es verdadero si debemos cargar la configuración en la variable de entorno.

Muestra

getConfigList

public  getConfigList ()

Muestra la lista de nombres de todas las configuraciones que se encuentran en los archivos JAR de la ruta de clase. No intenta cargar ninguna de las configuraciones, por lo que es posible que haya configuraciones que no funcionen en esta lista.

Muestra

getInstance

public static IConfigurationFactory getInstance ()

Obtén la instancia singleton de IConfigurationFactory.

Muestra
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

Carga todas las configuraciones que se encuentran en los directorios de ruta de clase y de casos de prueba.

Parámetros
discardExceptions	boolean: Es verdadero si se debe ignorar cualquier ConfigurationException.

Arroja
	com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

Es un método de utilidad que verifica que se puedan cargar, analizar y establecer todos los valores de configuración. Solo se expusieron para que, dependiendo del proyecto, puedan validar sus parámetros de configuración. No se debe exponer en la consola.

Arroja
ConfigurationException	si no se pudo cargar una o más configuraciones

printHelp

public void printHelp (PrintStream out)

Imprime el resultado de ayuda de esta fábrica.

Imprime información de ayuda genérica y muestra una lista de todas las configuraciones disponibles.

Parámetros
out	PrintStream: Es el ERROR(/PrintStream) en el que se volcará el resultado.

printHelpForConfig

public void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

Imprime el resultado de ayuda para el IConfiguration especificado en los argumentos de la línea de comandos.

Si "args" hace referencia a una configuración conocida, se creará un objeto IConfiguration a partir de XML y se mostrará la ayuda para ese IConfiguration. Ten en cuenta que se ignorarán todos los demás valores de "args" (es decir, el texto de ayuda describirá los valores actuales de Option como se cargaron desde XML y no reflejará los valores de la opción establecidos por los argumentos de la línea de comandos).

Si 'args' no hace referencia a un elemento IConfiguration conocido, el elemento Se mostrará la ayuda de printHelp(PrintStream).

Parámetros
args	String: Los argumentos de la línea de comandos
importantOnly	boolean: Si es true, imprime una ayuda abreviada que enumere solo los detalles importantes
out	PrintStream: Es el ERROR(/PrintStream) al que se volcará el resultado.

Métodos protegidos

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Parámetros
name	String

Muestra
InputStream

getConfigPrefix

protected String getConfigPrefix ()

Muestra el prefijo de ruta de acceso de los archivos XML de configuración en el classpath

Se expone para que las pruebas de unidades puedan simular.

Muestra
String	Ruta de String con una / al final

getConfigStream

protected BufferedInputStream getConfigStream (String name)

Carga un InputStream para un nombre de configuración determinado

Parámetros
name	String: Es el nombre de la configuración que se cargará.

Muestra
BufferedInputStream	Un ERROR(/BufferedInputStream) para leer el contenido de la configuración

Arroja
ConfigurationException	si no se encuentra la configuración

getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                 templateMap)

Recupera el ConfigurationDef para el nombre determinado

Parámetros
name	String: Es el nombre de una configuración integrada que se cargará o una ruta de acceso al archivo de configuración que se cargará.
isGlobal	boolean
templateMap

Muestra
ConfigurationDef	ConfigurationDef

Arroja
ConfigurationException	Si se produjo un error cuando se cargaba la configuración

getMapConfig

protected  getMapConfig ()

Expuesto para realizar pruebas. Muestra una copia del mapa.

Muestra

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

Parámetros
configName	String

Muestra
boolean

reordenarArgs

protected String[] reorderArgs (String[] args)

Reordena los argumentos de modo que los argumentos template:map se muevan al frente.

Parámetros
args	String

Muestra
String[]

resolveRemoteFile

protected IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, 
                URI destDir)

Parámetros
configURI	URI
destDir	URI

Muestra
IRemoteFileResolver.ResolvedFile

Arroja
BuildRetrievalError