OptionSetter

public class OptionSetter
extends Object

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

מחלקות משנה ישירות ידועות ArgsOptionParser ArgsOptionParser מאכלסת Option שדות מארגומנטים בשורת הפקודה המנותחת.

---

מילוי השדות Option.

יש תמיכה בהגדרה של שדות מספריים כמו שדות byte,‏ short,‏ int,‏ long,‏ float ו-double. החישוב כולל גם גרסה של הקופסה וגם גרסה של הקופסה (למשל Integer לעומת מספר שלם). אם יש בעיה בהגדרת הארגומנט כך שיתאים לסוג הרצוי, מתרחשת הטלת ConfigurationException.

כדי לתמוך בשדות של אפשרויות קובץ, פשוט עוטפים את ארגומנט המחרוזת באובייקט File בלי לבדוק אם הקובץ קיים.

יש תמיכה בשדות של אוספים עם פרמטרים, כמו List<File> ו-Set<String>, כל עוד סוג הפרמטר נתמך בדרך אחרת על ידי ה-setter של האפשרות. צריך לאתחל את שדה האוסף באמצעות מופע אוסף מתאים.

כל השדות יעברו עיבוד, כולל שדות ציבוריים, מוגנים, ברירת מחדל (חבילת), פרטיים וירושים.

הועבר מ-dalvik.runner.OptionParser

מאמרים קשורים:

• ArgsOptionParser

סיכום

כיתות בתצוגת עץ
class	OptionSetter.OptionFieldsForName מאגר לרשימת שדות האפשרויות עם השם הנתון.

קבועים
char	NAMESPACE_SEPARATOR

יוצרים ציבוריים
OptionSetter( optionSources) יצירת OptionParser חדש להגדרת השדות @Option של 'optionSources'.
OptionSetter(Object... optionSources) יצירת אובייקט OptionParser חדש להגדרת השדות של @Option ב-'optionSources'.

שיטות ציבוריות
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() הפונקציה מחזירה את השמות של כל הפריטים מסוג Option שסומנו כ-mandatory אבל לא הוגדרו.

קבועים

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

ערך קבוע: 58 (0x0000003a)

יוצרים ציבוריים

OptionSetter

public OptionSetter ( optionSources)

יצירת אובייקט OptionParser חדש להגדרת השדות של @Option ב-'optionSources'.

פרמטרים
optionSources

זריקות
	com.android.tradefed.config.Configuration וכל החריגות
ConfigurationException

OptionSetter

public OptionSetter (Object... optionSources)

יצירת אובייקט OptionParser חדש להגדרת השדות של @Option ב-'optionSources'.

פרמטרים
optionSources	Object

זריקות
	com.android.tradefed.config.Configuration וכל החריגות
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 לחיפוש

החזרות
	ERROR(/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

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)s שתואם לכל שדה אובייקט ששונה.

זריקות
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	if Option cannot be found or valueText is wrong type

validateRemoteFilePath

public final  validateRemoteFilePath (DynamicRemoteFileResolver resolver)

הפונקציה בודקת את כל סוגי האפשרויות של ERROR(/File) ובודקת אם צריך לפתור את הנתיב שלהן.

פרמטרים
resolver	DynamicRemoteFileResolver: ה-DynamicRemoteFileResolver שישמש לפתרון הקובצים.

החזרות
	רשימת הבעיות מסוג ERROR(/File) שנפתרו בדרך הזו.

קליעות
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

שיטות מוגנות

getUnsetMandatoryOptions

protected  getUnsetMandatoryOptions ()

הפונקציה מחזירה את השמות של כל הפריטים מסוג Option שסומנו כ-mandatory אבל לא הוגדרו.

החזרות
	ERROR(/Collection) של String שמכיל את השמות (ללא הסיווג) של האפשרויות החובה שלא הוגדרו.

זריקות
ConfigurationException	אם שדה לבדיקה אינו נגיש