IConfigurationFactory

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationFactory

الفئات الفرعية غير المباشرة المعروفة ‫ConfigurationFactory وGCSConfigurationFactory وRetryConfigurationFactory وSandboxConfigurationFactory ConfigurationFactory مصنع لإنشاء IConfiguration  GCSConfigurationFactory تحمّل ConfigurationFactory الإعدادات من Google Cloud Storage.  RetryConfigurationFactory مصنع يتعامل مع إعادة محاولة تنفيذ أمر.  SandboxConfigurationFactory مصنع الإعدادات الخاص للتعامل مع إنشاء الإعدادات لأغراض وضع الحماية

---

مصنع لإنشاء IConfiguration

ملخّص

الإجراءات العامة
abstract IConfiguration	createConfigurationFromArgs(String[] args, List<String> unconsumedArgs, IKeyStoreClient keyStoreClient) أنشئ IConfiguration من وسيطات سطر الأوامر باستخدام مخزن مفاتيح.
abstract IConfiguration	createConfigurationFromArgs(String[] args, List<String> unconsumedArgs) إنشاء IConfiguration من وسيطات سطر الأوامر
abstract IConfiguration	createConfigurationFromArgs(String[] args) طريقة ملائمة تستدعي createConfigurationFromArgs(String[],List) مع وسيطة null ثانية.
abstract IGlobalConfiguration	createGlobalConfigurationFromArgs(String[] args, List<String> nonGlobalArgs) إنشاء IGlobalConfiguration من وسيطات سطر الأوامر
abstract IConfiguration	createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, Set<String> allowedObjects, TradefedDelegator delegator) إنشاء إعدادات تحتوي فقط على مجموعة من الكائنات المحدّدة
abstract void	dumpConfig(String configName, PrintStream out) تفريغ محتوى الإعدادات إلى PrintStream المحدّد
abstract List<String>	getConfigList() تعرض هذه الطريقة قائمة بأسماء جميع الإعدادات التي تم العثور عليها في ملفات JAR في مسار الفئة.
abstract List<String>	getConfigList(String subPath, boolean loadFromEnv) صيغة getConfigList() حيث يمكنك تحديد ما إذا كنت تريد أيضًا تحميل الإعدادات من البيئة أم لا.
abstract void	printHelp(PrintStream out) تساعد عمليات الطباعة في إخراج البيانات لهذه السمة.
abstract void	printHelpForConfig(String[] args, boolean importantOnly, PrintStream out) طباعة ناتج المساعدة الخاص بـ IConfiguration المحدّد في وسيطات سطر الأوامر إذا كانت "args" تشير إلى إعداد معروف، سيتم إنشاء عنصر IConfiguration من XML، وسيتم عرض المساعدة الخاصة بهذا العنصر IConfiguration.

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

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                List<String> unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

أنشئ IConfiguration من وسيطات سطر الأوامر باستخدام مخزن مفاتيح.

التنسيق المتوقّع هو "CONFIG [options]"، حيث CONFIG هو اسم الإعدادات المضمّنة أو مسار ملف XML للإعدادات.

المعلَمات
args	‫String: وسيطات سطر الأوامر
unconsumedArgs	‫List: قائمة سيتم ملؤها بالوسيطات التي لم يتم استهلاكها من خلال العناصر المرتبطة بالإعدادات المحدّدة. إذا كانت القيمة null، سيؤدي التنفيذ إلى طرح الخطأ ConfigurationException إذا بقيت أي وسيطات لم تتم معالجتها.
keyStoreClient	IKeyStoreClient: IKeyStoreClient يُستخدم للحصول على معلومات حساسة في الوسيطات.

المرتجعات
IConfiguration	IConfiguration التي تم تحميلها تمت تعبئة حقول عنصر التفويض Option بالقيم الواردة في args.

عمليات الطرح
ConfigurationException	في حال تعذّر تحميل الإعدادات

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                List<String> unconsumedArgs)

إنشاء IConfiguration من وسيطات سطر الأوامر

التنسيق المتوقّع هو "CONFIG [options]"، حيث CONFIG هو اسم الإعدادات المضمّنة أو مسار ملف XML للإعدادات.

المعلَمات
args	‫String: وسيطات سطر الأوامر
unconsumedArgs	‫List: قائمة سيتم ملؤها بالوسيطات التي لم يتم استهلاكها من خلال العناصر المرتبطة بالإعدادات المحدّدة. إذا كانت القيمة null، سيؤدي التنفيذ إلى طرح الخطأ ConfigurationException إذا بقيت أي وسيطات لم تتم معالجتها.

المرتجعات
IConfiguration	IConfiguration التي تم تحميلها تمت تعبئة حقول عنصر التفويض Option بالقيم الواردة في args.

