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 dado ERROR(/PrintStream)

getConfigList (String subPath, boolean loadFromEnv)

Variação de getConfigList() onde podemos especificar se também queremos ou não carregar 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 IConfigurationFactory singleton.

void loadAllConfigs (boolean discardExceptions)

Carrega todas as configurações encontradas nos diretórios classpath e test cases.

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)

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 classpath

Exposto para que os testes de unidade 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)

Recupere o ConfigurationDef para o nome fornecido

getMapConfig ()

Exposto para testes.

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

Reordene os args para que template:map args 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]", 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 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.

lances
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]", 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 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 no args.

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

lances
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, lançará ConfigurationException se algum argumento não consumido permanecer.

Parâmetros
arrayArgs String

devoluções
IConfiguration

lances
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]", 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

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

lances
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 no args.

allowedObjects : O conjunto de objetos permitidos a serem criados

delegator TradefedDelegator

devoluções
IConfiguration O IConfiguration carregado.

lances
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

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

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 também queremos ou não carregar a configuração do ambiente.

Parâmetros
subPath String : nome dos subdiretórios para procurar configuração. Se 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, portanto, é possível que haja configurações que não funcionem nesta lista.

devoluções

getInstance

public static IConfigurationFactory getInstance ()

Obtenha a instância IConfigurationFactory singleton.

devoluções
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

Carrega todas as configurações encontradas nos diretórios classpath e test cases.

Parâmetros
discardExceptions boolean : true se qualquer ConfigurationException deve ser ignorado.

lances
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 suas configurações. Não deve ser exposto no console.

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

printHelp

public void printHelp (PrintStream out)

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

Imprime uma informação de ajuda genérica 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 pela linha de comando args.

Se 'args' não fizer referência a um IConfiguration conhecido, a ajuda printHelp(PrintStream) genérica 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 classpath

Exposto para que os testes de unidade 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

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

getConfigurationDef

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

Recupere 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

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

getMapConfig

protected  getMapConfig ()

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

devoluções

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

Parâmetros
configName String

devoluções
boolean

reordenarArgs

protected String[] reorderArgs (String[] args)

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

Parâmetros
args String

devoluções
String[]

resolveRemoteFile

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

Parâmetros
configURI URI

destDir URI

devoluções
IRemoteFileResolver.ResolvedFile

lances
BuildRetrievalError