IRunUtil
public interface IRunUtil
com.android.tradefed.util.IRunUtil |
واجهة لتشغيل العمليات الموقوتة وأوامر النظام.
ملخص
فئات متداخلة | |
---|---|
interface | IRunUtil.IRunnableResult واجهة لتنفيذ عملية بشكل غير متزامن تقوم بإرجاع الحالة المنطقية. |
الأساليب العامة | |
---|---|
abstract void | allowInterrupt (boolean allow) يسمح / لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي. |
abstract void | interrupt (Thread thread, String message, ErrorIdentifier errorId) يقطع عمليات التشغيل الجارية / القادمة على مؤشر الترابط المحدد. |
abstract void | interrupt (Thread thread, String message) يقطع عمليات التشغيل الجارية / القادمة على مؤشر الترابط المحدد. |
abstract boolean | isInterruptAllowed () امنح حالة المقاطعة لـ RunUtil. |
abstract Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) أسلوب |
abstract Process | runCmdInBackground ( command) runCmdInBackground ( command) أسلوب |
abstract Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) الأمر الذي يتم تشغيله باستخدام |
abstract Process | runCmdInBackground (String... command) طريقة المساعد لتنفيذ أمر النظام بشكل غير متزامن. |
abstract Process | runCmdInBackground (Redirect redirect, String... command) طريقة المساعد لتنفيذ أمر النظام بشكل غير متزامن. |
abstract boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) منع العملية وتنفيذها عدة مرات حتى تنجح. |
abstract boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) منع العملية وتنفيذها عدة مرات حتى تنجح. |
abstract CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) حظر وتنفيذ عملية ، والإيقاف إذا استغرقت وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) طريقة المساعدة لتنفيذ أمر النظام ، والإيقاف إذا استغرق وقتًا أطول من الوقت المحدد ، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده. |
abstract CommandResult | runTimedCmd (long timeout, String... command) طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command) طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdSilently (long timeout, String... command) طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command) طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) طريقة المساعدة لتنفيذ أمر النظام ، والإيقاف إذا استغرق وقتًا أطول من الوقت المحدد ، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) طريقة Helper لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) منع العملية وتنفيذها عدة مرات حتى تنجح. |
abstract void | setEnvVariable (String key, String value) يضبط متغير بيئة لاستخدامه عند تشغيل أوامر النظام. |
abstract void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) قرر ما إذا كان عدم ضبط متغير البيئة يمثل أولوية أعلى من تعيينها عند إنشاء عملية أم لا. |
abstract void | setInterruptibleInFuture (Thread thread, long timeMs) تعيين كمقاطعة بعد بعض وقت الانتظار. |
abstract void | setLinuxInterruptProcess (boolean interrupt) اسمح باستخدام مقاطعة linux 'kill' في العملية التي تعمل من خلال أساليب #runTimed عندما تصل إلى المهلة المحددة. |
abstract void | setRedirectStderrToStdout (boolean redirect) اضبط تدفق الخطأ القياسي لإعادة التوجيه إلى تدفق الإخراج القياسي عند تشغيل أوامر النظام. |
abstract void | setWorkingDir (File dir) يضبط دليل العمل لأوامر النظام. |
abstract void | sleep (long time) طريقة مساعدة للنوم لوقت معين ، مع تجاهل أي استثناءات. |
abstract void | unsetEnvVariable (String key) إلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا. |
الأساليب العامة
السماح المقاطعة
public abstract void allowInterrupt (boolean allow)
يسمح / لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي. إذا كان مسموحًا بذلك ، يمكن مقاطعة عمليات تشغيل الخيط الحالي من مؤشرات الترابط الأخرى عبر طريقة interrupt(Thread, String)
.
حدود | |
---|---|
allow | boolean : ما إذا كان سيتم السماح بمقاطعات التشغيل على مؤشر الترابط الحالي. |
يقطع
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
يقطع عمليات التشغيل الجارية / القادمة على مؤشر الترابط المحدد. ستؤدي عمليات التشغيل على مؤشر الترابط المحدد إلى طرح RunInterruptedException
.
حدود | |
---|---|
message | String : الرسالة الخاصة بـ RunInterruptedException . |
errorId | ErrorIdentifier : يمثل سبب الانقطاع عند معرفته. |
يقطع
public abstract void interrupt (Thread thread, String message)
يقطع عمليات التشغيل الجارية / القادمة على مؤشر الترابط المحدد. ستؤدي عمليات التشغيل على مؤشر الترابط المحدد إلى طرح RunInterruptedException
.
حدود | |
---|---|
message | String : الرسالة الخاصة بـ RunInterruptedException . |
هو InterruptAllowed
public abstract boolean isInterruptAllowed ()
امنح حالة المقاطعة لـ RunUtil.
عائدات | |
---|---|
boolean | صحيح إذا كان من الممكن مقاطعة التشغيل ، أو خطأ إذا كان الأمر كذلك. |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
أسلوب runCmdInBackground(String)
بديل يقبل وسيطات الأمر في نموذج ERROR(/List)
.
حدود | |
---|---|
redirect | Redirect : ERROR(/Redirect) المطلوب تطبيقه على ProcessBuilder . |
command | ERROR(/List) الذي يحتوي على أمر نظام محدد ووسيطات اختياريًا لتنفيذها |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
رميات | |
---|---|
| إذا فشل الأمر في التشغيل |
runCmdInBackground
public abstract Process runCmdInBackground (command)
أسلوب runCmdInBackground(String)
بديل يقبل وسيطات الأمر في نموذج ERROR(/List)
.
حدود | |
---|---|
command | ERROR(/List) الذي يحتوي على أمر نظام محدد ووسيطات اختياريًا لتنفيذها |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
رميات | |
---|---|
| إذا فشل الأمر في التشغيل |
runCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
الأمر الذي يتم تشغيله باستخدام ERROR(/OutputStream)
يقوم بتسجيل إخراج الأمر. يتم دمج Stdout و stderr معًا.
حدود | |
---|---|
command | |
output | OutputStream : تيار OutputStream لحفظ الإخراج |
عائدات | |
---|---|
Process | Process تشغيل الأمر |
رميات | |
---|---|
| IOException |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
طريقة المساعد لتنفيذ أمر النظام بشكل غير متزامن.
سيعود مباشرة بعد إطلاق الأمر.
حدود | |
---|---|
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
رميات | |
---|---|
| إذا فشل الأمر في التشغيل |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
طريقة المساعد لتنفيذ أمر النظام بشكل غير متزامن.
سيعود مباشرة بعد إطلاق الأمر.
حدود | |
---|---|
redirect | Redirect : ERROR(/Redirect) المطلوب تطبيقه على ProcessBuilder . |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
رميات | |
---|---|
| إذا فشل الأمر في التشغيل |
runEscalatingTimedRetry
public abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
منع العملية وتنفيذها عدة مرات حتى تنجح.
زيادة وقت الانتظار بين محاولات التشغيل بشكل كبير. هذا مخصص للاستخدام عند إجراء عملية مثل استقصاء الخادم ، لمنحه وقتًا للتعافي في حالة تعطله مؤقتًا.
حدود | |
---|---|
opTimeout | long : أقصى وقت للانتظار بالمللي ثانية لمحاولة عملية واحدة |
initialPollInterval | long : الوقت الأولي للانتظار بين محاولات العملية |
maxPollInterval | long : أقصى وقت للانتظار بين محاولات العملية |
maxTime | long : إجمالي الوقت التقريبي الأقصى لمواصلة تجربة العملية |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ |
عائدات | |
---|---|
boolean | true إذا اكتملت العملية بنجاح قبل انتهاء صلاحية maxTime |
runFixedTimedRetry
public abstract boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
منع العملية وتنفيذها عدة مرات حتى تنجح.
حدود | |
---|---|
opTimeout | long : أقصى وقت للانتظار بالمللي ثانية لمحاولة عملية واحدة |
pollInterval | long : الوقت الأولي للانتظار بين محاولات العملية |
maxTime | long : إجمالي الوقت التقريبي الأقصى لمواصلة تجربة العملية |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ |
عائدات | |
---|---|
boolean | true إذا اكتملت العملية بنجاح قبل انتهاء صلاحية maxTime |
runTimed
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
حظر وتنفيذ عملية ، والإيقاف إذا استغرقت وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : أقصى وقت للانتظار بالمللي ثانية |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ |
logErrors | boolean : سجل أخطاء استثناء أم لا. |
عائدات | |
---|---|
CommandStatus | CommandStatus نتيجة العملية. |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
طريقة المساعدة لتنفيذ أمر النظام ، والإيقاف إذا استغرق وقتًا أطول من الوقت المحدد ، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده. عندما يتم توفير ERROR(/OutputStream)
بهذه الطريقة ، سيتم تركها مفتوحة في نهاية الوظيفة.
حدود | |
---|---|
timeout | long : المهلة القصوى للانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة. |
stdout | OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه إخراج std. يمكن أن تكون خالية. |
stderr | OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه ناتج الخطأ. يمكن أن تكون خالية. |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : أقصى وقت للانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة. |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedCmdRetry
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : أقصى وقت للانتظار بالمللي ثانية لكل محاولة |
retryInterval | long : وقت الانتظار بين محاولات إعادة الأمر |
attempts | int : أقصى عدد من محاولات المحاولة |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedCmd بصمت
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. مشابه لـ runTimedCmd(long, String)
، لكنه لا يسجل أي أخطاء عند الاستثناء.
حدود | |
---|---|
timeout | long : أقصى وقت للانتظار بالمللي ثانية |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedCmd بصمت إعادة المحاولة
public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
طريقة المساعد لتنفيذ أمر النظام ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد. مشابه لـ runTimedCmdRetry(long, long, int, String[])
، لكنه لا يسجل أي أخطاء في الاستثناء.
حدود | |
---|---|
timeout | long : أقصى وقت للانتظار بالمللي ثانية |
retryInterval | long : وقت الانتظار بين محاولات إعادة الأمر |
attempts | int : أقصى عدد من محاولات المحاولة |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
طريقة المساعدة لتنفيذ أمر النظام ، والإيقاف إذا استغرق وقتًا أطول من الوقت المحدد ، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده.
حدود | |
---|---|
timeout | long : المهلة القصوى للانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة. |
input | String : إدخال stdin لتمريرها إلى العملية |
stdoutFile | File : ERROR(/File) حيث سيتم إعادة توجيه إخراج std. يمكن أن تكون خالية. |
stderrFile | File : ERROR(/File) حيث سيتم إعادة توجيه ناتج الخطأ. يمكن أن تكون خالية. |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : أقصى وقت للانتظار بالمللي ثانية |
input | String : إدخال stdin لتمريرها إلى العملية |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : أقصى وقت للانتظار بالمللي ثانية |
input | String : إدخال stdin لتمريرها إلى العملية |
command | ERROR(/List) يحتوي على أمر النظام والوسيطات الاختيارية للتنفيذ |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
طريقة Helper لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : أقصى وقت للانتظار بالمللي ثانية |
inputRedirect | File : ERROR(/File) لإعادة التوجيه كمدخل قياسي باستخدام ProcessBuilder.redirectInput() . إذا كانت القيمة فارغة ، فلن يتم إعادة توجيه stdin. |
command | String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا |
عائدات | |
---|---|
CommandResult | يحتوي CommandResult على نتيجة من تشغيل الأمر |
runTimedRetry
public abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
منع العملية وتنفيذها عدة مرات حتى تنجح.
حدود | |
---|---|
opTimeout | long : أقصى وقت للانتظار بالمللي ثانية لمحاولة عملية واحدة |
pollInterval | long : وقت الانتظار بين محاولات إعادة الأمر |
attempts | int : أقصى عدد من محاولات المحاولة |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ |
عائدات | |
---|---|
boolean | true إذا اكتملت العملية بنجاح قبل الوصول إلى المحاولات. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
يضبط متغير بيئة لاستخدامه عند تشغيل أوامر النظام.
حدود | |
---|---|
key | String : اسم المتغير |
value | String : القيمة المتغيرة |
أنظر أيضا:
setEnvVariable الأولوية
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
قرر ما إذا كان عدم ضبط متغير البيئة يمثل أولوية أعلى من تعيينها عند إنشاء عملية أم لا. بشكل افتراضي ، يكون إلغاء الضبط أولوية أعلى: بمعنى أنه إذا تم إجراء محاولة لتعيين متغير بنفس الاسم ، فلن يحدث ذلك لأن المتغير لن يتم تعيينه. لا يمكن استخدامها على المثيل الافتراضي IRunUtil
.
حدود | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
تعيين كمقاطعة بعد بعض وقت الانتظار. ERROR(/CommandScheduler#shutdownHard())
لفرض إنهاء العمل في النهاية.
حدود | |
---|---|
thread | Thread : الخيط الذي سيصبح قابلاً للمقاطعة. |
timeMs | long : حان وقت الانتظار قبل ضبط المقاطعة. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
اسمح باستخدام مقاطعة linux 'kill' في العملية التي تعمل من خلال أساليب #runTimed عندما تصل إلى المهلة المحددة. لا يمكن استخدامها على المثيل الافتراضي IRunUtil
.
حدود | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
اضبط تدفق الخطأ القياسي لإعادة التوجيه إلى تدفق الإخراج القياسي عند تشغيل أوامر النظام. القيمة الأولية خاطئة.
حدود | |
---|---|
redirect | boolean : قيمة جديدة لإعادة التوجيه من عدمه |
أنظر أيضا:
setWorkingDir
public abstract void setWorkingDir (File dir)
يضبط دليل العمل لأوامر النظام.
حدود | |
---|---|
dir | File : دليل العمل |
أنظر أيضا:
ينام
public abstract void sleep (long time)
طريقة مساعدة للنوم لوقت معين ، مع تجاهل أي استثناءات.
حدود | |
---|---|
time | long : مللي للنوم. سيتم تجاهل القيم التي تقل عن 0 أو تساويها |
unsetEnvvariable
public abstract void unsetEnvVariable (String key)
إلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا.
حدود | |
---|---|
key | String : اسم المتغير |
أنظر أيضا:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-07-19 (حسب التوقيت العالمي المتفَّق عليه)