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.Handler<T>
class	OptionSetter.MapHandler Handler للتعامل مع قيم حقول "الخريطة"
class	OptionSetter.OptionFieldsForName حاوية لقائمة حقول الخيارات بالاسم المحدّد

الثوابت
char	NAMESPACE_SEPARATOR

طُرق وضع التصميم العامة
OptionSetter(Object... optionSources) تنشئ هذه الدالة برنامج OptionParser جديدًا لضبط حقول @Option الخاصة بـ "optionSources".
OptionSetter(Collection<Object> optionSources) تنشئ هذه الدالة برنامج OptionParser جديدًا لضبط حقول @Option الخاصة بـ "optionSources".

الإجراءات العامة
static Object	getFieldValue(Field field, Object optionObject) لعرض قيمة Field المحدّدة، مع معالجة أي استثناءات
static OptionSetter.Handler<T>	getHandler(Type type)
IKeyStoreClient	getKeyStore()
static List<Field>	getOptionFieldsForClass(Class<?> optionClass) تعرض هذه الطريقة قائمة بجميع حقول Option (المحدّدة والموروثة) لفئة معيّنة.
String	getTypeForOption(String name) تعرض هذه الدالة سلسلة تصف نوع الحقل الذي يحمل الاسم المحدّد.
boolean	isBooleanOption(String name)
boolean	isMapOption(String name)
static boolean	setFieldValue(String optionName, Object optionSource, Field field, Object key, Object value, boolean checkOption) تضبط هذه السمة قيمة الحقل Option المحدّد.
void	setKeyStore(IKeyStoreClient keyStore)
List<OptionSetter.FieldDef>	setOptionValue(String optionName, String valueText) تضبط هذه السمة قيمة خيار غير خريطة.
List<OptionSetter.FieldDef>	setOptionValue(String optionName, String keyText, String valueText) تضبط هذه السمة قيمة أحد الخيارات.
final Set<File>	validateRemoteFilePath(DynamicRemoteFileResolver resolver) يتم تنفيذ جميع أنواع الخيارات File والتحقّق مما إذا كان يجب حلّ مسارها.

طُرق محمية
Collection<String>	getUnsetMandatoryOptions() تعرِض هذه السمة أسماء جميع Option التي تم وضع علامة mandatory عليها ولكنها تظل غير مضبوطة.

الثوابت

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

Constant Value: 58 (0x0000003a)

طُرق وضع التصميم العامة

OptionSetter

public OptionSetter (Object... optionSources)

تنشئ هذه الدالة برنامج OptionParser جديدًا لضبط حقول @Option الخاصة بـ "optionSources".

المعلَمات
optionSources	Object

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

OptionSetter

public OptionSetter (Collection<Object> optionSources)

تنشئ هذه الدالة برنامج OptionParser جديدًا لضبط حقول @Option الخاصة بـ "optionSources".

المعلَمات
optionSources	Collection

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

الإجراءات العامة

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

لعرض قيمة Field المحدّدة، مع معالجة أي استثناءات

المعلَمات
field	Field: Field
optionObject	Object: Object الذي سيتم استرداد قيمة الحقل منه.

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

getHandler

public static OptionSetter.Handler<T> getHandler (Type type)

المعلَمات
type	Type

القيم المُعادة
OptionSetter.Handler<T>

عمليات الطرح
ConfigurationException

getKeyStore

public IKeyStoreClient getKeyStore ()

المرتجعات
IKeyStoreClient

getOptionFieldsForClass

public static List<Field> getOptionFieldsForClass (Class<?> optionClass)

تعرض هذه الطريقة قائمة بجميع حقول Option (المحدّدة والموروثة) لفئة معيّنة.

المعلَمات
optionClass	Class: Class للبحث

المرتجعات
List<Field>	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

setFieldValue

public static boolean setFieldValue (String optionName, 
                Object optionSource, 
                Field field, 
                Object key, 
                Object value, 
                boolean checkOption)

تضبط هذه السمة قيمة الحقل Option المحدّد.

المعلَمات
optionName	String: الاسم المحدّد في Option
optionSource	Object: Object المطلوب ضبطه
field	Field: Field
key	‫Object: مفتاح لإدخال في حقل Map أو MultiMap أو قيمة فارغة
value	Object: القيمة المطلوب ضبطها
checkOption	boolean

المرتجعات
boolean	ما إذا تم ضبط الحقل.

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

يُرجى الاطّلاع أيضًا على:

• OptionUpdateRule

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

المعلَمات
keyStore	IKeyStoreClient

setOptionValue

public List<OptionSetter.FieldDef> setOptionValue (String optionName, 
                String valueText)

تضبط هذه السمة قيمة خيار غير خريطة.

المعلَمات
optionName	‫String: اسم الخيار المطلوب ضبطه
valueText	String: القيمة

المرتجعات
List<OptionSetter.FieldDef>	قائمة ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) تتوافق مع كل حقل من حقول الكائن تم تعديله.

عمليات الطرح
ConfigurationException	إذا لم يتم العثور على الخيار أو كان نوع valueText غير صحيح

setOptionValue

public List<OptionSetter.FieldDef> setOptionValue (String optionName, 
                String keyText, 
                String valueText)

تضبط هذه السمة قيمة أحد الخيارات.

المعلَمات
optionName	‫String: اسم الخيار المطلوب ضبطه
keyText	‫String: مفتاح خيارات الخريطة أو قيمة فارغة
valueText	String: القيمة

المرتجعات
List<OptionSetter.FieldDef>	قائمة ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) تتوافق مع كل حقل من حقول الكائن تم تعديله.

عمليات الطرح
ConfigurationException	إذا لم يتم العثور على الخيار أو كان نوع valueText غير صحيح

validateRemoteFilePath

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

يتم تنفيذ جميع أنواع الخيارات File والتحقّق مما إذا كان يجب حلّ مسارها.

المعلَمات
resolver	DynamicRemoteFileResolver: DynamicRemoteFileResolver المطلوب استخدامه لتحديد الملفات.

المرتجعات
Set<File>	قائمة File التي تم حلّها بهذه الطريقة

عمليات الطرح
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

طُرق محمية

getUnsetMandatoryOptions

protected Collection<String> getUnsetMandatoryOptions ()

تعرِض هذه السمة أسماء جميع Option التي تم وضع علامة mandatory عليها ولكنها تظل غير مضبوطة.

المرتجعات
Collection<String>	قائمة Collection من Strings تحتوي على أسماء (غير مؤهَّلة) للخيارات الإلزامية غير المضبوطة.

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