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, unconsumedArgs) أنشئ IConfiguration من وسيطات سطر الأوامر.
abstract IConfiguration	createConfigurationFromArgs(String[] args) طريقة مساعدة تستدعي ERROR(/#createConfigurationFromArgs(String[],List)) باستخدام وسيطة ثانية null.
abstract IConfiguration	createConfigurationFromArgs(String[] args, unconsumedArgs, IKeyStoreClient keyStoreClient) أنشئ IConfiguration من مَعلمات سطر الأوامر باستخدام متجر مفاتيح.
abstract IGlobalConfiguration	createGlobalConfigurationFromArgs(String[] args, nonGlobalArgs) أنشئ IGlobalConfiguration من وسيطات سطر الأوامر.
abstract IConfiguration	createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) أنشئ إعدادات تحتوي فقط على مجموعة من العناصر المحدّدة.
abstract void	dumpConfig(String configName, PrintStream out) تفريغ محتوى الإعدادات في ERROR(/PrintStream) المحدَّد
abstract	getConfigList() عرض قائمة بأسماء جميع الإعدادات المتوفّرة في حِزم JAR على مسار تحميل الحِزم
abstract	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, 
                 unconsumedArgs)

أنشئ IConfiguration من وسيطات سطر الأوامر.

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

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

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

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

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args)

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

المعلمات
args	String

المرتجعات
IConfiguration

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

راجِع أيضًا:

• ERROR(/#createConfigurationFromArgs(String[], List))

createConfigurationFromArgs

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

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

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

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

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

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

createGlobalConfigurationFromArgs

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

أنشئ IGlobalConfiguration من وسيطات سطر الأوامر.

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

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

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

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

createPartialConfigurationFromArgs

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

أنشئ إعدادات تحتوي فقط على مجموعة من العناصر المحدّدة.

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

المرتجعات
IConfiguration	تم تحميل IConfiguration.

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

dumpConfig

public abstract void dumpConfig (String configName, 
                PrintStream out)

تفريغ محتوى الإعدادات في ERROR(/PrintStream) المحدَّد

المعلمات
configName	String: اسم الإعداد
out	‫PrintStream: ERROR(/PrintStream) لتفريغ الإخراج

getConfigList

public abstract  getConfigList ()

عرض قائمة بأسماء جميع الإعدادات المتوفّرة في حِزم JAR على مسار تحميل الحِزم لا تحاول تحميل أي من الإعدادات، لذا من الممكن أن تتضمّن هذه القائمة إعدادات غير صالحة.

المرتجعات

getConfigList

public abstract  getConfigList (String subPath, 
                boolean loadFromEnv)

يشير هذا الاختلاف إلى getConfigList() حيث يمكننا تحديد ما إذا كنا نريد أيضًا تحميل الإعدادات من البيئة أم لا.

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

المرتجعات

printHelp

public abstract void printHelp (PrintStream out)

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

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

المعلمات
out	‫PrintStream: ERROR(/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: ERROR(/PrintStream) لتفريغ الإخراج