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)

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

abstract CommandRunner.ExitCode getLastInvocationExitCode ()

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

abstract Throwable getLastInvocationThrowable ()

قم بإرجاع 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)

إيقاف استدعاء قيد التشغيل.

default void stopScheduling ()

يتوقف عن جدولة وقبول الاختبارات الجديدة ولكنه لا يوقف Tradefed.

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

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) من وسيطات 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) الذي سيتم الإخراج إليه.

تفريغCommandsXml

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)

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

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

عائدات
String String تحتوي على معلومات حول الاستدعاء.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

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

عائدات
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

قم بإرجاع Throwable من آخر استدعاء تم تشغيله. يُرجع فارغًا، في حالة عدم توفر أي شيء قابل للرمي.

عائدات
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

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

عائدات
int

isDeviceInInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

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

حدود
device ITestDevice

عائدات
boolean

ينضم

public abstract void join ()

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

أنظر أيضا:

ينضم

public abstract void join (long millis)

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

حدود
millis long

أنظر أيضا:

RemoveAllCommands

public abstract void removeAllCommands ()

إزالة جميع الأوامر من المجدول

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

قم بتعيين العميل للإبلاغ عن بيانات الحزام

حدود
client ClearcutClient

يجب أن تكون ShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

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

عائدات
boolean

اغلق

public void shutdown ()

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

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

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

اغلق

public abstract void shutdown (boolean notifyStop)

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

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

ShutdownHard

public abstract void shutdownHard (boolean killAdb)

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

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

حدود
killAdb boolean

ShutdownHard

public abstract void shutdownHard ()

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

ShutdownOnEmpty

public abstract void shutdownOnEmpty ()

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

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

يبدأ

public abstract void start ()

ابدأ برنامج ICommandScheduler .

يجب الاتصال به قبل الاتصال بالطرق الأخرى.

سيتم تشغيله حتى يتم استدعاء shutdown() . راجع Thread.start() .

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

قم بإيقاف استدعاء قيد التشغيل عن طريق تحديد معرفه.

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

cause String : سبب إيقاف الاستدعاء.

عائدات
boolean صحيح إذا تم إيقاف الاستدعاء، وباطل فيما عدا ذلك

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

stopInvocation

public boolean stopInvocation (int invocationId)

قم بإيقاف استدعاء قيد التشغيل عن طريق تحديد معرفه.

حدود
invocationId int

عائدات
boolean صحيح إذا تم إيقاف الاستدعاء، وباطل فيما عدا ذلك

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

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

إيقاف استدعاء قيد التشغيل.

حدود
invocation ITestInvocation

عائدات
boolean صحيح إذا تم إيقاف الاستدعاء، وباطل فيما عدا ذلك

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

stopScheduling

public void stopScheduling ()

يتوقف عن جدولة وقبول الاختبارات الجديدة ولكنه لا يوقف Tradefed. ويهدف هذا إلى تمكين إيقاف التشغيل على خطوتين حيث نقوم أولاً باستنزاف كافة الاختبارات الجارية، ثم إنهاء عملية Tradefed.