OptionSetter

public class OptionSetter
extends Object

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

已知的直接子类 ArgsOptionParser ArgsOptionParser 从已解析的命令行参数中填充 Option 字段。

---

填充 Option 字段。

支持设置数字字段，例如 byte、short、int、long、float 和 double 字段。 这包括开箱版本和盒装版本（例如 int 与 Integer）。如果出现问题 将参数设置为与所需类型匹配，则会抛出 ConfigurationException。

要支持文件选项字段，只需将字符串参数封装在一个 File 对象中，而不包括 以便测试该文件是否存在

参数化集合字段，如 List<File>和 Set<String>均以 但前提是选项 setter 在其他方面支持该参数类型。收集字段 应使用相应的集合实例进行初始化。

系统会处理所有字段，包括公开、受保护、默认（软件包）访问权限、私有和 继承的字段。

从 dalvik.runner.OptionParser 移植

另见：

• ArgsOptionParser

摘要

嵌套类
class	OptionSetter.OptionFieldsForName 包含给定名称的选项字段列表的容器。

常量
char	NAMESPACE_SEPARATOR

公共构造函数
OptionSetter(Object... optionSources) 构造一个新的 OptionParser，用于设置“optionSources”的 @Option 字段。
OptionSetter( optionSources) 构造一个新的 OptionParser，用于设置“optionSources”的 @Option 字段。

公共方法
static Object	getFieldValue(Field field, Object optionObject) 返回给定 ERROR(/Field) 的值，并处理所有异常。
IKeyStoreClient	getKeyStore()
static	getOptionFieldsForClass(Class<?> optionClass) 获取指定类的所有 Option 字段（包括已声明字段和继承字段）的列表。
String	getTypeForOption(String name) 返回一个字符串，该字符串描述具有给定名称的字段的类型。
boolean	isBooleanOption(String name)
boolean	isMapOption(String name)
void	setKeyStore(IKeyStoreClient keyStore)
	setOptionValue(String optionName, String valueText) 设置非地图选项的值。
	setOptionValue(String optionName, String keyText, String valueText) 设置选项的值。
final	validateRemoteFilePath(DynamicRemoteFileResolver resolver) 运行所有 ERROR(/File) 选项类型，并检查其路径是否应该解析。

受保护的方法
	getUnsetMandatoryOptions() 返回标记为 mandatory 但Option 保持未设置状态

常量

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

常量值： 58 (0x0000003a)

公共构造函数

OptionSetter

public OptionSetter (Object... optionSources)

构造一个新的 OptionParser，用于设置“optionSources”的 @Option 字段。

参数
optionSources	Object

抛出
	com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter ( optionSources)

构造一个新的 OptionParser，用于设置“optionSources”的 @Option 字段。

参数
optionSources

抛出
	com.android.tradefed.config.ConfigurationException
ConfigurationException

公共方法

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

返回给定 ERROR(/Field) 的值，并处理所有异常。

参数
field	Field：ERROR(/Field)
optionObject	Object：要从中获取字段的值的 Object。

返回
Object	字段的值为 Object 或 null

getKeyStore

public IKeyStoreClient getKeyStore ()

返回
IKeyStoreClient

getOptionFieldsForClass

public static  getOptionFieldsForClass (Class<?> optionClass)

获取指定类的所有 Option 字段（包括已声明字段和继承字段）的列表。

参数
optionClass	Class：要搜索的 Class

返回
	由 Option 注解的字段的 ERROR(/Collection)

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

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

参数
keyStore	IKeyStoreClient

setOptionValue

public  setOptionValue (String optionName, 
                String valueText)

设置非地图选项的值。

参数
optionName	String：要设置的选项的名称
valueText	String：值

返回
	与修改后的每个对象字段相对应的 ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) 列表。

抛出
ConfigurationException	如果找不到选项或 valueText 的类型有误

setOptionValue

public  setOptionValue (String optionName, 
                String keyText, 
                String valueText)

设置选项的值。

参数
optionName	String：要设置的选项的名称
keyText	String：映射选项的键，或为 null。
valueText	String：值

返回
	与修改后的每个对象字段相对应的 ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) 列表。

抛出
ConfigurationException	如果找不到选项或 valueText 的类型有误

VerifyRemoteFilePath 类中的方法

public final  validateRemoteFilePath (DynamicRemoteFileResolver resolver)

运行所有 ERROR(/File) 选项类型，并检查其路径是否应该解析。

参数
resolver	DynamicRemoteFileResolver：用于解析文件的 DynamicRemoteFileResolver。

返回
	以这种方式解析的 ERROR(/File) 列表。

抛出
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

受保护的方法

getUnsetMandatoryOptions

protected  getUnsetMandatoryOptions ()

返回标记为 mandatory 但Option 保持未设置状态

返回
	String 的 ERROR(/Collection)，其中包含未设置的（非限定）名称 必选项。

抛出
ConfigurationException	要检查的字段无法访问