OptionSetter

public class OptionSetter
extends Object

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


Заполняет поля Option .

Поддерживается установка числовых полей, таких как byte, short, int, long, float и double. Это включает как неупакованные, так и упакованные версии (например, int против Integer). Если возникает проблема с установкой аргумента в соответствии с требуемым типом, генерируется исключение ConfigurationException .

Поддерживаются поля параметров File, для чего строковый аргумент просто оборачивается в объект File без проверки существования файла.

Поддерживаются параметризованные поля коллекций, такие как List<File> и Set<String>, при условии, что тип параметра поддерживается иным образом в методе установки параметров. Поле коллекции должно быть инициализировано соответствующим экземпляром коллекции.

Будут обработаны все поля, включая общедоступные, защищенные, поля с доступом по умолчанию (пакетного доступа), частные и унаследованные поля.

перенесено из dalvik.runner.OptionParser

См. также:

Краткое содержание

Вложенные классы

class OptionSetter.Handler <T>

class OptionSetter.MapHandler

Handler для обработки значений полей карты.

class OptionSetter.OptionFieldsForName

Контейнер для списка полей параметров с заданным именем.

Константы

char NAMESPACE_SEPARATOR

Государственные строители

OptionSetter (Object... optionSources)

Создает новый объект OptionParser для установки полей @Option объекта 'optionSources'.

OptionSetter (Collection<Object> optionSources)

Создает новый объект OptionParser для установки полей @Option объекта 'optionSources'.

Общедоступные методы

static Object getFieldValue (Field field, Object optionObject)

Возвращает значение заданного Field , обрабатывая любые исключения.

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

Получает список всех полей Option (как объявленных, так и унаследованных) для заданного класса.

String getTypeForOption (String name)

Возвращает строку, описывающую тип поля с заданным именем.

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

Устанавливает значение указанного поля Option .

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

Устанавливает значение для параметра, не являющегося картой.

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

Устанавливает значение для параметра.

final Set<File> validateRemoteFilePath ( DynamicRemoteFileResolver resolver)

Проверяет все типы параметров File и определяет, нужно ли разрешать их пути.

Защищенные методы

Collection<String> getUnsetMandatoryOptions ()

Возвращает имена всех Option , помеченных как mandatory , но остающихся незаданными.

Константы

РАЗДЕЛИТЕЛЬ ПРОСТРАНСТВА ИМЯ

public static final char NAMESPACE_SEPARATOR

Постоянное значение: 58 (0x0000003a)

Государственные строители

OptionSetter

public OptionSetter (Object... optionSources)

Создает новый объект OptionParser для установки полей @Option объекта 'optionSources'.

Параметры
optionSources Object

Броски
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Collection<Object> optionSources)

Создает новый объект OptionParser для установки полей @Option объекта 'optionSources'.

Параметры
optionSources Collection

Броски
com.android.tradefed.config.ConfigurationException
ConfigurationException

Общедоступные методы

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

Возвращает значение заданного Field , обрабатывая любые исключения.

Параметры
field Field : Field

optionObject Object : Object , из которого нужно получить значение поля.

Возвраты
Object Значение поля может быть Object или null

getHandler

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

Параметры
type Type

Возвраты
OptionSetter.Handler <T>

Броски
ConfigurationException

getKeyStore

public IKeyStoreClient getKeyStore ()

Возвраты
IKeyStoreClient

getOptionFieldsForClass

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

Получает список всех полей Option (как объявленных, так и унаследованных) для заданного класса.

Параметры
optionClass Class : Class для поиска

Возвраты
List<Field> Collection полей, помеченных Option

getTypeForOption

public String getTypeForOption (String name)

Возвращает строку, описывающую тип поля с заданным именем.

Параметры
name String : имя поля Option

Возвраты
String String , описывающая тип поля.

Броски
ConfigurationException если поле не найдено

isBooleanOption

public boolean isBooleanOption (String name)

Параметры
name String

Возвраты
boolean

Броски
ConfigurationException

isMapOption

public boolean isMapOption (String name)

Параметры
name String

Возвраты
boolean

Броски
ConfigurationException

setFieldValue

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

Устанавливает значение указанного поля Option .

Параметры
optionName String : имя, указанное в Option

optionSource Object : Object который нужно установить.

field Field : Field

key Object : ключ к записи в поле типа Map или MultiMap , либо значение null.

value Object : значение, которое нужно установить.

checkOption boolean

Возвраты
boolean Было ли поле подготовлено.

Броски
com.android.tradefed.config.ConfigurationException
ConfigurationException

См. также:

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

Параметры
keyStore IKeyStoreClient

setOptionValue

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

Устанавливает значение для параметра, не являющегося картой.

Параметры
optionName String : имя параметра для установки

valueText String : значение

Возвраты
List<OptionSetter.FieldDef> Список ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) , соответствующих каждому измененному полю объекта.

Броски
ConfigurationException если параметр не найден или значение valueText имеет неправильный тип

setOptionValue

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

Устанавливает значение для параметра.

Параметры
optionName String : имя параметра для установки

keyText String : ключ для параметров карты или значение null.

valueText String : значение

Возвраты
List<OptionSetter.FieldDef> Список ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) , соответствующих каждому измененному полю объекта.

Броски
ConfigurationException если параметр не найден или значение valueText имеет неправильный тип

validateRemoteFilePath

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

Проверяет все типы параметров File и определяет, нужно ли разрешать их пути.

Параметры
resolver DynamicRemoteFileResolver : Объект DynamicRemoteFileResolver , используемый для разрешения имен файлов.

Возвраты
Set<File> Список File , которые были решены таким образом.

Броски
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

Защищенные методы

getUnsetMandatoryOptions

protected Collection<String> getUnsetMandatoryOptions ()

Возвращает имена всех Option , помеченных как mandatory , но остающихся незаданными.

Возвраты
Collection<String> Collection String , содержащих (неуказанные) имена неустановленных обязательных параметров.

Броски
ConfigurationException если проверяемое поле недоступно