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 המורחב עבור הפקודה עם כל ערכי Option שצוינו עבור כל הפקודות הנוכחיות.

abstract long execCommand ( IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

מקצה ישירות התקן ומבצע פקודה מבלי להוסיף אותה לתור הפקודות באמצעות IInvocationContext שכבר קיים.

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 ()

קבל את CommandFileWatcher המתאים עבור מתזמן זה

abstract int getExecutingCommandCount ()

מחזירה את מספר הפקודות במצב ביצוע.

abstract String getInvocationInfo (int invocationId)

החזר את המידע על הזמנה עם ציון מזהה ההזמנה.

abstract CommandRunner.ExitCode getLastInvocationExitCode ()

החזר את קוד השגיאה של ההזמנה האחרונה שרצה.

abstract Throwable getLastInvocationThrowable ()

החזר את Throwable מההפצה האחרונה שרצה.

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 ()

דומה ל- shutdown() , אך במקום זאת ימתין לביצוע כל הפקודות לפני היציאה.

abstract void start ()

הפעל את ICommandScheduler .

abstract boolean stopInvocation (int invocationId, String cause)

עצור זימון רץ על ידי ציון המזהה שלו.

default boolean stopInvocation (int invocationId)

עצור זימון רץ על ידי ציון המזהה שלו.

abstract boolean stopInvocation ( ITestInvocation invocation)

עצור קריאת טלפון רצה.

default void stopScheduling ()

מפסיק לתזמן ולקבל בדיקות חדשות אך לא מפסיק את Tradefed.

שיטות ציבוריות

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) של ארגומנטים של 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 String המכילה מידע על ההזמנה.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

החזר את קוד השגיאה של ההזמנה האחרונה שרצה. החזר 0 (ללא שגיאה), אם לא רצה עדיין הזמנה.

החזרות
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

החזר את Throwable מההפצה האחרונה שרצה. החזר null, אם אין זריקה זמינה.

החזרות
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

מחזירה את מספר הפקודות במצב מוכן בתור.

החזרות
int

isDeviceInInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

מחזירה true אם ההתקן נמצא בשימוש על ידי שרשור הפעלה פעיל.

פרמטרים
device ITestDevice

החזרות
boolean

לְהִצְטַרֵף

public abstract void join ()

ממתין להשלמת מתזמן.

ראה גם:

לְהִצְטַרֵף

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() ייקרא. ראה Thread.start() .

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

עצור זימון רץ על ידי ציון המזהה שלו.

פרמטרים
invocationId int : מזהה המעקב של הפנייה.

cause String : הסיבה להפסקת ההתקשרות.

החזרות
boolean נכון אם הקריאה הופסקה, לא נכון אחרת

זורק
UnsupportedOperationException אם היישום אינו תומך בכך

stopInvocation

public boolean stopInvocation (int invocationId)

עצור זימון רץ על ידי ציון המזהה שלו.

פרמטרים
invocationId int

החזרות
boolean נכון אם הקריאה הופסקה, לא נכון אחרת

זורק
UnsupportedOperationException אם היישום אינו תומך בכך

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

עצור קריאת טלפון רצה.

פרמטרים
invocation ITestInvocation

החזרות
boolean נכון אם הקריאה הופסקה, לא נכון אחרת

זורק
UnsupportedOperationException אם היישום אינו תומך בכך

עצור תזמון

public void stopScheduling ()

מפסיק לתזמן ולקבל בדיקות חדשות אך לא מפסיק את Tradefed. זה נועד לאפשר כיבוי של שני שלבים שבו קודם כל ננקז את כל הבדיקות הפועלות, ואז מסיים את תהליך Tradefed.