وحدة التحكم

public class Console
extends Thread

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

وحدة تحكّم TradeFederation الرئيسية التي توفّر للمستخدم الواجهة اللازمة للتفاعل

تتيح حاليًا عمليات مثل

  • إضافة أمر للاختبار
  • عرض قائمة بالأجهزة وحالتها
  • list invocations in progress
  • عرض الأوامر في قائمة الانتظار
  • dump invocation log to file/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

طُرق وضع التصميم المحمية

Console()

الإجراءات العامة

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

Constant Value: "debug"

DUMP_PATTERN

protected static final String DUMP_PATTERN

Constant Value: "d(?:ump)?"

EXIT_PATTERN

protected static final String EXIT_PATTERN

Constant Value: "(?:q|exit)"

HELP_PATTERN

protected static final String HELP_PATTERN

Constant Value: "\?|h|help"

INVOC_PATTERN

protected static final String INVOC_PATTERN

Constant Value: "i(?:nvocation)?"

LIST_COMMANDS_PATTERN

protected static final String LIST_COMMANDS_PATTERN

Constant Value: "c(?:ommands)?"

LIST_PATTERN

protected static final String LIST_PATTERN

Constant Value: "l(?:ist)?"

REMOVE_PATTERN

protected static final String REMOVE_PATTERN

Constant Value: "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

Constant Value: "version"

الحقول

LINE_SEPARATOR

protected static final String LINE_SEPARATOR

mConsoleReader

protected LineReader mConsoleReader

mKeyStoreFactory

protected IKeyStoreFactory mKeyStoreFactory

mScheduler

protected ICommandScheduler mScheduler

طُرق وضع التصميم المحمية

وحدة التحكم

protected Console ()

الإجراءات العامة

المحتوى الرئيسي

public static void main (String[] mainArgs)

المعلَمات
mainArgs String

عمليات الطرح
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: وسيطات سطر الأوامر
عمليات الطرح
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. يجب أن تكون القيمة سلسلة تحتوي على نص المساعدة المطلوب طباعته لهذا الأمر.