وحدة التحكم

public class Console
extends Object

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

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

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

  • إضافة طلب لإجراء اختبار
  • إدراج الأجهزة وحالتها
  • عرض عمليات الاستدعاء قيد التنفيذ
  • إدراج الأوامر في قائمة المحتوى التالي
  • تفريغ سجلّ الاستدعاء إلى ملف/stdout
  • إيقاف

ملخّص

الفئات المُدمجة

class Console.ArgRunnable<T>

Runnable مع طريقة run يمكنها قبول وسيطة 

class Console.CaptureList

نوع سهل الاستخدام لـ List<List<String>> 

الحقول

protected static final String DEBUG_PATTERN

protected static final String DUMP_PATTERN

protected static final String EXIT_PATTERN

protected static final String HELP_PATTERN

protected static final String INVOC_PATTERN

protected static final String LINE_SEPARATOR

protected static final String LIST_COMMANDS_PATTERN

protected static final String LIST_PATTERN

protected static final String REMOVE_PATTERN

protected static final String RUN_PATTERN

protected static final String SET_PATTERN

protected static final String VERSION_PATTERN

protected LineReader mConsoleReader

protected IKeyStoreFactory mKeyStoreFactory

protected ICommandScheduler mScheduler

وظائف الإنشاء المحمية

Console()

الطرق العامة

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)

طباعة السطر على أداة طباعة

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

نقطة تخصيص يمكن للطبقات الفرعية استخدامها لتغيير الأوامر المتاحة فيconsole.

الحقول

DEBUG_PATTERN

protected static final String DEBUG_PATTERN

DUMP_PATTERN

protected static final String DUMP_PATTERN

EXIT_PATTERN

protected static final String EXIT_PATTERN

HELP_PATTERN

protected static final String HELP_PATTERN

INVOC_PATTERN

protected static final String INVOC_PATTERN

LINE_SEPARATOR

protected static final String LINE_SEPARATOR

LIST_COMMANDS_PATTERN

protected static final String LIST_COMMANDS_PATTERN

LIST_PATTERN

protected static final String LIST_PATTERN

REMOVE_PATTERN

protected static final String REMOVE_PATTERN

RUN_PATTERN

protected static final String RUN_PATTERN

SET_PATTERN

protected static final String SET_PATTERN

VERSION_PATTERN

protected static final String VERSION_PATTERN

mConsoleReader

protected LineReader mConsoleReader

mKeyStoreFactory

protected IKeyStoreFactory mKeyStoreFactory

mScheduler

protected ICommandScheduler mScheduler

وظائف الإنشاء المحمية

وحدة التحكم

protected Console ()

الطرق العامة

الرئيسي

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)

طباعة السطر على أداة طباعة

المعلمات
pw PrintStream

setCustomCommands

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

نقطة تخصيص يمكن للفئتين الفرعيتين استخدامها لتغيير الأوامر المتاحة فيconsole.

يجب أن تعدّل عمليات التنفيذ المتغيّرَين genericHelp وcommandHelp لتسجيل الوظيفة التي ربما تمت إضافتها أو تعديلها أو إزالتها.

المعلمات
trie RegexTrie: RegexTrie لإضافة الأوامر إليها
genericHelp : ERROR(/List) من الأسطر المطلوب طباعتها عندما يُشغِّل المستخدم الأمر "help" بدون وسيطات.
commandHelp : ERROR(/Map) يحتوي على مستندات لأي أوامر جديدة قد تمت إضافتها المفتاح هو تعبير عادي لاستخدامه كمفتاح RegexTrie. يجب أن تكون قيمة سلسلة تحتوي على نص المساعدة المطلوب طباعته لهذا الأمر.