מסוף

public class Console
extends Object

java.lang.Object
   ↳ 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( mainArgs)

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

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

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

שיטות מוגנות

String getConsolePrompt()
String getGenericHelpString( genericHelp)

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

static LineReader getReader()

מחזירה LineReader חדש, או null אם מתרחשת IOException.

void printLine(String output)

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

void printLine(String output, PrintStream pw)

הדפסת השורה באמצעות Printwriter

void setCustomCommands(RegexTrie<Runnable> trie, genericHelp, 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

זריקות
ConfigurationException

ראן

public void run ()

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

setArgs

public void setArgs ( mainArgs)

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

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

startConsole

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

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

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

שיטות מוגנות

getConsolePrompt

protected String getConsolePrompt ()

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

getGenericHelpString

protected String getGenericHelpString ( genericHelp)

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

פרמטרים
genericHelp ‫: רשימה של 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, 
                 genericHelp, 
                 commandHelp)

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

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

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