OptionSetter

public class OptionSetter
extends Object

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

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

---

تعبئة حقول Option

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

يمكن استخدام حقول خيارات الملفات من خلال لفّ الوسيطة السلسلة في عنصر File بدون اختبار توفّر الملف.

تتوفّر حقول المجموعات المُعرَّفة بالمَعلمات، مثل List<File> وSet<String>، ما دام نوع المَعلمة متوافقًا مع أداة ضبط الخيارات. يجب بدء حقل المجموعة باستخدام مثيل مجموعة مناسب.

ستتم معالجة جميع الحقول، بما في ذلك الحقول العامة والمحمية والحقول التلقائية (الحزمة) والحقول الخاصة والحقول المُكتسَبة.

تم نقله من 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.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Object... optionSources)

ينشئ OptionParser جديدًا لضبط حقول @Option في optionSources.

المعلمات
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 للبحث

المرتجعات
	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: مفتاح خيارات الخريطة أو فارغ.
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 ()

عرض أسماء جميع Option التي تم وضع علامة عليها على أنّها mandatory ولكن لا تزال غير محدّدة

المرتجعات
	تمثّل هذه السمة ERROR(/Collection) من String تحتوي على أسماء (غير مؤهّلة) للخيارات الإلزامية غير المثبَّتة.

عمليات الرمي
ConfigurationException	إذا تعذّر الوصول إلى حقل يجب التحقّق منه