OptionSetter

public class OptionSetter
extends Object

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

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

---

מתבצע אכלוס של Option שדות.

יש תמיכה בהגדרה של שדות מספריים כמו שדות בייט, קצר, int, ארוך, צף ושדות כפולים. החישוב כולל גם גרסה של הקופסה וגם גרסה של הקופסה (למשל Integer לעומת מספר שלם). אם יש בעיה מגדיר את הארגומנט כך שיתאים לסוג הרצוי, יושלכת ConfigurationException.

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

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

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

ניוד מ-dalvik.runner.OptionParser

למידע נוסף:

• ArgsOptionParser

סיכום

מחלקות מקוננות
class	OptionSetter.OptionFieldsForName קונטיינר לרשימה של שדות אפשרויות עם שם נתון.

קבועים
char	NAMESPACE_SEPARATOR

בנאים ציבוריים
OptionSetter(Object... optionSources) יצירת OptionParser חדש להגדרת השדות @Option של 'optionSources'.
OptionSetter( 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_partner

public static final char NAMESPACE_SEPARATOR

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

בנאים ציבוריים

OptionSetter

public OptionSetter (Object... optionSources)

יצירת OptionParser חדש להגדרת השדות @Option של 'optionSources'.

פרמטרים
optionSources	Object

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

OptionSetter

public OptionSetter ( optionSources)

יצירת OptionParser חדש להגדרת השדות @Option של 'optionSources'.

פרמטרים
optionSources

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

קליעות
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 שגוי

verification RemoteFilePath

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	אם שדה לבדיקה אינו נגיש