أداة تحديد الخيارات

public class OptionSetter
extends Object

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

الفئات الفرعية المباشرة المعروفة ArgsOptionParser ArgsOptionParser تتم تعبئة حقول Option من وسيطات سطر الأوامر التي تم تحليلها.

---

تتم تعبئة حقلَين (Option).

يتيح ضبط الحقول الرقمية، مثل حقول البايت والقصير والصحيح والطويل والعدد العائم والمزدوج. ويشمل ذلك كلاً من الإصدارات التي تم فتحها بدون علبة والنُسخ المخصصة لها في علبة (مثل عدد صحيح مقابل عدد صحيح). في حال وجود مشكلة لضبط الوسيطة لتتطابق مع النوع المطلوب، يتم طرح ConfigurationException.

يتم دعم حقول خيارات الملف من خلال إحاطة وسيطة السلسلة ببساطة في كائن ملف بدون إجراء اختبار لوجود الملف.

حقول المجموعة التي تتضمن معلَمات مثل القائمة<File> وتعيين <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_ROWS

public static final char NAMESPACE_SEPARATOR

القيمة الثابتة: 58 (0x0000003a)

شركة إنشاءات عامة

أداة تحديد الخيارات

public OptionSetter (Object... optionSources)

تنشئ OptionParser جديد لإعداد حقول @Option من 'optionSources'.

المعلمات
optionSources	Object

الرميات
	com.android.tradefed.config.ConfigurationException
ConfigurationException

أداة تحديد الخيارات

public OptionSetter ( optionSources)

تنشئ OptionParser جديد لإعداد حقول @Option من 'optionSources'.

المعلمات
optionSources

الرميات
	com.android.tradefed.config.ConfigurationException
ConfigurationException

الطرق العامة

الحصول على قيمة الحقل

public static Object getFieldValue (Field field, 
                Object optionObject)

عرض قيمة ERROR(/Field) المحددة مع التعامل مع أي استثناءات.

المعلمات
field	Field: ERROR(/Field)
optionObject	Object: Object المطلوب الحصول على قيمة الحقل منه.

المرتجعات
Object	قيمة الحقل كـ Object أو null

الحصول على مفتاح تخزين

public IKeyStoreClient getKeyStore ()

المرتجعات
IKeyStoreClient

الحصول على خيارات حقول للفئة

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

تخزين المفاتيح

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 غير صحيح

التحقق من صحة الملف عن بُعد

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	إذا تعذر الوصول إلى حقل يجب التحقق منه