ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommand Scheduler


מתזמן להפעלת פקודות TradeFederation.

סיכום

כיתות מקוננות

interface ICommandScheduler.IScheduledInvocationListener

מאזין לאירועי קריאה כאשר ההתקשרות מסתיימת.

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

abstract boolean addCommand (String[] args)

מוסיף פקודה למתזמן.

abstract void addCommandFile (String cmdFile, extraArgs) addCommandFile (String cmdFile, extraArgs)

מוסיף את כל הפקודות מהקובץ הנתון למתזמן

abstract void await ()

ממתין למתזמן שיתחיל לפעול, כולל המתנה למסירה מ-TF הישן כדי להשלים אם רלוונטי.

abstract void completeHandover ()

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

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 void execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

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

abstract void execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args)

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

abstract void execCommand ( ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, 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 void handoverInitiationComplete ()

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

abstract boolean handoverShutdown (int handoverPort)

יוזם shutdown() ומסירה לתהליך אחר המוזן במסחר באותו מארח.

abstract void join ()

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

abstract void join (long millis)

ממתין לסיום המתזמן או פסק זמן קצר לאחר משך הזמן שצוין באלפיות שניות.

abstract void removeAllCommands ()

הסר את כל הפקודות מתזמן

abstract void setClearcutClient (ClearcutClient client)

הגדר את הלקוח לדווח על נתוני רתמה

abstract boolean shouldShutdownOnCmdfileError ()

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

abstract void shutdown ()

נסה לכבות בחן את מתזמן הפקודות.

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)

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

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

addCommand

public abstract boolean addCommand (String[] args)

מוסיף פקודה למתזמן.

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

אם ארגומנט "--help" מצוין, טקסט העזרה עבור התצורה ייצא ל-stdout. אחרת, התצורה תתווסף לתור להפעלה.

פרמטרים
args String : הארגומנטים של התצורה.

החזרות
boolean true אם הפקודה נוספה בהצלחה

זורק
ConfigurationException אם לא ניתן היה לנתח את הפקודה

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

מוסיף את כל הפקודות מהקובץ הנתון למתזמן

פרמטרים
cmdFile String : נתיב מערכת הקבצים של קובץ הפקודה

extraArgs : ERROR(/List) של ארגומנטים של String להוספה לכל פקודה שמנותחת מהקובץ. יכול להיות ריק אבל לא צריך להיות null.

זורק
ConfigurationException אם לא ניתן היה לנתח את קובץ הפקודה

ראה גם:

לְהַמתִין

public abstract void await ()

ממתין למתזמן שיתחיל לפעול, כולל המתנה למסירה מ-TF הישן כדי להשלים אם רלוונטי.

מסירה מלאה

public abstract void completeHandover ()

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

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 void execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

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

פרמטרים
context IInvocationContext : IInvocationContext קיים.

listener ICommandScheduler.IScheduledInvocationListener : יש ליידע את ICommandScheduler.IScheduledInvocationListener

args String : הארגומנטים של הפקודה

זורק
ConfigurationException אם הפקודה לא הייתה חוקית
NoDeviceException אם אין מכשיר לשימוש

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

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

פרמטרים
listener ICommandScheduler.IScheduledInvocationListener : יש ליידע את ICommandScheduler.IScheduledInvocationListener

args String : הארגומנטים של הפקודה

זורק
ConfigurationException אם הפקודה לא הייתה חוקית
NoDeviceException אם אין מכשיר לשימוש

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

בצע פקודה ישירה במכשיר שכבר הוקצה.

פרמטרים
listener ICommandScheduler.IScheduledInvocationListener : יש ליידע את ICommandScheduler.IScheduledInvocationListener

device ITestDevice : ה- ITestDevice לשימוש

args String : הארגומנטים של הפקודה

זורק
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

מסירת פתיחה הושלמה

public abstract void handoverInitiationComplete ()

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

כיבוי מסירה

public abstract boolean handoverShutdown (int handoverPort)

יוזם shutdown() ומסירה לתהליך אחר המוזן במסחר באותו מארח.

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

פרמטרים
handoverPort int

החזרות
boolean true אם תחילת המסירה הייתה מוצלחת, false אחרת

לְהִצְטַרֵף

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 abstract void shutdown ()

נסה לכבות בחן את מתזמן הפקודות.

מנקה פקודות הממתינות לבדיקה, ומבקש שכל השיחות שמתנהלות ייסגרו בחן.

לאחר קריאת הכיבוי, הלולאה הראשית של המתזמן תחכה להשלמה של כל הפניות בתהליך לפני שתצא לחלוטין.

כיבוי קשה

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 אם היישום אינו תומך בכך