عمليات الطرح
ConfigurationException	في حال تعذّر تحميل الإعدادات

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args)

طريقة ملائمة تستدعي createConfigurationFromArgs(String[],List) مع وسيطة null ثانية. وبالتالي، سيتم طرح ConfigurationException إذا بقيت أي وسيطات غير مستهلكة.

المعلَمات
args	String

القيم المُعادة
IConfiguration

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

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

• createConfigurationFromArgs(String[],List)

createGlobalConfigurationFromArgs

public abstract IGlobalConfiguration createGlobalConfigurationFromArgs (String[] args, 
                List<String> nonGlobalArgs)

إنشاء IGlobalConfiguration من وسيطات سطر الأوامر

التنسيق المتوقّع هو "CONFIG [options]"، حيث CONFIG هو اسم الإعدادات المضمّنة أو مسار ملف XML للإعدادات.

المعلَمات
args	‫String: وسيطات سطر الأوامر
nonGlobalArgs	List: قائمة سيتم ملؤها بالوسيطات التي لم تتم معالجتها كوسيطات عامة

المرتجعات
IGlobalConfiguration	IGlobalConfiguration التي تم تحميلها تمت تعبئة حقول عنصر التفويض Option بالقيم الواردة في args.

عمليات الطرح
ConfigurationException	في حال تعذّر تحميل الإعدادات

createPartialConfigurationFromArgs

public abstract IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                Set<String> allowedObjects, 
                TradefedDelegator delegator)

إنشاء إعدادات تحتوي فقط على مجموعة من الكائنات المحدّدة

المعلَمات
arrayArgs	String: وسيطات سطر الأوامر
keyStoreClient	IKeyStoreClient: IKeyStoreClient يُستخدم للحصول على معلومات حساسة في الوسيطات.
allowedObjects	‫Set: مجموعة العناصر المسموح بإنشائها
delegator	TradefedDelegator

المرتجعات
IConfiguration	IConfiguration الذي تم تحميله

عمليات الطرح
ConfigurationException	في حال تعذّر تحميل الإعدادات

dumpConfig

public abstract void dumpConfig (String configName, 
                PrintStream out)

تفريغ محتوى الإعدادات إلى PrintStream المحدّد

المعلَمات
configName	‫String: اسم الإعداد
out	‫PrintStream: PrintStream الذي سيتم إرسال الناتج إليه

getConfigList

public abstract List<String> getConfigList ()

تعرض هذه الطريقة قائمة بأسماء جميع الإعدادات التي تم العثور عليها في ملفات JAR في مسار الفئة. لا تحاول تحميل أي من الإعدادات، لذا من المحتمل أن تتضمّن هذه القائمة إعدادات لا تعمل.

المرتجعات
List<String>

getConfigList

public abstract List<String> getConfigList (String subPath, 
                boolean loadFromEnv)

صيغة getConfigList() حيث يمكنك تحديد ما إذا كنت تريد أيضًا تحميل الإعدادات من البيئة أم لا.

المعلَمات
subPath	String: اسم الدلائل الفرعية التي سيتم البحث فيها عن الإعدادات. إذا كانت القيمة فارغة، سيكون السلوك مماثلاً للسلوك في getConfigList().
loadFromEnv	boolean: تكون القيمة True إذا كان يجب تحميل الإعداد في متغيّر البيئة.

المرتجعات
List<String>

printHelp

public abstract void printHelp (PrintStream out)

تساعد عمليات الطباعة في إخراج البيانات لهذه السمة.

يطبع معلومات مساعدة عامة، ويسرد جميع الإعدادات المتاحة.

المعلَمات
out	‫PrintStream: PrintStream الذي سيتم إرسال الناتج إليه

printHelpForConfig

public abstract void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

طباعة ناتج المساعدة الخاص بـ IConfiguration المحدّد في وسيطات سطر الأوامر

إذا كانت "args" تشير إلى إعداد معروف، سيتم إنشاء عنصر IConfiguration من XML، وسيتم عرض المساعدة الخاصة بهذا العنصر IConfiguration. يُرجى العِلم أنّه سيتم تجاهل جميع قيم "args" الأخرى (أي أنّ نص المساعدة سيصف القيم الحالية لـ Options كما تم تحميلها من XML، ولن يعكس قيم الخيار التي تم ضبطها بواسطة وسيطات سطر الأوامر.

إذا لم يشِر "args" إلى IConfiguration معروف، سيتم عرض المساعدة العامة printHelp(PrintStream).

المعلَمات
args	‫String: وسيطات سطر الأوامر
importantOnly	‫boolean: إذا كانت القيمة true، اطبع قائمة مختصرة للمساعدة تتضمّن التفاصيل المهمة فقط
out	‫PrintStream: PrintStream الذي سيتم إرسال الناتج إليه