ICommandScheduler
public interface ICommandScheduler
com.android.tradefed.command.ICommand Scheduler |
מתזמן להפעלת פקודות TradeFederation.
סיכום
כיתות מקוננות | |
---|---|
interface | ICommandScheduler.IScheduledInvocationListener מאזין לאירועי קריאה כאשר ההתקשרות מסתיימת. |
שיטות ציבוריות | |
---|---|
abstract Pair <Boolean, Integer> | addCommand (String[] args) מוסיף פקודה למתזמן. |
abstract void | addCommandFile (String cmdFile, extraArgs) addCommandFile (String cmdFile, extraArgs) מוסיף את כל הפקודות מהקובץ הנתון למתזמן |
abstract void | await () ממתין למתזמן שיתחיל לפעול, כולל המתנה למסירה מ-TF הישן כדי להשלים אם רלוונטי. |
abstract void | displayCommandQueue (PrintWriter printWriter) פלט מידע מפורט על ניפוי באגים על מצב תור ביצוע הפקודה. |
abstract void | displayCommandsInfo (PrintWriter printWriter, String regex) פלט רשימה של פקודות נוכחיות. |
abstract void | displayInvocationsInfo (PrintWriter printWriter) מציג רשימה של קריאות נוכחיות. |
abstract void | dumpCommandsXml (PrintWriter printWriter, String regex) זרוק את קובץ ה-XML המורחב עבור הפקודה עם כל ערכי |
abstract long | execCommand ( IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args) מקצה ישירות התקן ומבצע פקודה מבלי להוסיף אותה לתור הפקודות באמצעות |
abstract long | execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args) מקצה ישירות התקן ומבצע פקודה מבלי להוסיף אותה לתור הפקודות. |
abstract long | execCommand ( ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args) execCommand ( ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args) בצע פקודה ישירה במכשירים שכבר הוקצו. |
abstract CommandFileWatcher | getCommandFileWatcher () קבל את |
abstract int | getExecutingCommandCount () מחזירה את מספר הפקודות במצב ביצוע. |
abstract String | getInvocationInfo (int invocationId) החזר את המידע על הזמנה עם ציון מזהה ההזמנה. |
abstract CommandRunner.ExitCode | getLastInvocationExitCode () החזר את קוד השגיאה של ההזמנה האחרונה שרצה. |
abstract Throwable | getLastInvocationThrowable () החזר את |
abstract int | getReadyCommandCount () מחזירה את מספר הפקודות במצב מוכן בתור. |
abstract boolean | isDeviceInInvocationThread ( ITestDevice device) מחזירה true אם ההתקן נמצא בשימוש על ידי שרשור הפעלה פעיל. |
abstract void | join () ממתין להשלמת מתזמן. |
abstract void | join (long millis) ממתין לסיום המתזמן או פסק זמן קצר לאחר משך הזמן שצוין באלפיות שניות. |
abstract void | removeAllCommands () הסר את כל הפקודות מתזמן |
abstract void | setClearcutClient (ClearcutClient client) הגדר את הלקוח לדווח על נתוני רתמה |
abstract boolean | shouldShutdownOnCmdfileError () החזר true אם אנחנו צריכים לכבות את המתזמן על שגיאות פקודה |
default void | shutdown () נסה לכבות בחן את מתזמן הפקודות. |
abstract void | shutdown (boolean notifyStop) נסה לכבות בחן את מתזמן הפקודות. |
abstract void | shutdownHard (boolean killAdb) נסה לכבות בכוח את מתזמן הפקודות. |
abstract void | shutdownHard () נסה לכבות בכוח את מתזמן הפקודות. |
abstract void | shutdownOnEmpty () דומה ל- |
abstract void | start () הפעל את |
abstract boolean | stopInvocation (int invocationId, String cause) עצור זימון רץ על ידי ציון המזהה שלו. |
default boolean | stopInvocation (int invocationId) עצור זימון רץ על ידי ציון המזהה שלו. |
abstract boolean | stopInvocation ( ITestInvocation invocation) עצור קריאת טלפון רצה. |
שיטות ציבוריות
addCommand
public abstract Pair<Boolean, Integer> addCommand (String[] args)
מוסיף פקודה למתזמן.
פקודה היא בעצם מופע של תצורה להפעלה והארגומנטים המשויכים לה.
אם ארגומנט "--help" מצוין, טקסט העזרה עבור התצורה ייצא ל-stdout. אחרת, התצורה תתווסף לתור להפעלה.
פרמטרים | |
---|---|
args | String : הארגומנטים של התצורה. |
החזרות | |
---|---|
Pair <Boolean, Integer> | זוג ערכים, הערך הראשון הוא true בוליאני אם הפקודה נוספה בהצלחה. הערך השני הוא מזהה הפקודה הידוע (ערך לא שלילי) אם הפקודה נוספה בהצלחה, החזר 0 כאשר הפקודה מתווספת עבור כל המכשירים, אחרת -1. |
זורק | |
---|---|
ConfigurationException | אם לא ניתן היה לנתח את הפקודה |
addCommandFile
public abstract void addCommandFile (String cmdFile,extraArgs)
מוסיף את כל הפקודות מהקובץ הנתון למתזמן
פרמטרים | |
---|---|
cmdFile | String : נתיב מערכת הקבצים של קובץ הפקודה |
extraArgs | ERROR(/List) של ארגומנטים ERROR(/String) להוספה לכל פקודה שמנותחת מהקובץ. יכול להיות ריק אבל לא צריך להיות null. |
זורק | |
---|---|
ConfigurationException | אם לא ניתן היה לנתח את קובץ הפקודה |
ראה גם:
לְהַמתִין
public abstract void await ()
ממתין למתזמן שיתחיל לפעול, כולל המתנה למסירה מ-TF הישן כדי להשלים אם רלוונטי.
displayCommandQueue
public abstract void displayCommandQueue (PrintWriter printWriter)
פלט מידע מפורט על ניפוי באגים על מצב תור ביצוע הפקודה.
להציג פקודות מידע
public abstract void displayCommandsInfo (PrintWriter printWriter, String regex)
פלט רשימה של פקודות נוכחיות.
פרמטרים | |
---|---|
printWriter | PrintWriter : ה- ERROR(/PrintWriter) שאליו יש פלט. |
regex | String : הביטוי הרגולרי שאליו יש להתאים פקודות כדי להדפיס. אם null, אז כל הפקודות יודפסו. |
displayInvocationsInfo
public abstract void displayInvocationsInfo (PrintWriter printWriter)
מציג רשימה של קריאות נוכחיות.
פרמטרים | |
---|---|
printWriter | PrintWriter : ה- ERROR(/PrintWriter) שאליו יש פלט. |
dumpCommandsXml
public abstract void dumpCommandsXml (PrintWriter printWriter, String regex)
זרוק את קובץ ה-XML המורחב עבור הפקודה עם כל ערכי Option
שצוינו עבור כל הפקודות הנוכחיות.
פרמטרים | |
---|---|
printWriter | PrintWriter : ה- ERROR(/PrintWriter) שאליו יש פלט של הסטטוס. |
regex | String : הביטוי הרגולרי שאליו יש להתאים פקודות על מנת שקובץ ה-xml יושלך. אם null, אז כל הפקודות יוזרקו. |
execCommand
public abstract long execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)
מקצה ישירות התקן ומבצע פקודה מבלי להוסיף אותה לתור הפקודות באמצעות IInvocationContext
שכבר קיים.
פרמטרים | |
---|---|
context | IInvocationContext : IInvocationContext קיים. |
listener | ICommandScheduler.IScheduledInvocationListener : יש ליידע את ICommandScheduler.IScheduledInvocationListener |
args | String : הארגומנטים של הפקודה |
החזרות | |
---|---|
long |
זורק | |
---|---|
ConfigurationException | אם הפקודה לא הייתה חוקית |
NoDeviceException | אם אין מכשיר לשימוש |
execCommand
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, String[] args)
מקצה ישירות התקן ומבצע פקודה מבלי להוסיף אותה לתור הפקודות.
פרמטרים | |
---|---|
listener | ICommandScheduler.IScheduledInvocationListener : יש ליידע את ICommandScheduler.IScheduledInvocationListener |
args | String : הארגומנטים של הפקודה |
החזרות | |
---|---|
long | מזהה ההזמנה של הפקודה המתוזמנת. |
זורק | |
---|---|
ConfigurationException | אם הפקודה לא הייתה חוקית |
NoDeviceException | אם אין מכשיר לשימוש |
execCommand
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener,devices, String[] args)
בצע פקודה ישירה במכשירים שכבר הוקצו.
פרמטרים | |
---|---|
listener | ICommandScheduler.IScheduledInvocationListener : יש ליידע את ICommandScheduler.IScheduledInvocationListener |
devices | ERROR(/List ) ERROR(/List ) לשימוש |
args | String : הארגומנטים של הפקודה |
החזרות | |
---|---|
long | מזהה ההזמנה של הפקודה המתוזמנת. |
זורק | |
---|---|
ConfigurationException | אם הפקודה לא הייתה חוקית |
getCommandFileWatcher
public abstract CommandFileWatcher getCommandFileWatcher ()
קבל את CommandFileWatcher
המתאים עבור מתזמן זה
החזרות | |
---|---|
CommandFileWatcher |
getExecutingCommandCount
public abstract int getExecutingCommandCount ()
מחזירה את מספר הפקודות במצב ביצוע.
החזרות | |
---|---|
int |
getInvocationInfo
public abstract String getInvocationInfo (int invocationId)
החזר את המידע על הזמנה עם ציון מזהה ההזמנה.
פרמטרים | |
---|---|
invocationId | int : מזהה המעקב של הפנייה. |
החזרות | |
---|---|
String | ERROR(/String) המכילה מידע על ההפעלה. |
getLastInvocationExitCode
public abstract CommandRunner.ExitCode getLastInvocationExitCode ()
החזר את קוד השגיאה של ההזמנה האחרונה שרצה. החזר 0 (ללא שגיאה), אם לא רצה עדיין הזמנה.
החזרות | |
---|---|
CommandRunner.ExitCode |
getLastInvocationThrowable
public abstract Throwable getLastInvocationThrowable ()
החזר את ERROR(/Throwable)
מההפניה האחרונה שרצה. החזר null, אם אין זריקה זמינה.
החזרות | |
---|---|
Throwable |
getReadyCommandCount
public abstract int getReadyCommandCount ()
מחזירה את מספר הפקודות במצב מוכן בתור.
החזרות | |
---|---|
int |
isDeviceInInvocationThread
public abstract boolean isDeviceInInvocationThread (ITestDevice device)
מחזירה true אם ההתקן נמצא בשימוש על ידי שרשור הפעלה פעיל.
פרמטרים | |
---|---|
device | ITestDevice |
החזרות | |
---|---|
boolean |
לְהִצְטַרֵף
public abstract void join (long millis)
ממתין לסיום המתזמן או פסק זמן קצר לאחר משך הזמן שצוין באלפיות שניות.
פרמטרים | |
---|---|
millis | long |
ראה גם:
הסר את כל הפקודות
public abstract void removeAllCommands ()
הסר את כל הפקודות מתזמן
setClearcutClient
public abstract void setClearcutClient (ClearcutClient client)
הגדר את הלקוח לדווח על נתוני רתמה
פרמטרים | |
---|---|
client | ClearcutClient |
shouldShutdownOnCmdfileError
public abstract boolean shouldShutdownOnCmdfileError ()
החזר true אם אנחנו צריכים לכבות את המתזמן על שגיאות פקודה
החזרות | |
---|---|
boolean |
לכבות
public void shutdown ()
נסה לכבות בחן את מתזמן הפקודות.
מנקה פקודות הממתינות לבדיקה, ומבקש שכל השיחות שמתנהלות ייסגרו בחן.
לאחר קריאת הכיבוי, הלולאה הראשית של המתזמן תחכה להשלמה של כל הפניות בתהליך לפני שתצא לחלוטין.
לכבות
public abstract void shutdown (boolean notifyStop)
נסה לכבות בחן את מתזמן הפקודות.
פרמטרים | |
---|---|
notifyStop | boolean : אם זה נכון, מודיע על קריאות של כיבוי TF. |
כיבוי קשה
public abstract void shutdownHard (boolean killAdb)
נסה לכבות בכוח את מתזמן הפקודות.
דומה ל- shutdown()
, אבל גם יהרוג באופן אופציונלי את חיבור ה-ADB, בניסיון 'לעורר' קריאות שמתנהלות כדי להשלים מהר יותר.
פרמטרים | |
---|---|
killAdb | boolean |
כיבוי קשה
public abstract void shutdownHard ()
נסה לכבות בכוח את מתזמן הפקודות. זהה ל-shutdownHard (true).
shutdownOnEmpty
public abstract void shutdownOnEmpty ()
דומה ל- shutdown()
, אך במקום זאת ימתין לביצוע כל הפקודות לפני היציאה.
שים לב שאם פקודות כלשהן נמצאות במצב לולאה, המתזמן לעולם לא ייצא.
הַתחָלָה
public abstract void start ()
הפעל את ICommandScheduler
.
יש להתקשר לפני שמתקשרים לשיטות אחרות.
יפעל עד shutdown()
ייקרא. ראה ERROR(/Thread#start())
.
stopInvocation
public abstract boolean stopInvocation (int invocationId, String cause)
עצור זימון רץ על ידי ציון המזהה שלו.
פרמטרים | |
---|---|
invocationId | int : מזהה המעקב של הפנייה. |
cause | String : הסיבה להפסקת ההתקשרות. |
החזרות | |
---|---|
boolean | נכון אם הקריאה הופסקה, לא נכון אחרת |
זורק | |
---|---|
| אם היישום אינו תומך בכך |
stopInvocation
public boolean stopInvocation (int invocationId)
עצור זימון רץ על ידי ציון המזהה שלו.
פרמטרים | |
---|---|
invocationId | int |
החזרות | |
---|---|
boolean | נכון אם הקריאה הופסקה, לא נכון אחרת |
זורק | |
---|---|
| אם היישום אינו תומך בכך |
stopInvocation
public abstract boolean stopInvocation (ITestInvocation invocation)
עצור קריאת טלפון רצה.
פרמטרים | |
---|---|
invocation | ITestInvocation |
החזרות | |
---|---|
boolean | נכון אם הקריאה הופסקה, לא נכון אחרת |
זורק | |
---|---|
| אם היישום אינו תומך בכך |
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2023-03-30 (שעון UTC).