OptionSetter

public class OptionSetter
extends Object

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

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

---

填入 Option 欄位。

支援設定位元組、短、整數、長、浮點數和雙精度浮點數欄位等。這包括未包裝和已包裝的版本 (例如 int 和 Integer)。如果設定引數以符合所需類型時發生問題，系統會擲回 ConfigurationException。

只要將字串引數包裝在 File 物件中，即可支援檔案選項欄位，而無需測試檔案是否存在。

只要是 setter 選項支援的參數類型，系統支援參數化的集合欄位 (例如 List<File> 和 Set<String>)。集合欄位應使用適當的集合例項初始化。

系統會處理所有欄位，包括公開、受保護、預設 (套件) 存取權、私人和繼承欄位。

從 Dalvik.runner.OptionParser 移植

另請參閱：

• ArgsOptionParser

摘要

巢狀類別
class	OptionSetter.OptionFieldsForName 具有指定名稱的選項欄位清單容器。

常數
char	NAMESPACE_SEPARATOR

公用建構函式
OptionSetter( optionSources) 建構新的 OptionParser，用於設定 'optionSources' 的 @Option 欄位。
OptionSetter(Object... 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 ( optionSources)

建構新的 OptionParser 以設定「optionSources」的 @Option 欄位。

參數
optionSources

擲回
	com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Object... optionSources)

建構新的 OptionParser 以設定「optionSources」的 @Option 欄位。

參數
optionSources	Object

擲回
	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：地圖選項的鍵，或空值。
valueText	String：值

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

擲回
ConfigurationException	如果找不到選項或 valueText 的類型有誤

validateRemoteFilePath

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	如果要檢查的欄位無法存取