OptionSetter

public class OptionSetter
extends Object

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

已知直接子類別 ArgsOptionParser ArgsOptionParser 從剖析的指令列引數中填入 Option 欄位。

---

填入 Option 欄位。

支援設定位元組、短、整數、長、浮點數和雙精度欄位等數值欄位。 包括未裝箱和裝箱的版本 (例如 int 和整數)。發生問題時 將引數設為符合所需的類型，系統會擲回 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 但標示為 mandatory 的 Option 的名稱 。

常數

名稱 SPACE_{0/}

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	如果找不到 Option 或 valueText 類型有誤

setOptionValue

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

設定選項的值。

參數
optionName	String：要設定的選項名稱
keyText	String：地圖選項的鍵，或空值。
valueText	String：值

傳回
	與已修改的每個物件欄位相對應的 ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) 清單。

擲回
ConfigurationException	如果找不到 Option 或 valueText 類型有誤

VerifyRemoteFilePath

public final  validateRemoteFilePath (DynamicRemoteFileResolver resolver)

執行所有 ERROR(/File) 選項類型，並檢查是否應解析其路徑。

參數
resolver	DynamicRemoteFileResolver：用來解析檔案的 DynamicRemoteFileResolver。

傳回
	解析為該方法的 ERROR(/File) 清單。

擲回
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

保護方法

getUnsetMandatoryOptions

protected  getUnsetMandatoryOptions ()

傳回所有標示為 mandatory 但標示為 mandatory 的 Option 的名稱 。

傳回
	String 的 ERROR(/Collection)，其中包含未設定的 (不合格) 名稱 所有必要選項

擲回
ConfigurationException	無法存取要檢查的欄位