OptionSetter

public class OptionSetter
extends Object

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

Füllt Option-Felder aus.

Das Festlegen numerischer Felder wie Byte-, Short-, Int-, Long-, Float- und Double-Felder wird unterstützt. Das gilt sowohl für die nicht umschlossenen als auch für die umschlossenen Versionen (z.B. „int“ im Vergleich zu „Integer“). Wenn es ein Problem beim Festlegen des Arguments für den gewünschten Typ gibt, wird eine ConfigurationException ausgelöst.

Felder für Dateioptionen werden unterstützt, indem das String-Argument einfach in ein File-Objekt eingeschlossen wird, ohne dass geprüft wird, ob die Datei vorhanden ist.

Parametrisierte Sammlungsfelder wie „List<File>“ und „Set<String>“ werden unterstützt, sofern der Parametertyp anderweitig vom Optionssetter unterstützt wird. Das Sammlungsfeld sollte mit einer geeigneten Sammlungsinstanz initialisiert werden.

Alle Felder werden verarbeitet, einschließlich öffentlicher, geschützter, Standardzugriffsfelder (Paket), privater und geerbter Felder.

portiert von dalvik.runner.OptionParser

Weitere Informationen

Zusammenfassung

Verschachtelte Klassen

class OptionSetter.Handler<T>

 

class OptionSetter.MapHandler

Ein Handler zum Verarbeiten von Werten für Kartenfelder. 

class OptionSetter.OptionFieldsForName

Container für die Liste der Optionsfelder mit dem angegebenen Namen. 

Konstanten

char NAMESPACE_SEPARATOR

Öffentliche Konstruktoren

OptionSetter(Object... optionSources)

Erstellt einen neuen OptionParser zum Festlegen der @Option-Felder von „optionSources“.

OptionSetter(Collection<Object> optionSources)

Erstellt einen neuen OptionParser zum Festlegen der @Option-Felder von „optionSources“.

Öffentliche Methoden

static Object getFieldValue(Field field, Object optionObject)

Gibt den Wert des angegebenen Field zurück und verarbeitet alle Ausnahmen.

static OptionSetter.Handler<T> getHandler(Type type)
IKeyStoreClient getKeyStore()
static List<Field> getOptionFieldsForClass(Class<?> optionClass)

Ruft eine Liste aller Option-Felder (sowohl deklarierte als auch geerbte) für die angegebene Klasse ab.

String getTypeForOption(String name)

Gibt einen String zurück, der den Typ des Felds mit dem angegebenen Namen beschreibt.

boolean isBooleanOption(String name)
boolean isMapOption(String name)
static boolean setFieldValue(String optionName, Object optionSource, Field field, Object key, Object value, boolean checkOption)

Legt den Wert des angegebenen Felds Option fest.

void setKeyStore(IKeyStoreClient keyStore)
List<OptionSetter.FieldDef> setOptionValue(String optionName, String valueText)

Legt den Wert für eine Option fest, die nicht mit einer Karte verknüpft ist.

List<OptionSetter.FieldDef> setOptionValue(String optionName, String keyText, String valueText)

Legt den Wert für eine Option fest.

final Set<File> validateRemoteFilePath(DynamicRemoteFileResolver resolver)

Durchläuft alle File-Optionstypen und prüft, ob ihr Pfad aufgelöst werden soll.

Geschützte Methoden

Collection<String> getUnsetMandatoryOptions()

Gibt die Namen aller Options zurück, die als mandatory markiert sind, aber nicht festgelegt wurden.

Konstanten

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

Konstanter Wert: 58 (0x0000003a)

Öffentliche Konstruktoren

OptionSetter

public OptionSetter (Object... optionSources)

Erstellt einen neuen OptionParser zum Festlegen der @Option-Felder von „optionSources“.

Parameter
optionSources Object

Löst aus
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Collection<Object> optionSources)

Erstellt einen neuen OptionParser zum Festlegen der @Option-Felder von „optionSources“.

Parameter
optionSources Collection

Löst aus
com.android.tradefed.config.ConfigurationException
ConfigurationException

Öffentliche Methoden

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

Gibt den Wert des angegebenen Field zurück und verarbeitet alle Ausnahmen.

Parameter
field Field: Der Field
optionObject Object: die Object, aus der der Wert des Felds abgerufen werden soll.
Gibt Folgendes zurück:
Object Der Wert des Felds als Object oder null

