דף זה תורגם על ידי Cloud Translation API.

IConfigurationFactory

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationConfiguration

תת-כיתות עקיפות ידועות

ConfigurationFactory, ‏ GCSConfigurationFactory, ‏ RetryConfigurationFactory, ‏ SandboxConfigurationFactory

ConfigurationConfiguration	פקטורי (factory) ליצירת `IConfiguration`.
GCSConfigurationConfiguration	`ConfigurationFactory` טוען הגדרות מ-Google Cloud Storage.
RetryConfigurationConfiguration	מפעל שמטפל בניסיון חוזר של פקודה.
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)` יצירת גרסת dump של תוכן ההגדרות ב-`ERROR(/PrintStream)` שצוין
`abstract`	`getConfigList()` הפונקציה מחזירה את רשימת השמות של כל הגדרות ה-config שנמצאות בקובצי ה-JAR ב-classpath.
`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` להענקת גישה מאוכלסים בערכים בארגומנטים.

זריקות
`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` שמשמש לאחזור מידע רגיש ב-args.

החזרות
`IConfiguration`	`IConfiguration` שנטען. השדות `Option` של אובייקט הענקת הגישה אוכלסו בערכי args.

זריקות
`ConfigurationException`	אם לא ניתן לטעון את התצורה

createGlobalConfigurationFromArgs

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

יצירת IGlobalConfiguration מארגומנטים בשורת הפקודה.

הפורמט הצפוי הוא 'CONFIG [options]', כאשר CONFIG הוא שם התצורה המובנית או נתיב לקובץ XML של תצורה.

פרמטרים
`args`	`String`: הארגומנטים בשורת הפקודה
`nonGlobalArgs`	: רשימה שתאוכלס בארגומנטים שלא עובדו כארגומנטים גלובליים

החזרות
`IGlobalConfiguration`	`IGlobalConfiguration` שנטען. השדות של האובייקט `Option` להענקת גישה מאוכלסים בערכים בארגומנטים.

קליעות
`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)

יצירת גרסת dump של תוכן ההגדרות ב-ERROR(/PrintStream) שצוין

פרמטרים
`configName`	`String`: שם ההגדרות האישיות
`out`	`PrintStream`: ה-`ERROR(/PrintStream)` שאליו צריך להוריד את הפלט

getConfigList

public abstract  getConfigList ()

הפונקציה מחזירה את רשימת השמות של כל הגדרות ה-config שנמצאות בקובצי ה-JAR ב-classpath. לא מתבצע ניסיון לטעון אף אחד מהקובצי התצורה, כך שיכול להיות שיהיו ברשימה קובצי תצורה לא תקינים.

החזרות

getConfigList

public abstract  getConfigList (String subPath, 
                boolean loadFromEnv)

וריאציה של getConfigList() שבה אפשר לציין אם רוצים גם לטעון את התצורה מהסביבה.

פרמטרים
`subPath`	`String`: השם של ספריות המשנה שבהן ייבדקו הגדרות. אם הערך הוא null, ההתנהגות תהיה זהה לזו של `getConfigList()`.
`loadFromEnv`	`boolean`: הערך True (נכון) אם צריך לטעון את ההגדרות במשתנה הסביבה.

החזרות

printHelp

public abstract void printHelp (PrintStream out)

הדפסות עוזרות להפיק את הפלט של המפעל הזה.

הדפסת מידע כללי לעזרה ורשימת כל ההגדרות הזמינות.

פרמטרים
`out`	`PrintStream`: ה-`ERROR(/PrintStream)` שאליו רוצים לגרום ליצירת גרסת dump של הפלט

printHelpForConfig

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

הדפסת פלט עזרה של IConfiguration שצוין בארגומנטים של שורת הפקודה,

אם 'args' מפנה לתצורה ידועה, ייווצר אובייקט IConfiguration מ-XML ותופיע עזרה לגבי IConfiguration הזה. חשוב לזכור שכל שאר הערכים של 'args' יידחו (כלומר, טקסט העזרה יתאר את הערכים הנוכחיים של Options כפי שהם נטענו מ-XML, ולא ישקף את ערכי האפשרויות שהוגדרו על ידי args בשורת הפקודה.

אם 'args' לא מפנה ל-IConfiguration ידוע, תוצג העזרה הכלליות של printHelp(PrintStream).

פרמטרים
`args`	`String`: הארגומנטים בשורת הפקודה
`importantOnly`	`boolean`: אם הערך הוא `true`, תודפס עזרה מקוצרת עם הפרטים החשובים בלבד
`out`	`PrintStream`: ה-`ERROR(/PrintStream)` שאליו צריך להוריד את הפלט