OptionSetter

public class OptionSetter
extends Object

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

Renseigne les champs Option.

La définition des champs numériques tels que les champs byte, short, int, long, float et double est acceptée. Cela inclut les versions boxed et unboxed (par exemple, int vs Integer). Si un problème survient lors de la définition de l'argument pour qu'il corresponde au type souhaité, une ConfigurationException est générée.

Les champs d'option de fichier sont acceptés en encapsulant simplement l'argument de chaîne dans un objet File sans tester l'existence du fichier.

Les champs de collection paramétrés tels que List<File> et Set<String> sont acceptés tant que le type de paramètre est par ailleurs accepté par le setter d'option. Le champ de collection doit être initialisé avec une instance de collection appropriée.

Tous les champs seront traités, y compris les champs publics, protégés, avec accès par défaut (package), privés et hérités.

transféré depuis dalvik.runner.OptionParser

Voir aussi :

Résumé

Classes imbriquées

class OptionSetter.Handler<T>

 

class OptionSetter.MapHandler

Un Handler pour gérer les valeurs des champs de carte. 

class OptionSetter.OptionFieldsForName

Conteneur pour la liste des champs d'options portant le nom donné. 

Constantes

char NAMESPACE_SEPARATOR

Constructeurs publics

OptionSetter(Object... optionSources)

Construit un nouvel OptionParser pour définir les champs @Option de "optionSources".

OptionSetter(Collection<Object> optionSources)

Construit un nouvel OptionParser pour définir les champs @Option de "optionSources".

Méthodes publiques

static Object getFieldValue(Field field, Object optionObject)

Renvoie la valeur du Field donné, en gérant les exceptions.

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

Obtient la liste de tous les champs Option (déclarés et hérités) pour une classe donnée.

String getTypeForOption(String name)

Renvoie une chaîne décrivant le type du champ portant le nom donné.

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

Définit la valeur du champ Option donné.

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

Définit la valeur d'une option non cartographique.

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

Définit la valeur d'une option.

final Set<File> validateRemoteFilePath(DynamicRemoteFileResolver resolver)

Parcourt tous les types d'options File et vérifie si leur chemin d'accès doit être résolu.

Méthodes protégées

Collection<String> getUnsetMandatoryOptions()

Renvoie les noms de tous les Option marqués comme mandatory, mais qui restent non définis.

Constantes

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

Valeur constante : 58 (0x0000003a)

Constructeurs publics

OptionSetter

public OptionSetter (Object... optionSources)

Construit un nouvel OptionParser pour définir les champs @Option de "optionSources".

Paramètres
optionSources Object

Génère
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Collection<Object> optionSources)

Construit un nouvel OptionParser pour définir les champs @Option de "optionSources".

Paramètres
optionSources Collection

Génère
com.android.tradefed.config.ConfigurationException
ConfigurationException

Méthodes publiques

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

Renvoie la valeur du Field donné, en gérant les exceptions.

Paramètres
field Field : Field
optionObject Object : Object à partir duquel obtenir la valeur du champ.
Renvoie
Object la valeur du champ en tant que Object ou null.

getHandler

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

Paramètres
type Type

Renvoie
OptionSetter.Handler<T>

Génère
ConfigurationException

getKeyStore

public IKeyStoreClient getKeyStore ()

Renvoie
IKeyStoreClient

getOptionFieldsForClass

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

Obtient la liste de tous les champs Option (déclarés et hérités) pour une classe donnée.

Paramètres
optionClass Class : Class à rechercher
Renvoie
List<Field> Collection de champs annotés avec Option

getTypeForOption

public String getTypeForOption (String name)

Renvoie une chaîne décrivant le type du champ portant le nom donné.

Paramètres
name String : nom du champ Option
Renvoie
String un String décrivant le type du champ.
Génère
ConfigurationException si le champ est introuvable.

isBooleanOption

public boolean isBooleanOption (String name)

Paramètres
name String

Renvoie
boolean

Génère
ConfigurationException

isMapOption

public boolean isMapOption (String name)

Paramètres
name String

Renvoie
boolean

Génère
ConfigurationException

setFieldValue

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

Définit la valeur du champ Option donné.

Paramètres
optionName String : nom spécifié dans Option
optionSource Object : Object à définir
field Field : Field
key Object : clé d'une entrée dans un champ Map ou MultiMap, ou valeur nulle.
value Object : valeur à définir
checkOption boolean

Renvoie
boolean Indique si le champ a été défini.
Génère
com.android.tradefed.config.ConfigurationException
ConfigurationException

Voir aussi :

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

Paramètres
keyStore IKeyStoreClient

setOptionValue

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

Définit la valeur d'une option non cartographique.

Paramètres
optionName String : nom de l'option à définir
valueText String : valeur
Renvoie
List<OptionSetter.FieldDef> Liste des ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) correspondant à chaque champ d'objet modifié.
Génère
ConfigurationException si l'option est introuvable ou si valueText n'est pas du bon type.

setOptionValue

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

Définit la valeur d'une option.

Paramètres
optionName String : nom de l'option à définir
keyText String : clé des options de carte ou valeur nulle.
valueText String : valeur
Renvoie
List<OptionSetter.FieldDef> Liste des ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) correspondant à chaque champ d'objet modifié.
Génère
ConfigurationException si l'option est introuvable ou si valueText n'est pas du bon type.

validateRemoteFilePath

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

Parcourt tous les types d'options File et vérifie si leur chemin d'accès doit être résolu.

Paramètres
resolver DynamicRemoteFileResolver : DynamicRemoteFileResolver à utiliser pour résoudre les fichiers.
Renvoie
Set<File> Liste des File résolus de cette manière.
Génère
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

Méthodes protégées

getUnsetMandatoryOptions

protected Collection<String> getUnsetMandatoryOptions ()

Renvoie les noms de tous les Option marqués comme mandatory, mais qui restent non définis.

Renvoie
Collection<String> Collection de String contenant les noms (non qualifiés) des options obligatoires non définies.
Génère
ConfigurationException si un champ à vérifier est inaccessible.