ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

Fábrica para criar IConfiguration.

Resumo

Classes aninhadas

class ConfigurationFactory.ConfigLoader

Implementação do IConfigDefLoader que rastreia as configurações incluídas em um configuração raiz e gera uma exceção em inclusões circulares. 

class ConfigurationFactory.ExceptionLoader

 

Construtores protegidos

ConfigurationFactory()

Métodos públicos

void clearMapConfig()

Em alguns casos específicos, precisamos limpar o mapa.

IConfiguration createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs)

Crie o IConfiguration usando os argumentos da linha de comando.

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

Crie o IConfiguration usando argumentos de linha de comando com um repositório de chaves.

IConfiguration createConfigurationFromArgs(String[] arrayArgs)

Um método de conveniência que chama ERROR(/#createConfigurationFromArgs(String[],List)) com um segundo argumento null.

IGlobalConfiguration createGlobalConfigurationFromArgs(String[] arrayArgs, remainingArgs)

Crie um IGlobalConfiguration usando argumentos de linha de comando.

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

Crie uma configuração que contenha apenas um conjunto de objetos selecionados.

void dumpConfig(String configName, PrintStream out)

Despeja o conteúdo da configuração para o ERROR(/PrintStream) especificado.

getConfigList(String subPath, boolean loadFromEnv)

Variação de getConfigList(), em que pode especificar se também queremos carregar a configuração do ambiente.

getConfigList()

Retorne a lista de nomes de todas as configurações encontradas nos JARs no caminho de classe.

static IConfigurationFactory getInstance()

Consiga a instância IConfigurationFactory de singleton.

void loadAllConfigs(boolean discardExceptions)

Carrega todas as configurações encontradas nos diretórios de caminho de classe e de casos de teste.

void loadAndPrintAllConfigs()

Método utilitário que verifica se todas as configurações podem ser carregadas, analisadas e todos os valores de opção definidos.

void printHelp(PrintStream out)

Imprime a saída de ajuda para esta fábrica.

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

Mostra a saída de ajuda para o IConfiguration especificado nos argumentos de linha de comando.

Se 'args' se refere a uma configuração conhecida, um objeto IConfiguration será criado do XML, e será gerada ajuda para IConfiguration.

Métodos protegidos

InputStream getBundledConfigStream(String name)
String getConfigPrefix()

Retornar o prefixo do caminho dos arquivos XML de configuração no caminho de classe

Exposto para que os testes de unidade possam simular.

BufferedInputStream getConfigStream(String name)

Carrega um InputStream para o nome da configuração fornecido

ConfigurationDef getConfigurationDef(String name, boolean isGlobal, templateMap)

Recuperar o ConfigurationDef do nome fornecido

getMapConfig()

Exposto para teste.

boolean isDirectConfiguration(String configName)
String[] reorderArgs(String[] args)

Reordene os args para que todos os argumentos template:map sejam movidos para a frente.

IRemoteFileResolver.ResolvedFile resolveRemoteFile(URI configURI, URI destDir)

Construtores protegidos

ConfigurationFactory

protected ConfigurationFactory ()

Métodos públicos

ClearMapConfig

public void clearMapConfig ()

Em alguns casos específicos, precisamos limpar o mapa.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

Crie o IConfiguration usando os argumentos da linha de comando.

O formato esperado é "CONFIG [options]", em que CONFIG é o nome da configuração integrada ou um caminho de arquivo para um arquivo XML de configuração.

Parâmetros
arrayArgs String: os argumentos da linha de comando.
unconsumedArgs : uma lista que será preenchida com os argumentos que não foram consumida pelos objetos associados à configuração especificada. Se esse for null, a implementação vai gerar ConfigurationException se algum argumento não processado permanecer.
Retorna
IConfiguration o IConfiguration carregado. Os campos do objeto delegado Option têm foi preenchido com valores em args.
Gera
ConfigurationException

createConfigurationFromArgs

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

Crie o IConfiguration usando argumentos de linha de comando com um repositório de chaves.

O formato esperado é "CONFIG [options]", em que CONFIG é o nome da configuração integrada ou um caminho de arquivo para um arquivo XML de configuração.

Parâmetros
arrayArgs String: os argumentos da linha de comando.
unconsumedArgs : uma lista que será preenchida com os argumentos que não foram consumida pelos objetos associados à configuração especificada. Se esse for null, a implementação vai gerar ConfigurationException se algum argumento não processado permanecer.
keyStoreClient IKeyStoreClient: um IKeyStoreClient usado para receber informações sensíveis em o args.
Retorna
IConfiguration o IConfiguration carregado. Os campos do objeto delegado Option têm foi preenchido com valores em args.
Gera
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Um método de conveniência que chama ERROR(/#createConfigurationFromArgs(String[],List)) com um segundo argumento null. Assim, ele vai gerar ConfigurationException se todos os argumentos não consumidos permanecem.

Parâmetros
arrayArgs String

Retorna
IConfiguration

Gera
ConfigurationException

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

Crie um IGlobalConfiguration usando argumentos de linha de comando.

O formato esperado é "CONFIG [options]", em que CONFIG é o nome da configuração integrada ou um caminho de arquivo para um arquivo XML de configuração.

Parâmetros
arrayArgs String: os argumentos da linha de comando.
remainingArgs : uma lista que será preenchida com os argumentos que não foram processados como argumentos globais
Retorna
IGlobalConfiguration o IGlobalConfiguration carregado. Os campos Option do objeto delegado foram preenchidos com valores em args.
Gera
ConfigurationException

createPartialConfigurationFromArgs

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

Crie uma configuração que contenha apenas um conjunto de objetos selecionados.

Parâmetros
arrayArgs String: os argumentos da linha de comando
keyStoreClient IKeyStoreClient: um IKeyStoreClient que é usado para receber informações sensíveis na args.
allowedObjects : o conjunto de objetos permitidos a serem criados
delegator TradefedDelegator

Retorna
IConfiguration O IConfiguration carregado.
Gera
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

Despeja o conteúdo da configuração para o ERROR(/PrintStream) especificado.

Parâmetros
configName String: o nome da configuração.
out PrintStream: o ERROR(/PrintStream) para fazer o despejo da saída em

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

Variação de getConfigList(), em que pode especificar se também queremos carregar a configuração do ambiente.

Parâmetros
subPath String: nome dos subdiretórios em que a configuração será procurada. Se nulo, terá o mesmo comportamento que getConfigList().
loadFromEnv boolean: verdadeiro se for necessário carregar a configuração na variável de ambiente.
Retorna

getConfigList

public  getConfigList ()

Retorne a lista de nomes de todas as configurações encontradas nos JARs no caminho de classe. não tenta carregar nenhuma das configurações, então é possível que uma configuração não funcione; nesta lista.

Retorna

getInstance

public static IConfigurationFactory getInstance ()

Consiga a instância IConfigurationFactory de singleton.

Retorna
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

Carrega todas as configurações encontradas nos diretórios de caminho de classe e de casos de teste.

Parâmetros
discardExceptions boolean: verdadeiro se qualquer ConfigurationException precisar ser ignorada.
Gera
com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

Método utilitário que verifica se todas as configurações podem ser carregadas, analisadas e todos os valores de opção definidos. Exposto apenas para que o projeto dependente possa validar as configurações. Não pode ser exposto no console.

Gera
ConfigurationException se uma ou mais configurações falharem ao carregar

printAjuda

public void printHelp (PrintStream out)

Imprime a saída de ajuda para esta fábrica.

Imprime informações de ajuda genéricas e lista todas as configurações disponíveis.

Parâmetros
out PrintStream: o ERROR(/PrintStream) para fazer o despejo da saída em

printHelpForConfig

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

Mostra a saída de ajuda para o IConfiguration especificado nos argumentos de linha de comando.

Se 'args' se refere a uma configuração conhecida, um objeto IConfiguration será criado do XML, e será gerada ajuda para IConfiguration. Observe todos os outros "args" valores serão ignorados, ou seja, o texto de ajuda vai descrever os valores atuais de Option como carregado do XML e não refletirá os valores da opção definidos pelos argumentos da linha de comando.

Se 'args' não fizer referência a um IConfiguration conhecido, o genérico A ajuda de printHelp(PrintStream) será exibida.

Parâmetros
args String: os argumentos da linha de comando.
importantOnly boolean: se true, exibe uma ajuda abreviada listando apenas os detalhes importantes
out PrintStream: o ERROR(/PrintStream) para fazer o despejo da saída em

Métodos protegidos

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Parâmetros
name String

Retorna
InputStream

getConfigPrefix

protected String getConfigPrefix ()

Retornar o prefixo do caminho dos arquivos XML de configuração no caminho de classe

Exposto para que os testes de unidade possam simular.

Retorna
String Caminho String com / à direita

getConfigStream

protected BufferedInputStream getConfigStream (String name)

Carrega um InputStream para um nome de configuração fornecido

Parâmetros
name String: o nome da configuração a ser carregada.
Retorna
BufferedInputStream um ERROR(/BufferedInputStream) para ler o conteúdo da configuração;
Gera
ConfigurationException se a configuração não for encontrada

getConfigurationDef

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

Recuperar o ConfigurationDef do nome fornecido

Parâmetros
name String: o nome de uma configuração integrada a ser carregada ou um caminho para o arquivo de configuração. para carregar
isGlobal boolean

templateMap

Retorna
ConfigurationDef ConfigurationDef
Gera
ConfigurationException se ocorreu um erro ao carregar a configuração

getMapConfig

protected  getMapConfig ()

Exposto para teste. Retorne uma cópia do mapa.

Retorna

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

Parâmetros
configName String

Retorna
boolean

reordenar

protected String[] reorderArgs (String[] args)

Reordene os argumentos para que todos os argumentos "template:map" sejam movidos para a frente.

Parâmetros
args String

Retorna
String[]

resolveRemoteFile

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

Parâmetros
configURI URI

destDir URI

Retorna
IRemoteFileResolver.ResolvedFile

Gera
BuildRetrievalError