IConfigurationFactory

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationFactory

مصنع لإنشاء 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

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) لتفريغ الإخراج