ConfiguraçãoFábrica

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 de IConfigDefLoader que rastreia as configurações incluídas de uma configuração raiz e lança uma exceção em inclusões circulares.

class ConfigurationFactory.ExceptionLoader

Construtores protegidos

ConfigurationFactory ()

Métodos públicos

void clearMapConfig ()

Em algum caso particular, precisamos limpar o mapa.

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

Crie o IConfiguration a partir de argumentos de linha de comando.

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

Crie o IConfiguration a partir de argumentos de linha de comando com um armazenamento 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) createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs)

Crie um IGlobalConfiguration a partir de argumentos de linha de comando.

IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) 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) fornecido

getConfigList (String subPath, boolean loadFromEnv)

Variação de getConfigList() onde podemos especificar se queremos ou não carregar também a configuração do ambiente.

getConfigList ()

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

static IConfigurationFactory getInstance ()

Obtenha a instância singleton IConfigurationFactory .

void loadAllConfigs (boolean discardExceptions)

Carrega todas as configurações encontradas nos diretórios classpath e 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ções definidos.

void printHelp (PrintStream out)

As impressões ajudam na saída desta fábrica.

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

Imprime a saída de ajuda para o IConfiguration especificado nos argumentos da linha de comando,

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

Métodos protegidos

InputStream getBundledConfigStream (String name)
String getConfigPrefix ()

Retorne o prefixo do caminho dos arquivos xml de configuração no caminho de classe

Exposto para que os testes unitários possam simular.

BufferedInputStream getConfigStream (String name)

Carrega um InputStream para determinado nome de configuração

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

Recuperar o ConfigurationDef para o nome fornecido

getMapConfig ()

Exposto para testes.

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

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

IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, URI destDir)

Construtores protegidos

ConfiguraçãoFábrica

protected ConfigurationFactory ()

Métodos públicos

clearMapConfig

public void clearMapConfig ()

Em algum caso particular, precisamos limpar o mapa.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

Crie o IConfiguration a partir de argumentos de linha de comando.

O formato esperado é "CONFIG [opções]", onde 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 consumidos pelos objetos associados à configuração especificada. Se for null , a implementação lançará ConfigurationException se algum argumento não processado permanecer.

Devoluções
IConfiguration o IConfiguration carregado. Os campos Option do objeto delegado foram preenchidos com valores em args.

Lança
ConfigurationException

createConfigurationFromArgs

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

Crie o IConfiguration a partir de argumentos de linha de comando com um armazenamento de chaves.

O formato esperado é "CONFIG [opções]", onde 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 consumidos pelos objetos associados à configuração especificada. Se for null , a implementação lançará ConfigurationException se algum argumento não processado permanecer.

keyStoreClient IKeyStoreClient : um IKeyStoreClient que é usado para obter informações confidenciais nos argumentos.

Devoluções
IConfiguration o IConfiguration carregado. Os campos Option do objeto delegado foram preenchidos com valores em args.

Lança
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 lançará ConfigurationException se restar algum argumento não consumido.

Parâmetros
arrayArgs String

Devoluções
IConfiguration

Lança
ConfigurationException

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

Crie um IGlobalConfiguration a partir de argumentos de linha de comando.

O formato esperado é "CONFIG [opções]", onde 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

Devoluções
IGlobalConfiguration o IGlobalConfiguration carregado. Os campos Option do objeto delegado foram preenchidos com valores em args.

Lança
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 obter informações confidenciais nos argumentos.

allowedObjects : O conjunto de objetos permitidos a serem criados

delegator TradefedDelegator

Devoluções
IConfiguration O IConfiguration carregado.

Lança
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

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

Parâmetros
configName String : o nome da configuração

out PrintStream : o ERROR(/PrintStream) para despejar a saída para

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

Variação de getConfigList() onde podemos especificar se queremos ou não carregar também a configuração do ambiente.

Parâmetros
subPath String : nome dos subdiretórios onde procurar a configuração. Se for nulo, terá o mesmo comportamento de getConfigList() .

loadFromEnv boolean : True se devemos carregar a configuração na variável de ambiente.

Devoluções

getConfigList

public  getConfigList ()

Retorne a lista de nomes de todas as configurações encontradas nos JARs no classpath. Não tenta carregar nenhuma das configurações, então é possível ter configurações que não funcionam nesta lista.

Devoluções

getInstance

public static IConfigurationFactory getInstance ()

Obtenha a instância singleton IConfigurationFactory .

Devoluções
IConfigurationFactory

carregarAllConfigs

public void loadAllConfigs (boolean discardExceptions)

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

Parâmetros
discardExceptions boolean : verdadeiro se alguma ConfigurationException deve ser ignorada.

Lança
com.android.tradefed.config.ConfigurationException
ConfigurationException

carregarAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

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

Lança
ConfigurationException se uma ou mais configurações falharam ao carregar

imprimirAjuda

public void printHelp (PrintStream out)

As impressões ajudam na saída desta 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 despejar a saída para

printHelpForConfig

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

Imprime a saída de ajuda para o IConfiguration especificado nos argumentos da linha de comando,

Se 'args' se referir a uma configuração conhecida, um objeto IConfiguration será criado a partir de XML e a ajuda para esse IConfiguration será gerada. Observe que todos os outros valores 'args' serão ignorados (ou seja, o texto de ajuda descreverá os valores atuais de Option s conforme carregados 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, a ajuda genérica printHelp(PrintStream) será exibida.

Parâmetros
args String : os argumentos da linha de comando

importantOnly boolean : se true , imprime uma ajuda abreviada listando apenas os detalhes importantes

out PrintStream : o ERROR(/PrintStream) para despejar a saída para

Métodos protegidos

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Parâmetros
name String

Devoluções
InputStream

getConfigPrefix

protected String getConfigPrefix ()

Retorne o prefixo do caminho dos arquivos xml de configuração no caminho de classe

Exposto para que os testes unitários possam simular.

Devoluções
String Caminho String com / à direita

getConfigStream

protected BufferedInputStream getConfigStream (String name)

Carrega um InputStream para determinado nome de configuração

Parâmetros
name String : o nome da configuração a ser carregada

Devoluções
BufferedInputStream um ERROR(/BufferedInputStream) para ler o conteúdo da configuração

Lança
ConfigurationException se a configuração não puder ser encontrada

getConfigurationDef

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

Recuperar o ConfigurationDef para o nome fornecido

Parâmetros
name String : o nome de uma configuração interna a ser carregada ou um caminho de arquivo para o arquivo de configuração a ser carregado

isGlobal boolean

templateMap

Devoluções
ConfigurationDef ConfigurationDef

Lança
ConfigurationException se ocorreu um erro ao carregar a configuração

getMapConfig

protected  getMapConfig ()

Exposto para testes. Devolva uma cópia do Mapa.

Devoluções

configuração isDirect

protected boolean isDirectConfiguration (String configName)

Parâmetros
configName String

Devoluções
boolean

reordenarArgs

protected String[] reorderArgs (String[] args)

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

Parâmetros
args String

Devoluções
String[]

resolverRemoteFile

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

Parâmetros
configURI URI

destDir URI

Devoluções
IRemoteFileResolver.ResolvedFile

Lança
BuildRetrievalError