RunUtil
public class RunUtil
extends Object
implements IRunUtil
java.lang.Object | |
↳ | com.android.tradefed.util.RunUtil |
مجموعة من الأساليب المساعدة لتنفيذ العمليات.
ملخص
مجالات | |
---|---|
public static final String | INHERITIO_PREFIX |
public static final String | RUNNABLE_NOTIFIER_NAME
|
المقاولين العامة | |
---|---|
RunUtil () قم بإنشاء كائن |
الأساليب العامة | |
---|---|
void | allowInterrupt (boolean allow) يسمح/لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي. |
static IRunUtil | getDefault () احصل على مرجع لكائن |
void | interrupt (Thread thread, String message, ErrorIdentifier errorId) يقاطع عمليات التشغيل الجارية/القادمة على مؤشر الترابط المحدد. |
void | interrupt (Thread thread, String message) يقاطع عمليات التشغيل الجارية/القادمة على مؤشر الترابط المحدد. |
boolean | isInterruptAllowed () إعطاء حالة المقاطعة لـ RunUtil. |
Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) طريقة |
Process | runCmdInBackground ( command) runCmdInBackground ( command) طريقة |
Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) يؤدي تشغيل الأمر باستخدام |
Process | runCmdInBackground (String... command) طريقة مساعدة لتنفيذ أمر النظام بشكل غير متزامن |
Process | runCmdInBackground (Redirect redirect, String... command) طريقة مساعدة لتنفيذ أمر النظام بشكل غير متزامن |
boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) حظر العملية وتنفيذها عدة مرات حتى تنجح. |
boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) حظر العملية وتنفيذها عدة مرات حتى تنجح. |
boolean | runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) حظر العملية وتنفيذها عدة مرات حتى تنجح. |
CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) حظر العملية وتنفيذها، وإحباطها إذا استغرقت وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده. |
CommandResult | runTimedCmd (long timeout, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmdSilently (long timeout, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده. |
CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) طريقة مساعدة لتنفيذ أمر نظام يتطلب إدخال stdin، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) طريقة مساعدة لتنفيذ أمر نظام يتطلب إدخال stdin، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) طريقة مساعدة لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف، وإحباطه إذا استغرق الأمر وقتًا أطول من الوقت المحدد. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديده. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command) طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. |
boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) حظر العملية وتنفيذها عدة مرات حتى تنجح. |
boolean | runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) حظر العملية وتنفيذها عدة مرات حتى تنجح. |
CommandStatus | runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors) حظر العملية وتنفيذها، وإحباطها إذا استغرقت وقتًا أطول من الوقت المحدد. |
void | setEnvVariable (String name, String value) يضبط متغير البيئة لاستخدامه عند تشغيل أوامر النظام. |
void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) قرر ما إذا كان إلغاء تعيين متغير البيئة يمثل أولوية أعلى عند إنشاء عملية أم لا من تعيينها. |
void | setInterruptibleInFuture (Thread thread, long timeMs) قم بتعيينه على أنه قابل للمقاطعة بعد بعض وقت الانتظار. |
void | setLinuxInterruptProcess (boolean interrupt) السماح باستخدام مقاطعة Linux 'kill' في العملية التي يتم تشغيلها من خلال أساليب #runTimed عندما تصل إلى انتهاء المهلة. |
void | setRedirectStderrToStdout (boolean redirect) قم بتعيين دفق الخطأ القياسي لإعادة التوجيه إلى دفق الإخراج القياسي عند تشغيل أوامر النظام. |
void | setWorkingDir (File dir) يضبط دليل العمل لأوامر النظام. |
void | sleep (long time) طريقة مساعدة للنوم لفترة معينة، متجاهلة أية استثناءات. |
void | unsetEnvVariable (String key) يقوم بإلغاء تعيين متغير البيئة، بحيث تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأم، لذا نحتاج إلى حذف متغير البيئة من |
مجالات
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
المقاولين العامة
الأساليب العامة
allowInterrupt
public void allowInterrupt (boolean allow)
يسمح/لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي. إذا كان مسموحًا به، فيمكن مقاطعة عمليات تشغيل الخيط الحالي من سلاسل رسائل أخرى عبر طريقة interrupt(Thread, String)
.
حدود | |
---|---|
allow | boolean : ما إذا كان سيتم السماح بتشغيل المقاطعات على مؤشر الترابط الحالي. |
getDefault
public static IRunUtil getDefault ()
احصل على مرجع لكائن RunUtil
الافتراضي.
يعد هذا مفيدًا للمتصلين الذين يريدون استخدام IRunUtil بدون تخصيص. من المستحسن أن يقوم المتصلون الذين يحتاجون إلى مثيل IRunUtil مخصص (أي بحاجة إلى استدعاء setEnvVariable(String, String)
أو setWorkingDir(File)
بإنشاء نسختهم الخاصة.
عائدات | |
---|---|
IRunUtil |
يقاطع
public void interrupt (Thread thread, String message, ErrorIdentifier errorId)
يقاطع عمليات التشغيل الجارية/القادمة على مؤشر الترابط المحدد. ستؤدي عمليات التشغيل على مؤشر الترابط المحدد إلى طرح RunInterruptedException
.
حدود | |
---|---|
message | String : الرسالة الخاصة بـ RunInterruptedException . |
errorId | ErrorIdentifier : يمثل سبب الانقطاع عند معرفته. |
يقاطع
public void interrupt (Thread thread, String message)
يقاطع عمليات التشغيل الجارية/القادمة على مؤشر الترابط المحدد. ستؤدي عمليات التشغيل على مؤشر الترابط المحدد إلى طرح RunInterruptedException
.
حدود | |
---|---|
message | String : الرسالة الخاصة بـ RunInterruptedException . |
isInterruptAllowed
public boolean isInterruptAllowed ()
إعطاء حالة المقاطعة لـ RunUtil.
عائدات | |
---|---|
boolean | صحيح إذا كان من الممكن مقاطعة التشغيل، وخطأ إذا كان خلاف ذلك. |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect,command)
طريقة runCmdInBackground(String)
بديلة تقبل وسيطات الأمر في نموذج ERROR(/List)
.
حدود | |
---|---|
redirect | Redirect : ERROR(/Redirect) الذي سيتم تطبيقه على ProcessBuilder . |
command | ERROR(/List) الذي يحتوي على أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
runCmdInBackground
public Process runCmdInBackground (command)
طريقة runCmdInBackground(String)
بديلة تقبل وسيطات الأمر في نموذج ERROR(/List)
.
حدود | |
---|---|
command | ERROR(/List) الذي يحتوي على أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
runCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
يؤدي تشغيل الأمر باستخدام ERROR(/OutputStream)
إلى تسجيل إخراج الأمر. يتم دمج Stdout وstderr معًا.
حدود | |
---|---|
command | |
output | OutputStream : OutputStream لحفظ الإخراج |
عائدات | |
---|---|
Process | Process تشغيل الأمر |
runCmdInBackground
public Process runCmdInBackground (String... command)
طريقة مساعدة لتنفيذ أمر النظام بشكل غير متزامن
سيعود مباشرة بعد إطلاق الأمر.
حدود | |
---|---|
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect, String... command)
طريقة مساعدة لتنفيذ أمر النظام بشكل غير متزامن
سيعود مباشرة بعد إطلاق الأمر.
حدود | |
---|---|
redirect | Redirect : ERROR(/Redirect) الذي سيتم تطبيقه على ProcessBuilder . |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
Process | Process تنفيذ الأمر |
runEscalatingTimedRetry
public 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 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 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 CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
حظر العملية وتنفيذها، وإحباطها إذا استغرقت وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ |
logErrors | boolean : تسجيل الأخطاء عند الاستثناء أم لا. |
عائدات | |
---|---|
CommandStatus | نتيجة CommandStatus للعملية. |
runTimedCmd
public 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 CommandResult runTimedCmd (long timeout, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة. |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdRetry
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية لكل محاولة |
retryInterval | long : وقت الانتظار بين عمليات إعادة محاولة الأمر |
attempts | int : الحد الأقصى لعدد المحاولات |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdRetryWithOutputMonitor
public 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 CommandResult runTimedCmdSilently (long timeout, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. يشبه runTimedCmd(long, String)
ولكنه لا يسجل أي أخطاء عند الاستثناء.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdSilentlyRetry
public 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 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 CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
طريقة مساعدة لتنفيذ أمر نظام يتطلب إدخال stdin، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
input | String : إدخال stdin لتمريره إلى العملية |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
طريقة مساعدة لتنفيذ أمر نظام يتطلب إدخال stdin، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
input | String : إدخال stdin لتمريره إلى العملية |
command | ERROR(/List) يحتوي على أمر النظام والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedCmdWithInputRedirect
public 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 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 CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
طريقة مساعدة لتنفيذ أمر النظام، وإحباطه إذا استغرق وقتًا أطول من الوقت المحدد. يراقب أيضًا تدفقات الإخراج للنشاط، ويتم إحباطه إذا لم تتم ملاحظة أي نشاط للتدفق لفترة محددة. إذا تم تعيين idleOutputTimeout على صفر، فلن تتم مراقبة الدفق.
حدود | |
---|---|
timeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة. |
idleOutputTimeout | long : الحد الأقصى لوقت الانتظار بالمللي ثانية للإخراج على تدفقات الإخراج |
command | String : أمر النظام المحدد والوسائط الاختيارية لـ exec |
عائدات | |
---|---|
CommandResult | CommandResult يحتوي على نتيجة من تشغيل الأوامر |
runTimedRetry
public 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 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 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 void setEnvVariable (String name, String value)
يضبط متغير البيئة لاستخدامه عند تشغيل أوامر النظام.
حدود | |
---|---|
name | String : اسم المتغير |
value | String : القيمة المتغيرة |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
قرر ما إذا كان إلغاء تعيين متغير البيئة يمثل أولوية أعلى عند إنشاء عملية أم لا من تعيينها. افتراضيًا، يعد إلغاء الضبط أولوية أعلى: بمعنى أنه إذا تمت محاولة تعيين متغير يحمل نفس الاسم، فلن يحدث ذلك لأنه سيتم إلغاء تعيين المتغير. لا يمكن استخدامه على مثيل IRunUtil
الافتراضي.
حدود | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInFuture
public void setInterruptibleInFuture (Thread thread, long timeMs)
قم بتعيينه على أنه قابل للمقاطعة بعد بعض وقت الانتظار. ERROR(/CommandScheduler#shutdownHard())
لفرض الإنهاء في النهاية.
حدود | |
---|---|
thread | Thread : الخيط الذي سيصبح غير قابل للمقاطعة. |
timeMs | long : وقت الانتظار قبل ضبط الوضع غير القابل للمقاطعة. |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
السماح باستخدام مقاطعة Linux 'kill' في العملية التي يتم تشغيلها من خلال أساليب #runTimed عندما تصل إلى انتهاء المهلة. لا يمكن استخدامه على مثيل IRunUtil
الافتراضي.
حدود | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
قم بتعيين دفق الخطأ القياسي لإعادة التوجيه إلى دفق الإخراج القياسي عند تشغيل أوامر النظام. القيمة الأولية خاطئة.
حدود | |
---|---|
redirect | boolean : قيمة جديدة لتحديد ما إذا كان سيتم إعادة التوجيه أم لا |
setWorkingDir
public void setWorkingDir (File dir)
يضبط دليل العمل لأوامر النظام.
حدود | |
---|---|
dir | File : دليل العمل |
ينام
public void sleep (long time)
طريقة مساعدة للنوم لفترة معينة، متجاهلة أية استثناءات.
حدود | |
---|---|
time | long : مللي للنوم. سيتم تجاهل القيم الأقل من أو تساوي 0 |
unsetEnvVariable
public void unsetEnvVariable (String key)
يقوم بإلغاء تعيين متغير البيئة، بحيث تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأم، لذا نحتاج إلى حذف متغير البيئة من ProcessBuilder.environment()
حدود | |
---|---|
key | String : اسم المتغير |
أنظر أيضا: