IConfigurationFactory

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationFactory


Factory per la creazione di IConfiguration

Riepilogo

Metodi pubblici

abstract IConfiguration createConfigurationFromArgs(String[] args, unconsumedArgs)

Crea IConfiguration dagli argomenti della riga di comando.

abstract IConfiguration createConfigurationFromArgs(String[] args)

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

abstract IConfiguration createConfigurationFromArgs(String[] args, unconsumedArgs, IKeyStoreClient keyStoreClient)

Crea il IConfiguration da argomenti della riga di comando con un archivio chiavi.

abstract IGlobalConfiguration createGlobalConfigurationFromArgs(String[] args, nonGlobalArgs)

Crea un IGlobalConfiguration dagli argomenti della riga di comando.

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

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

abstract void dumpConfig(String configName, PrintStream out)

Esegue il dump dei contenuti della configurazione in ERROR(/PrintStream) specificato

abstract getConfigList()

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

abstract getConfigList(String subPath, boolean loadFromEnv)

Variazione di getConfigList() in cui è possibile specificare se vogliamo o meno caricare anche la configurazione dall'ambiente.

abstract void printHelp(PrintStream out)

Le stampe aiutano a produrre per questa fabbrica.

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

Stampa l'output della guida per il valore IConfiguration specificato negli argomenti della riga di comando.

Se "args" fa riferimento a una configurazione nota, verrà creato un oggetto IConfiguration dall'XML e verrà visualizzata la relativa guida.IConfiguration

Metodi pubblici

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                 unconsumedArgs)

Crea IConfiguration dagli argomenti della riga di comando.

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

Parametri
args String: gli argomenti della riga di comando

unconsumedArgs : un elenco che verrà compilato con gli argomenti non utilizzati dagli oggetti associati alla configurazione specificata. Se questo è null, l'implementazione genererà ConfigurationException se rimangono argomenti non elaborati.

Ritorni
IConfiguration il IConfiguration caricato. I campi dell'oggetto delegato Option sono stati compilati con i valori in args.

Lanci
ConfigurationException if configuration could not be loaded

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args)

Un metodo di utilità che chiama ERROR(/#createConfigurationFromArgs(String[],List)) con un secondo argomento null. Pertanto, verrà generato un errore ConfigurationException se rimangono argomenti non utilizzati.

Parametri
args String

Ritorni
IConfiguration

Lanci
ConfigurationException

createConfigurationFromArgs

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

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

Il formato previsto è "CONFIG [options]", dove CONFIG è il nome della configurazione integrata o un percorso file a un file XML di configurazione.

Parametri
args String: gli argomenti della riga di comando

unconsumedArgs : un elenco che verrà compilato con gli argomenti non utilizzati dagli oggetti associati alla configurazione specificata. Se questo valore è null, l'implementazione restituirà ConfigurationException se rimangono argomenti non elaborati.

keyStoreClient IKeyStoreClient: un IKeyStoreClient utilizzato per ottenere informazioni sensibili in gli argomenti.

Ritorni
IConfiguration il IConfiguration caricato. I campi dell'oggetto delegato Option sono stati compilati con valori negli argomenti.

Lanci
ConfigurationException if configuration could not be loaded

createGlobalConfigurationFromArgs

public abstract IGlobalConfiguration createGlobalConfigurationFromArgs (String[] args, 
                 nonGlobalArgs)

Crea un IGlobalConfiguration dagli argomenti della riga di comando.

Il formato previsto è "CONFIG [options]", dove CONFIG è il nome della configurazione integrata o un percorso file a un file XML di configurazione.

Parametri
args String: gli argomenti della riga di comando

nonGlobalArgs : un elenco che verrà compilato con gli argomenti che non sono stati elaborati come argomenti globali

Ritorni
IGlobalConfiguration il IGlobalConfiguration caricato. I campi Option dell'oggetto delegato sono stati compilati con i valori in args.

Lanci
ConfigurationException se non è stato possibile caricare la configurazione

createPartialConfigurationFromArgs

public abstract 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 sensibili negli argomenti.

allowedObjects : l'insieme di oggetti consentiti da creare

delegator TradefedDelegator

Ritorni
IConfiguration Il IConfiguration caricato.

Lanci
ConfigurationException if configuration could not be loaded

dumpConfig

public abstract void dumpConfig (String configName, 
                PrintStream out)

Esegue il dump dei contenuti della configurazione in ERROR(/PrintStream) specificato

Parametri
configName String: il nome della configurazione

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

getConfigList

public abstract  getConfigList ()

Restituisce l'elenco dei nomi di tutte le configurazioni trovate nei JAR nel percorso di classe. Non tenta di caricare nessuna configurazione, quindi è possibile che in questo elenco sia presente una configurazione non funzionante.

Ritorni

getConfigList

public abstract  getConfigList (String subPath, 
                boolean loadFromEnv)

Variazione di getConfigList() in cui è possibile specificare se caricare o meno la configurazione anche dall'ambiente.

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

loadFromEnv boolean: True se dobbiamo caricare la configurazione nella variabile di ambiente.

Ritorni

printHelp

public abstract void printHelp (PrintStream out)

Stampa l'output della guida per questa fabbrica.

Stampa informazioni generiche sulla guida ed elenca tutte le configurazioni disponibili.

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

printHelpForConfig

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

Stampa l'output della guida per IConfiguration specificato 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'output della guida per IConfiguration. Tieni presente che tutti gli altri valori di "args" verranno ignorati (ad es. il testo del documento di aiuto descriverà i valori correnti di Options come caricati dal file XML e non rifletterà i valori dell'opzione impostati dagli argomenti della riga di comando.

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

Parametri
args String: gli argomenti della riga di comando

importantOnly boolean: se true, stampa una guida abbreviata elencando solo i dettagli importanti

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