ConfigurazioneFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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


Factory per la creazione IConfiguration .

Riepilogo

Classi nidificate

class ConfigurationFactory.ConfigLoader

Implementazione di IConfigDefLoader che tiene traccia delle configurazioni incluse da una configurazione root e genera un'eccezione sulle inclusioni circolari.

class ConfigurationFactory.ExceptionLoader

Costruttori protetti

ConfigurationFactory ()

Metodi pubblici

void clearMapConfig ()

In alcuni casi particolari, dobbiamo cancellare la mappa.

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

Creare la IConfiguration dagli argomenti della riga di comando.

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

Creare la IConfiguration dagli argomenti della riga di comando con un archivio chiavi.

IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Un metodo pratico che chiama ERROR(/#createConfigurationFromArgs(String[],List)) con un secondo argomento null .

IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs) createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs)

Crea una IGlobalConfiguration dagli argomenti della riga di comando.

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

Crea una configurazione che contenga solo un insieme di oggetti selezionati.

void dumpConfig (String configName, PrintStream out)

Scarica il contenuto della configurazione nel dato ERROR(/PrintStream)

getConfigList (String subPath, boolean loadFromEnv)

Variazione di getConfigList() dove possiamo specificare se vogliamo caricare o meno anche la configurazione dall'ambiente.

getConfigList ()

Restituisce l'elenco dei nomi di tutte le configurazioni trovate nei JAR sul classpath.

static IConfigurationFactory getInstance ()

Ottieni l'istanza IConfigurationFactory singleton.

void loadAllConfigs (boolean discardExceptions)

Carica tutte le configurazioni trovate nelle directory classpath e test case.

void loadAndPrintAllConfigs ()

Metodo di utilità che controlla che tutte le configurazioni possano essere caricate, analizzate e che tutti i valori delle opzioni siano impostati.

void printHelp (PrintStream out)

Le stampe aiutano l'output per questa fabbrica.

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

Stampa l'output della guida per la IConfiguration specificata negli argomenti della riga di comando,

Se "args" si riferisce a una configurazione nota, verrà creato un oggetto IConfiguration da XML e verrà restituito l'aiuto per tale IConfiguration .

Metodi protetti

InputStream getBundledConfigStream (String name)
String getConfigPrefix ()

Restituisce il prefisso del percorso dei file xml di configurazione su classpath

Esposto in modo che i test unitari possano deridere.

BufferedInputStream getConfigStream (String name)

Carica un InputStream per il nome di configurazione specificato

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

Recuperare ConfigurationDef per il nome specificato

getMapConfig ()

Esposto per test.

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

Riordina gli argomenti in modo che template:map args vengano tutti spostati in primo piano.

IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, URI destDir)

Costruttori protetti

ConfigurazioneFactory

protected ConfigurationFactory ()

Metodi pubblici

clearMapConfig

public void clearMapConfig ()

In alcuni casi particolari, dobbiamo cancellare la mappa.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

Creare la IConfiguration dagli argomenti della riga di comando.

Il formato previsto è "CONFIG [opzioni]", dove CONFIG è il nome di configurazione integrato o il percorso di un file xml di configurazione.

Parametri
arrayArgs String : gli argomenti della riga di comando

unconsumedArgs : un Elenco che verrà popolato con gli argomenti che non sono stati consumati dagli Oggetti associati alla configurazione specificata. Se questo è null , l'implementazione lancerà ConfigurationException se rimangono argomenti non elaborati.

ritorna
IConfiguration l' IConfiguration caricata. I campi Option dell'oggetto delegato sono stati popolati con valori in args.

Lancia
ConfigurationException

createConfigurationFromArgs

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

Creare la IConfiguration dagli argomenti della riga di comando con un archivio chiavi.

Il formato previsto è "CONFIG [opzioni]", dove CONFIG è il nome di configurazione integrato o il percorso di un file xml di configurazione.

Parametri
arrayArgs String : gli argomenti della riga di comando

unconsumedArgs : un Elenco che verrà popolato con gli argomenti che non sono stati consumati dagli Oggetti associati alla configurazione specificata. Se questo è null , l'implementazione lancerà ConfigurationException se rimangono argomenti non elaborati.

keyStoreClient IKeyStoreClient : un IKeyStoreClient utilizzato per ottenere informazioni riservate negli argomenti.

ritorna
IConfiguration l' IConfiguration caricata. I campi Option dell'oggetto delegato sono stati popolati con valori in args.