getHandler

public static OptionSetter.Handler<T> getHandler (Type type)

Parameter
type Type

Gibt Folgendes zurück:
OptionSetter.Handler<T>

Löst aus
ConfigurationException

getKeyStore

public IKeyStoreClient getKeyStore ()

Gibt Folgendes zurück:
IKeyStoreClient

getOptionFieldsForClass

public static List<Field> getOptionFieldsForClass (Class<?> optionClass)

Ruft eine Liste aller Option-Felder (sowohl deklarierte als auch geerbte) für die angegebene Klasse ab.

Parameter
optionClass Class: der Class, nach dem gesucht werden soll
Gibt Folgendes zurück:
List<Field> eine Collection von Feldern, die mit Option annotiert sind

getTypeForOption

public String getTypeForOption (String name)

Gibt einen String zurück, der den Typ des Felds mit dem angegebenen Namen beschreibt.

Parameter
name String: der Feldname Option
Gibt Folgendes zurück:
String String, die den Typ des Felds beschreibt
Löst aus
ConfigurationException Wenn das Feld nicht gefunden werden konnte

isBooleanOption

public boolean isBooleanOption (String name)

Parameter
name String

Gibt Folgendes zurück:
boolean

Löst aus
ConfigurationException

isMapOption

public boolean isMapOption (String name)

Parameter
name String

Gibt Folgendes zurück:
boolean

Löst aus
ConfigurationException

setFieldValue

public static boolean setFieldValue (String optionName, 
                Object optionSource, 
                Field field, 
                Object key, 
                Object value, 
                boolean checkOption)

Legt den Wert des angegebenen Felds Option fest.

Parameter
optionName String: der in Option angegebene Name
optionSource Object: die festzulegende Object
field Field: Der Field
key Object: Der Schlüssel für einen Eintrag in einem Map- oder MultiMap-Feld oder „null“.
value Object: der festzulegende Wert
checkOption boolean

Gibt Folgendes zurück:
boolean Gibt an, ob das Feld festgelegt wurde.
Löst aus
com.android.tradefed.config.ConfigurationException
ConfigurationException

Weitere Informationen

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

Parameter
keyStore IKeyStoreClient

setOptionValue

public List<OptionSetter.FieldDef> setOptionValue (String optionName, 
                String valueText)

Legt den Wert für eine Option fest, die nicht mit einer Karte verknüpft ist.

Parameter
optionName String: Der Name der festzulegenden Option
valueText String: der Wert
Gibt Folgendes zurück:
List<OptionSetter.FieldDef> Eine Liste der ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef)s, die jedem geänderten Objektfeld entsprechen.
Löst aus
ConfigurationException wenn die Option nicht gefunden werden kann oder valueText den falschen Typ hat

setOptionValue

public List<OptionSetter.FieldDef> setOptionValue (String optionName, 
                String keyText, 
                String valueText)

Legt den Wert für eine Option fest.

Parameter
optionName String: Der Name der festzulegenden Option
keyText String: Der Schlüssel für Kartenoptionen oder null.
valueText String: der Wert
Gibt Folgendes zurück:
List<OptionSetter.FieldDef> Eine Liste der ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef)s, die jedem geänderten Objektfeld entsprechen.
Löst aus
ConfigurationException wenn die Option nicht gefunden werden kann oder valueText den falschen Typ hat

validateRemoteFilePath

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

Durchläuft alle File-Optionstypen und prüft, ob ihr Pfad aufgelöst werden soll.

Parameter
resolver DynamicRemoteFileResolver: Der DynamicRemoteFileResolver, der zum Auflösen der Dateien verwendet werden soll.
Gibt Folgendes zurück:
Set<File> Die Liste der File, die auf diese Weise behoben wurden.
Löst aus
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

Geschützte Methoden

getUnsetMandatoryOptions

protected Collection<String> getUnsetMandatoryOptions ()

Gibt die Namen aller Options zurück, die als mandatory markiert sind, aber nicht festgelegt wurden.

Gibt Folgendes zurück:
Collection<String> Ein Collection von Strings mit den (nicht qualifizierten) Namen der nicht festgelegten Pflichtoptionen.
Löst aus
ConfigurationException Ob ein zu prüfendes Feld nicht zugänglich ist