המסוף

public class Console
extends Thread

java.lang.Object
   ↳ java.lang.Thread
     ↳ com.android.tradefed.command.Console

המסוף הראשי של TradeFederation שמספק למשתמש את הממשק ליצירת אינטראקציה

כרגע יש תמיכה בפעולות כמו

  • הוספת פקודה לבדיקה
  • רשימת המכשירים והמצב שלהם
  • רשימת הפעלות בתהליך
  • הצגת רשימת הפקודות בתור
  • העברת יומן ההפעלה של ה-dump לקובץ או ל-stdout
  • כיבוי

סיכום

כיתות מוטמעות

class Console.ArgRunnable<T>

Runnable עם שיטת run שיכולה לקבל ארגומנט 

class Console.CaptureList

סוג נוח לשימוש עבור List<List<String>> 

ערכים קבועים

String DEBUG_PATTERN

String DUMP_PATTERN

String EXIT_PATTERN

String HELP_PATTERN

String INVOC_PATTERN

String LIST_COMMANDS_PATTERN

String LIST_PATTERN

String REMOVE_PATTERN

String RUN_PATTERN

String SET_PATTERN

String VERSION_PATTERN

שדות

protected static final String LINE_SEPARATOR

protected LineReader mConsoleReader

protected IKeyStoreFactory mKeyStoreFactory

protected ICommandScheduler mScheduler

‫Constructors מוגנים

Console()

‫methods ציבוריים

static void main(String[] mainArgs)
void run()

השיטה העיקרית להפעלת המסוף.

void setArgs(List<String> mainArgs)

הגדרת ארגומנטים להתחלה של המסוף.

static void startConsole(Console console, String[] args)

מפעיל את מסוף Tradefed שצוין עם הארגומנטים שצוינו

שיטות מוגנות

String getConsolePrompt()
String getGenericHelpString(List<String> genericHelp)

החזרת מחרוזת העזרה הגנרית להצגה

static LineReader getReader()

הפונקציה מחזירה LineReader חדש, או null אם מתרחשת שגיאת IOException.

void printLine(String output)

הצגת שורת טקסט במסוף

void printLine(String output, PrintStream pw)

הדפסת השורה במדפסת Printwriter

void setCustomCommands(RegexTrie<Runnable> trie, List<String> genericHelp, Map<String, String> commandHelp)

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

ערכים קבועים

DEBUG_PATTERN

protected static final String DEBUG_PATTERN

ערך קבוע: "debug"

DUMP_PATTERN

protected static final String DUMP_PATTERN

ערך קבוע: "d(?:ump)?"

EXIT_PATTERN

protected static final String EXIT_PATTERN

ערך קבוע: "(?:q|exit)"

HELP_PATTERN

protected static final String HELP_PATTERN

ערך קבוע: "\?|h|help"

INVOC_PATTERN

protected static final String INVOC_PATTERN

ערך קבוע: "i(?:nvocation)?"

LIST_COMMANDS_PATTERN

protected static final String LIST_COMMANDS_PATTERN

ערך קבוע: "c(?:ommands)?"

LIST_PATTERN

protected static final String LIST_PATTERN

ערך קבוע: "l(?:ist)?"

REMOVE_PATTERN

protected static final String REMOVE_PATTERN

ערך קבוע: "remove"

RUN_PATTERN

protected static final String RUN_PATTERN

ערך קבוע: "r(?:un)?"

SET_PATTERN

protected static final String SET_PATTERN

ערך קבוע: "s(?:et)?"

VERSION_PATTERN

protected static final String VERSION_PATTERN

ערך קבוע: "version"

שדות

LINE_SEPARATOR

protected static final String LINE_SEPARATOR

mConsoleReader

protected LineReader mConsoleReader

mKeyStoreFactory

protected IKeyStoreFactory mKeyStoreFactory

mScheduler

protected ICommandScheduler mScheduler

‫Constructors מוגנים

המסוף

protected Console ()

‫methods ציבוריים

ראשי

public static void main (String[] mainArgs)

פרמטרים
mainArgs String

הקפצת הודעות שגיאה (throw)
ConfigurationException
InterruptedException

ראן

public void run ()

השיטה העיקרית להפעלת המסוף. היא תמשיך לפעול עד שתינתן פקודת כיבוי.

setArgs

public void setArgs (List<String> mainArgs)

הגדרת ארגומנטים להתחלה של המסוף.

פרמטרים
mainArgs ‫List: הארגומנטים

startConsole

public static void startConsole (Console console, 
                String[] args)

מפעיל את מסוף Tradefed שצוין עם הארגומנטים שצוינו

פרמטרים
console Console: Console שמתחילים ממנו
args ‫String: הארגומנטים בשורת הפקודה
הקפצת הודעות שגיאה (throw)
ConfigurationException
InterruptedException

שיטות מוגנות

getConsolePrompt

protected String getConsolePrompt ()

החזרות
String הטקסט String שיוצג בהנחיה במסוף

getGenericHelpString

protected String getGenericHelpString (List<String> genericHelp)

החזרת מחרוזת העזרה הגנרית להצגה

פרמטרים
genericHelp ‫List: רשימה של String שמייצגת את העזרה הכללית שצריך לצבור.
החזרות
String

getReader

protected static LineReader getReader ()

הפונקציה מחזירה LineReader חדש, או null אם מתרחשת שגיאת IOException. שימו לב שהפונקציה הזו צריכה להיות סטטית כדי שנוכל להריץ אותה לפני בנאי מחלקת העל.

החזרות
LineReader

printLine

protected void printLine (String output)

הצגת שורת טקסט במסוף

printLine

protected void printLine (String output, 
                PrintStream pw)

הדפסת השורה במדפסת Printwriter

פרמטרים
pw PrintStream

setCustomCommands

protected void setCustomCommands (RegexTrie<Runnable> trie, 
                List<String> genericHelp, 
                Map<String, String> commandHelp)

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

ביישומים צריך לשנות את המשתנים genericHelp ו-commandHelp כדי לתעד את הפונקציונליות שאולי נוספה, שונתה או הוסרה.

פרמטרים
trie ‫RegexTrie: ה-RegexTrie שאליו רוצים להוסיף את הפקודות
genericHelp ‫List: List של שורות להדפסה כשהמשתמש מריץ את הפקודה help בלי ארגומנטים.
commandHelp ‫Map: Map שמכיל תיעוד של פקודות חדשות שאולי נוספו. המפתח הוא ביטוי רגולרי שמשמש כמפתח ל-RegexTrie. הערך צריך להיות מחרוזת שמכילה את טקסט העזרה להדפסה עבור הפקודה הזו.