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 boolean | runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, 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 | runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, 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) طريقة مساعدة لتنفيذ أمر نظام يتطلب إدخال stdin، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) طريقة مساعدة لتنفيذ أمر نظام يتطلب إدخال stdin، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) طريقة مساعدة لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف، وإحباطه إذا استغرق الأمر وقتًا أطول من الوقت المحدد. |
abstract CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده. |
abstract CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
abstract boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) حظر العملية وتنفيذها عدة مرات حتى تنجح. |
abstract boolean | runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) حظر العملية وتنفيذها عدة مرات حتى تنجح. |
abstract CommandStatus | runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors) حظر العملية وتنفيذها، وإحباطها إذا استغرقت وقتًا أطول من الوقت المحدد. |
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) يقوم بإلغاء تعيين متغير البيئة، بحيث تعمل أوامر النظام بدون متغير البيئة هذا. |
الأساليب العامة
allowInterrupt
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 . |
isInterruptAllowed
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) الذي يحتوي على أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
رميات | |
---|---|
| إذا فشل الأمر في التشغيل |
runCmdInBackground
public abstract Process runCmdInBackground (command)
طريقة runCmdInBackground(String)
بديلة تقبل وسيطات الأمر في نموذج ERROR(/List)
.
حدود | |
---|---|
command | ERROR(/List) الذي يحتوي على أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
رميات | |
---|---|
| إذا فشل الأمر في التشغيل |
runCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
يؤدي تشغيل الأمر باستخدام ERROR(/OutputStream)
إلى تسجيل إخراج الأمر. يتم دمج Stdout وstderr معًا.
حدود | |
---|---|
command | |
output | OutputStream : OutputStream لحفظ الإخراج |
عائدات | |
---|---|
Process | Process تشغيل الأمر |
رميات | |
---|---|
| IOEException |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
طريقة مساعدة لتنفيذ أمر النظام بشكل غير متزامن
سيعود مباشرة بعد إطلاق الأمر.
حدود | |
---|---|
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
رميات | |
---|---|
| إذا فشل الأمر في التشغيل |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
طريقة مساعدة لتنفيذ أمر النظام بشكل غير متزامن
سيعود مباشرة بعد إطلاق الأمر.
حدود | |
---|---|
redirect | Redirect : ERROR(/Redirect) الذي سيتم تطبيقه على ProcessBuilder . |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
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 |
runFixedTimedRetryWithOutputMonitor
public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
حظر العملية وتنفيذها عدة مرات حتى تنجح. يراقب أيضًا تدفقات الإخراج للنشاط، ويتم إحباطه إذا لم تتم ملاحظة أي نشاط للتدفق لفترة محددة. إذا تم تعيين idleOutputTimeout على صفر، فلن تتم مراقبة الدفق.
حدود | |
---|---|
opTimeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية لمحاولة عملية واحدة |
idleOutputTimeout | 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) حيث سيتم إعادة توجيه الإخراج القياسي. يمكن أن تكون فارغة. |
stderr | OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه إخراج الخطأ. يمكن أن تكون فارغة. |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة. |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdRetry
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية لكل محاولة |
retryInterval | long : وقت الانتظار بين عمليات إعادة محاولة الأمر |
attempts | int : الحد الأقصى لعدد المحاولات |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdRetryWithOutputMonitor
public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. يراقب أيضًا تدفقات الإخراج للنشاط، ويتم إحباطه إذا لم تتم ملاحظة أي نشاط للتدفق لفترة محددة. إذا تم تعيين idleOutputTimeout على صفر، فلن تتم مراقبة الدفق.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية لكل محاولة |
idleOutputTimeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية للإخراج على تدفقات الإخراج |
retryInterval | long : وقت الانتظار بين عمليات إعادة محاولة الأمر |
attempts | int : الحد الأقصى لعدد المحاولات |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. يشبه runTimedCmd(long, String)
ولكنه لا يسجل أي أخطاء عند الاستثناء.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdSilentlyRetry
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 : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
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) حيث سيتم إعادة توجيه الإخراج القياسي. يمكن أن تكون فارغة. |
stderrFile | File : ERROR(/File) حيث سيتم إعادة توجيه إخراج الخطأ. يمكن أن تكون فارغة. |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
طريقة مساعدة لتنفيذ أمر نظام يتطلب إدخال stdin، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
input | String : إدخال stdin لتمريره إلى العملية |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
طريقة مساعدة لتنفيذ أمر نظام يتطلب إدخال stdin، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
input | String : إدخال stdin لتمريره إلى العملية |
command | ERROR(/List) يحتوي على أمر النظام والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
طريقة مساعدة لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف، وإحباطه إذا استغرق الأمر وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
inputRedirect | File : ERROR(/File) لإعادة التوجيه كمدخل قياسي باستخدام ProcessBuilder.redirectInput() . إذا كان فارغًا، فلن تتم إعادة توجيه stdin. |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده. عندما يتم توفير ERROR(/OutputStream)
بهذه الطريقة، فسيتم تركها مفتوحة في نهاية الوظيفة.
حدود | |
---|---|
timeout | long : المهلة القصوى للانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة. |
idleOutputTimeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية للإخراج على تدفقات الإخراج |
stdout | OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه الإخراج القياسي. يمكن أن تكون فارغة. |
stderr | OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه إخراج الخطأ. يمكن أن تكون فارغة. |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. يراقب أيضًا تدفقات الإخراج للنشاط، ويتم إحباطه إذا لم تتم ملاحظة أي نشاط للتدفق لفترة محددة. إذا تم تعيين idleOutputTimeout على صفر، فلن تتم مراقبة الدفق.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة. |
idleOutputTimeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية للإخراج على تدفقات الإخراج |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
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 إذا اكتملت العملية بنجاح قبل الوصول إلى المحاولات. |
runTimedRetryWithOutputMonitor
public abstract boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
حظر العملية وتنفيذها عدة مرات حتى تنجح. يراقب أيضًا تدفقات الإخراج للنشاط، ويتم إحباطه إذا لم تتم ملاحظة أي نشاط للتدفق لفترة محددة. إذا تم تعيين idleOutputTimeout على صفر، فلن تتم مراقبة الدفق.
حدود | |
---|---|
opTimeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية لمحاولة عملية واحدة |
idleOutputTimeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية للإخراج على تدفقات الإخراج |
pollInterval | long : وقت الانتظار بين عمليات إعادة محاولة الأمر |
attempts | int : الحد الأقصى لعدد المحاولات |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ |
عائدات | |
---|---|
boolean | true إذا اكتملت العملية بنجاح قبل الوصول إلى المحاولات. |
runTimedWithOutputMonitor
public abstract CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
حظر العملية وتنفيذها، وإحباطها إذا استغرقت وقتًا أطول من الوقت المحدد. يراقب أيضًا تدفقات الإخراج للنشاط، ويتم إحباطه إذا لم تتم ملاحظة أي نشاط للتدفق لفترة محددة. إذا تم تعيين idleOutputTimeout على صفر، فلن تتم مراقبة الدفق.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
idleOutputTimeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية للإخراج على تدفقات الإخراج |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ |
logErrors | boolean : تسجيل الأخطاء عند الاستثناء أم لا. |
عائدات | |
---|---|
CommandStatus | نتيجة CommandStatus للعملية. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
يضبط متغير البيئة لاستخدامه عند تشغيل أوامر النظام.
حدود | |
---|---|
key | String : اسم المتغير |
value | String : القيمة المتغيرة |
أنظر أيضا:
setEnvVariablePriority
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-12-04 (حسب التوقيت العالمي المتفَّق عليه)