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 ()

قم بإنشاء كائن RunUtil جديد لاستخدامه.

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

void allowInterrupt (boolean allow)

يسمح/لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي.

static IRunUtil getDefault ()

احصل على مرجع لكائن RunUtil الافتراضي.

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)

طريقة runCmdInBackground(String) بديلة تقبل وسيطات الأمر في نموذج ERROR(/List) .

Process runCmdInBackground ( command) runCmdInBackground ( command)

طريقة runCmdInBackground(String) بديلة تقبل وسيطات الأمر في نموذج ERROR(/List) .

Process runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output)

يؤدي تشغيل الأمر باستخدام ERROR(/OutputStream) إلى تسجيل إخراج الأمر.

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)

يقوم بإلغاء تعيين متغير البيئة، بحيث تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأم، لذا نحتاج إلى حذف متغير البيئة من ProcessBuilder.environment()

مجالات

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

المقاولين العامة

RunUtil

public RunUtil ()

قم بإنشاء كائن RunUtil جديد لاستخدامه.

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

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 : اسم المتغير

أنظر أيضا: