ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler


جدولة لتشغيل أوامر TradeFederation.

ملخص

فئات متداخلة

interface ICommandScheduler.IScheduledInvocationListener

مستمع لأحداث الاحتجاج عند اكتمال الاستدعاء.

الأساليب العامة

abstract Pair <Boolean, Integer> addCommand (String[] args)

يضيف أمرًا إلى المجدول.

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

يضيف كل الأوامر من ملف معين إلى المجدول

abstract void await ()

انتظار بدء تشغيل المجدول ، بما في ذلك انتظار التسليم من فريق العمل القديم حتى يكتمل إن أمكن.

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

يخصص جهازًا بشكل مباشر وينفذ أمرًا دون إضافته إلى قائمة انتظار الأوامر باستخدام IInvocationContext الموجود بالفعل.

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

يخصص جهازًا بشكل مباشر وينفذ أمرًا دون إضافته إلى قائمة انتظار الأوامر.

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

تنفيذ الأمر مباشرة على الأجهزة المخصصة بالفعل.

abstract CommandFileWatcher getCommandFileWatcher ()

احصل على CommandFileWatcher المناسب لهذا المجدول

abstract int getExecutingCommandCount ()

إرجاع عدد الأوامر في حالة التنفيذ.

abstract String getInvocationInfo (int invocationId)

قم بإرجاع المعلومات على استدعاء bu يحدد معرّف الاستدعاء.

abstract CommandRunner.ExitCode getLastInvocationExitCode ()

قم بإرجاع رمز الخطأ الخاص بآخر استدعاء تم تشغيله.

abstract Throwable getLastInvocationThrowable ()

قم بإرجاع ERROR(/Throwable) من الاستدعاء الأخير الذي تم تشغيله.

abstract int getReadyCommandCount ()

تُرجع عدد الأوامر في حالة الاستعداد في قائمة الانتظار.

abstract boolean isDeviceInInvocationThread ( ITestDevice device)

يعود صحيحًا إذا تم استخدام الجهاز بواسطة سلسلة استدعاء نشطة.

abstract void join ()

ينتظر حتى يكتمل المجدول.

abstract void join (long millis)

ينتظر اكتمال المجدول أو انتهاء المهلة بعد المدة المحددة بالمللي ثانية.

abstract void removeAllCommands ()

قم بإزالة كافة الأوامر من المجدول

abstract void setClearcutClient (ClearcutClient client)

اضبط العميل على الإبلاغ عن بيانات التسخير

abstract boolean shouldShutdownOnCmdfileError ()

العودة صحيحًا إذا احتجنا إلى إيقاف تشغيل المجدول عند حدوث أخطاء في الأمر

default void shutdown ()

محاولة إيقاف تشغيل برنامج جدولة الأوامر بأمان.

abstract void shutdown (boolean notifyStop)

محاولة إيقاف تشغيل برنامج جدولة الأوامر بأمان.

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 Pair<Boolean, Integer> addCommand (String[] args)

يضيف أمرًا إلى المجدول.

الأمر هو في الأساس مثيل للتكوين الذي سيتم تشغيله والوسيطات المرتبطة به.

إذا تم تحديد الوسيطة "--help" ، فسيتم إخراج نص التعليمات الخاص بالتكوين إلى stdout. خلاف ذلك ، ستتم إضافة التكوين إلى قائمة الانتظار للتشغيل.

حدود
args String : وسيطات التكوين.

عائدات
Pair <Boolean, Integer> زوج من القيم ، القيمة الأولى هي قيمة منطقية true إذا تم إضافة الأمر بنجاح. القيمة الثانية هي معرف تعقب الأمر المعروف (قيمة غير سالبة) إذا تمت إضافة الأمر بنجاح ، فقم بإرجاع 0 عند إضافة الأمر لجميع الأجهزة ، وإلا -1.

رميات
ConfigurationException إذا تعذر تحليل الأمر

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

يضيف كل الأوامر من ملف معين إلى المجدول

حدود
cmdFile String : مسار نظام الملفات لملف comand

extraArgs : ERROR(/List) وسيطات ERROR(/String) لإلحاقها بكل أمر تم تحليله من الملف. يمكن أن يكون فارغًا ولكن لا يجب أن يكون فارغًا.

رميات
ConfigurationException إذا تعذر تحليل ملف الأوامر

أنظر أيضا:

انتظر

public abstract void await ()

انتظار بدء تشغيل المجدول ، بما في ذلك انتظار التسليم من فريق العمل القديم حتى يكتمل إن أمكن.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

إخراج معلومات تصحيح الأخطاء التفصيلية في قائمة انتظار تنفيذ الأوامر.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

قم بإخراج قائمة بالأوامر الحالية.

حدود
printWriter PrintWriter : ERROR(/PrintWriter) للإخراج إلى.

regex String : التعبير العادي الذي يجب مطابقة الأوامر من أجل طباعتها. إذا كانت فارغة ، فستتم طباعة جميع الأوامر.

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. إذا كانت فارغة ، فسيتم التخلص من جميع الأوامر.

execCommand

public abstract long execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

يخصص جهازًا بشكل مباشر وينفذ أمرًا دون إضافته إلى قائمة انتظار الأوامر باستخدام IInvocationContext الموجود بالفعل.

حدود
context IInvocationContext : IInvocationContext موجود.

listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener .

args String : وسيطات الأمر

عائدات
long

رميات
ConfigurationException إذا كان الأمر غير صالح
NoDeviceException إذا لم يكن هناك جهاز لاستخدامه

execCommand

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

يخصص جهازًا بشكل مباشر وينفذ أمرًا دون إضافته إلى قائمة انتظار الأوامر.

حدود
listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener .

args String : وسيطات الأمر

عائدات
long معرّف الاستدعاء للأمر المجدول.

رميات
ConfigurationException إذا كان الأمر غير صالح
NoDeviceException إذا لم يكن هناك جهاز لاستخدامه

execCommand

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

تنفيذ الأمر مباشرة على الأجهزة المخصصة بالفعل.

حدود
listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener .

devices : ERROR(/List ) ERROR(/List ) للاستخدام

args String : وسيطات الأمر

عائدات
long معرّف الاستدعاء للأمر المجدول.

رميات
ConfigurationException إذا كان الأمر غير صالح

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

احصل على CommandFileWatcher المناسب لهذا المجدول

عائدات
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

إرجاع عدد الأوامر في حالة التنفيذ.

عائدات
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

قم بإرجاع المعلومات على استدعاء bu يحدد معرّف الاستدعاء.

حدود
invocationId int : معرّف التعقب للاستدعاء.

عائدات
String ERROR(/String) يحتوي على معلومات حول الاستدعاء.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

قم بإرجاع رمز الخطأ الخاص بآخر استدعاء تم تشغيله. قم بإرجاع 0 (بدون خطأ) ، إذا لم يتم تنفيذ أي استدعاء بعد.

عائدات
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

قم بإرجاع ERROR(/Throwable) من الاستدعاء الأخير الذي تم تشغيله. العودة فارغة ، إذا لم يكن هناك رمي متاح.

عائدات
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

تُرجع عدد الأوامر في حالة الاستعداد في قائمة الانتظار.

عائدات
int

isDeviceInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

يعود صحيحًا إذا تم استخدام الجهاز بواسطة سلسلة استدعاء نشطة.

حدود
device ITestDevice

عائدات
boolean

ينضم

public abstract void join ()

ينتظر حتى يكتمل المجدول.

أنظر أيضا:

ينضم

public abstract void join (long millis)

ينتظر اكتمال المجدول أو انتهاء المهلة بعد المدة المحددة بالمللي ثانية.

حدود
millis long

أنظر أيضا:

إزالة AllCommands

public abstract void removeAllCommands ()

قم بإزالة كافة الأوامر من المجدول

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

اضبط العميل على الإبلاغ عن بيانات التسخير

حدود
client ClearcutClient

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

العودة صحيحًا إذا احتجنا إلى إيقاف تشغيل المجدول عند حدوث أخطاء في الأمر

عائدات
boolean

اغلق

public void shutdown ()

محاولة إيقاف تشغيل برنامج جدولة الأوامر بأمان.

يمسح الأوامر التي تنتظر أن يتم اختبارها ، ويطلب إغلاق جميع الاستدعاءات قيد التقدم بأمان.

بعد استدعاء إيقاف التشغيل ، ستنتظر الحلقة الرئيسية لجدول المواعيد حتى تكتمل جميع الاستدعاءات قيد التقدم قبل الخروج تمامًا.

اغلق

public abstract void shutdown (boolean notifyStop)

محاولة إيقاف تشغيل برنامج جدولة الأوامر بأمان.

حدود
notifyStop boolean : إذا كان صحيحًا ، يخطر استدعاءات إيقاف تشغيل TF.

الاغلاق

public abstract void shutdownHard (boolean killAdb)

محاولة إيقاف تشغيل برنامج جدولة الأوامر بالقوة.

على غرار shutdown() ، ولكنه سيؤدي أيضًا إلى إنهاء اتصال adb اختياريًا ، في محاولة "إلهام" الدعوات قيد التقدم لإكمالها بشكل أسرع.

حدود
killAdb boolean

الاغلاق

public abstract void shutdownHard ()

محاولة إيقاف تشغيل برنامج جدولة الأوامر بالقوة. نفس الاغلاق صعب (صحيح).

إيقاف التشغيل فارغة

public abstract void shutdownOnEmpty ()

على غرار shutdown() ، لكنه سينتظر بدلاً من ذلك تنفيذ جميع الأوامر قبل الخروج.

لاحظ أنه إذا كانت هناك أية أوامر في وضع التكرار ، فلن يخرج المجدول أبدًا.

يبدأ

public abstract void start ()

ابدأ تشغيل ICommandScheduler .

يجب الاتصال قبل استدعاء الطرق الأخرى.

سوف يعمل حتى يتم استدعاء shutdown() . راجع ERROR(/Thread#start()) .

وقف الدعوة

public abstract boolean stopInvocation (int invocationId, 
                String cause)

أوقف الاحتجاج الجاري بتحديد معرفه.

حدود
invocationId int : معرف تتبع الاحتجاج.

cause String : سبب وقف الدعاء.

عائدات
boolean صحيح إذا تم إيقاف الاحتجاج ، وخلاف ذلك خطأ

رميات
إذا كان التنفيذ لا يدعم هذا

وقف الدعوة

public boolean stopInvocation (int invocationId)

أوقف الاحتجاج الجاري بتحديد معرفه.

حدود
invocationId int

عائدات
boolean صحيح إذا تم إيقاف الاحتجاج ، وخلاف ذلك خطأ

رميات
إذا كان التنفيذ لا يدعم هذا

وقف الدعوة

public abstract boolean stopInvocation (ITestInvocation invocation)

وقف الدعاء الجاري.

حدود
invocation ITestInvocation

عائدات
boolean صحيح إذا تم إيقاف الاحتجاج ، وخلاف ذلك خطأ

رميات
إذا كان التنفيذ لا يدعم هذا