Lancia
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Un metodo pratico che chiama ERROR(/#createConfigurationFromArgs(String[],List)) con un secondo argomento null . Pertanto, genererà ConfigurationException se rimangono argomenti non consumati.

Parametri
arrayArgs String

ritorna
IConfiguration

Lancia
ConfigurationException

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

Crea una IGlobalConfiguration dagli argomenti della riga di comando.

Il formato previsto è "CONFIG [opzioni]", dove CONFIG è il nome di configurazione integrato o il percorso di un file xml di configurazione.

Parametri
arrayArgs String : gli argomenti della riga di comando

remainingArgs : un elenco che verrà popolato con gli argomenti che non sono stati elaborati come argomenti globali

ritorna
IGlobalConfiguration l' IGlobalConfiguration caricato. I campi Option dell'oggetto delegato sono stati popolati con valori in args.

Lancia
ConfigurationException

createPartialConfigurationFromArgs

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

Crea una configurazione che contenga solo un insieme di oggetti selezionati.

Parametri
arrayArgs String : gli argomenti della riga di comando

keyStoreClient IKeyStoreClient : un IKeyStoreClient utilizzato per ottenere informazioni riservate negli argomenti.

allowedObjects : l'insieme di oggetti consentiti da creare

delegator TradefedDelegator

ritorna
IConfiguration Il IConfiguration caricato.

Lancia
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

Scarica il contenuto della configurazione nel dato ERROR(/PrintStream)

Parametri
configName String : il nome della configurazione

out PrintStream : l' ERROR(/PrintStream) in cui eseguire il dump dell'output

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

Variazione di getConfigList() dove possiamo specificare se vogliamo caricare o meno anche la configurazione dall'ambiente.

Parametri
subPath String : nome delle sottodirectory in cui cercare la configurazione. Se null, avrà lo stesso comportamento di getConfigList() .

loadFromEnv boolean : Vero se dobbiamo caricare la configurazione nella variabile d'ambiente.

ritorna

getConfigList

public  getConfigList ()

Restituisce l'elenco dei nomi di tutte le configurazioni trovate nei JAR sul classpath. Non tenta di caricare nessuna delle configurazioni, quindi è possibile avere configurazioni non funzionanti in questo elenco.

ritorna

getInstance

public static IConfigurationFactory getInstance ()

Ottieni l'istanza IConfigurationFactory singleton.

ritorna
IConfigurationFactory

caricareAllConfigs

public void loadAllConfigs (boolean discardExceptions)

Carica tutte le configurazioni trovate nelle directory classpath e test case.

Parametri
discardExceptions boolean : true se qualsiasi ConfigurationException deve essere ignorata.

Lancia
com.android.tradefed.config.ConfigurationException
ConfigurationException

caricareAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

Metodo di utilità che controlla che tutte le configurazioni possano essere caricate, analizzate e che tutti i valori delle opzioni siano impostati. Esposto solo in modo che il progetto dipendente possa convalidare le proprie configurazioni. Non dovrebbe essere esposto nella console.

Lancia
ConfigurationException se una o più configurazioni non sono state caricate

stampaAiuto

public void printHelp (PrintStream out)

Le stampe aiutano l'output per questa fabbrica.

Stampa informazioni di aiuto generiche ed elenca tutte le configurazioni disponibili.

Parametri
out PrintStream : l' ERROR(/PrintStream) in cui eseguire il dump dell'output

printAiutoPerConfig

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

Stampa l'output della guida per la IConfiguration specificata negli argomenti della riga di comando,

Se "args" si riferisce a una configurazione nota, verrà creato un oggetto IConfiguration da XML e verrà restituito l'aiuto per tale IConfiguration . Nota che tutti gli altri valori 'args' verranno ignorati (ovvero il testo della guida descriverà i valori correnti di Option come caricati da XML e non rifletterà i valori dell'opzione impostati dalla riga di comando args.

Se 'args' non fa riferimento a un IConfiguration noto, verrà visualizzata la guida generica printHelp(PrintStream) .

Parametri
args String : gli argomenti della riga di comando

importantOnly boolean : se true , stampa un aiuto abbreviato elencando solo i dettagli importanti

out PrintStream : l' ERROR(/PrintStream) in cui eseguire il dump dell'output

Metodi protetti

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Parametri
name String

ritorna
InputStream

getConfigPrefix

protected String getConfigPrefix ()

Restituisce il prefisso del percorso dei file xml di configurazione su classpath

Esposto in modo che i test unitari possano deridere.

ritorna
String Percorso String con / finale

getConfigStream

protected BufferedInputStream getConfigStream (String name)

Carica un InputStream per il nome di configurazione specificato

Parametri
name String : il nome della configurazione da caricare

ritorna
BufferedInputStream un ERROR(/BufferedInputStream) per la lettura del contenuto della configurazione

Lancia
ConfigurationException se non è stato possibile trovare la configurazione

getConfigurazioneDef

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

Recuperare ConfigurationDef per il nome specificato

Parametri
name String : il nome di una configurazione integrata da caricare o il percorso di un file di configurazione da caricare

isGlobal boolean

templateMap

ritorna
ConfigurationDef ConfigurationDef

Lancia
ConfigurationException se si è verificato un errore durante il caricamento del file config

getMapConfig

protected  getMapConfig ()

Esposto per test. Restituisci una copia della mappa.

ritorna

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

Parametri
configName String

ritorna
boolean

riordinaArgs

protected String[] reorderArgs (String[] args)

Riordina gli argomenti in modo che template:map args vengano tutti spostati in primo piano.

Parametri
args String

ritorna
String[]

risolvereRemoteFile

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

Parametri
configURI URI

destDir URI

ritorna
IRemoteFileResolver.ResolvedFile

Lancia
BuildRetrievalError