تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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(String)` بديلة تقبل وسيطات الأوامر في شكل `ERROR(/List)`.
`Process`	`runCmdInBackground( command)` طريقة `runCmdInBackground(String)` بديلة تقبل وسيطات الأوامر في شكل `ERROR(/List)`.
`Process`	`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)` طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال 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)` طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, 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)` السماح باستخدام مقاطعة "kill" في نظام linux عند التشغيل من خلال طرق #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 جديد لاستخدامه.

الطرق العامة

السماح بالمقاطعة

public void allowInterrupt (boolean allow)

للسماح أو عدم السماح بتشغيل المقاطعات في سلسلة المحادثات الحالية. وفي حال السماح بذلك، يمكن مقاطعة عمليات تنفيذ سلسلة المحادثات الحالية من سلاسل المحادثات الأخرى باستخدام طريقة interrupt(Thread, String).

المعلّمات
`allow`	`boolean`: ما إذا كان سيتم السماح بتشغيل المقاطعات في سلسلة المحادثات الحالية.

الحصول على الإصدار التلقائي

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)

المعلّمات
`message`	`String`: رسالة إلى `RunInterruptedException`

مسموح بالمقاطعة

public boolean isInterruptAllowed ()

أدخِل حالة المقاطعة لـ RunUtil.

الركلات المردودة
`boolean`	true إذا كان من الممكن مقاطعة التشغيل، false في الحالات الأخرى.

RunCmdInفي الخلفية

public Process runCmdInBackground (Redirect redirect, 
                 command)

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

المعلّمات
`redirect`	`Redirect`: السمة `ERROR(/Redirect)` المطلوب تطبيقها على `ProcessBuilder`
`command`	: السمة `ERROR(/List)` التي تحتوي على أمر نظام محدّد ووسيطات اختيارية إلى exec

الركلات المردودة
`Process`	`Process` للأمر الذي تم تنفيذه

RunCmdInفي الخلفية

public Process runCmdInBackground ( command)

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

المعلّمات
`command`	: السمة `ERROR(/List)` التي تحتوي على أمر نظام محدّد ووسيطات اختيارية إلى exec

الركلات المردودة
`Process`	`Process` للأمر الذي تم تنفيذه

RunCmdInفي الخلفية

public Process runCmdInBackground ( command, 
                OutputStream output)

يتم تنفيذ الأمر مع تسجيل ERROR(/OutputStream) لإخراج الأمر. يتم دمج Stdout وstderr معًا.

المعلّمات
`command`	: الأمر المطلوب تشغيله
`output`	`OutputStream`: OutputStream لحفظ الناتج

الركلات المردودة
`Process`	`Process` ينفذ الأمر

RunCmdInفي الخلفية

public Process runCmdInBackground (String... command)

طريقة مساعد لتنفيذ أمر نظام بشكل غير متزامن.

سيعود فورًا بعد تشغيل الأمر.

المعلّمات
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`Process`	`Process` للأمر الذي تم تنفيذه

RunCmdInفي الخلفية

public Process runCmdInBackground (Redirect redirect, 
                String... command)

طريقة مساعد لتنفيذ أمر نظام بشكل غير متزامن.

سيعود فورًا بعد تشغيل الأمر.

المعلّمات
`redirect`	`Redirect`: السمة `ERROR(/Redirect)` المطلوب تطبيقها على `ProcessBuilder`
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`Process`	`Process` للأمر الذي تم تنفيذه

ٍrunEscalatingTimedإعادة المحاولة

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

RunFixedTimed المراد إعادة المحاولة

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

runFixedTimedreWithOutputMonitor

public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح. وتراقب أيضًا مصادر البيانات الناتجة للنشاط، وسيتم إيقافها في حال عدم رصد أي نشاط بث لفترة زمنية معيّنة. وفي حال ضبط مهلة العمل غير النشطة على صفر، لن يتم رصد البث.

المعلّمات
`opTimeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية لمحاولة إجراء عملية واحدة
`idleOutputTimeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية لعرض الناتج في مجموعات بث الإخراج
`pollInterval`	`long`: الوقت الأولي للانتظار بين محاولات العملية
`maxTime`	`long`: إجمالي الوقت التقريبي التقريبي لمواصلة محاولة إجراء العملية
`runnable`	`IRunUtil.IRunnableResult`: يجب تنفيذ `IRunUtil.IRunnableResult`.

الركلات المردودة
`boolean`	`true` في حال اكتمال العملية بنجاح قبل انتهاء صلاحية maxTime

وقت التشغيل

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`: الحد الأقصى لوقت الانتظار بالمللي ثانية: يشير إلى عدم تحديد مهلة.
`stdout`	`OutputStream`: `ERROR(/OutputStream)` حيث ستتم إعادة توجيه إخراج std يمكن أن تكون القيمة فارغة.
`stderr`	`OutputStream`: `ERROR(/OutputStream)` حيث ستتم إعادة توجيه ناتج الخطأ. يمكن أن تكون القيمة فارغة.
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

RunTimedCmd

public CommandResult runTimedCmd (long timeout, 
                String... command)

طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية. ويعني 0 عدم وجود مهلة.
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

runTimedCmd إعادة المحاولة

public CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية لكل محاولة
`retryInterval`	`long`: وقت الانتظار بين إعادة محاولة تنفيذ الأمر
`attempts`	`int`: الحد الأقصى لعدد المحاولات
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

runTimedCmdreWithOutputMonitor

public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                long retryInterval, 
                int attempts, 
                String... command)

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

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية لكل محاولة
`idleOutputTimeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية لعرض الناتج في مجموعات بث الإخراج
`retryInterval`	`long`: وقت الانتظار بين إعادة محاولة تنفيذ الأمر
`attempts`	`int`: الحد الأقصى لعدد المحاولات
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

تشغيلTimedCmdSilently

public CommandResult runTimedCmdSilently (long timeout, 
                String... command)

طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد يشبه هذا الإجراء runTimedCmd(long, String)، ولكنّه لا يسجّل أي أخطاء في الاستثناء.

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

runTimedCmdSilentlyRename

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` يحتوي على نتيجة من الأمر run

RunTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

طريقة مساعد لتنفيذ أمر نظام، ويتم إيقافها إذا استغرق وقتًا أطول من وقت محدد، وإعادة توجيه الناتج إلى الملفات إذا تم تحديدها.

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية: يشير إلى عدم تحديد مهلة.
`input`	`String`: إدخال الإدخال القياسي المطلوب تمريره إلى المعالجة
`stdoutFile`	`File`: `ERROR(/File)` حيث ستتم إعادة توجيه إخراج std يمكن أن تكون القيمة فارغة.
`stderrFile`	`File`: `ERROR(/File)` حيث ستتم إعادة توجيه ناتج الخطأ. يمكن أن تكون القيمة فارغة.
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

RunTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال stdin والإلغاء إذا استغرق ذلك وقتًا أطول من الوقت المحدد.

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية
`input`	`String`: إدخال الإدخال القياسي المطلوب تمريره إلى المعالجة
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

RunTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال stdin والإلغاء إذا استغرق ذلك وقتًا أطول من الوقت المحدد.

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية
`input`	`String`: إدخال الإدخال القياسي المطلوب تمريره إلى المعالجة
`command`	: `ERROR(/List)` يحتوي على أمر النظام والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

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` يحتوي على نتيجة من الأمر run

RunTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية: يشير إلى عدم تحديد مهلة.
`idleOutputTimeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية لعرض الناتج في مجموعات بث الإخراج
`stdout`	`OutputStream`: `ERROR(/OutputStream)` حيث ستتم إعادة توجيه إخراج std يمكن أن تكون القيمة فارغة.
`stderr`	`OutputStream`: `ERROR(/OutputStream)` حيث ستتم إعادة توجيه ناتج الخطأ. يمكن أن تكون القيمة فارغة.
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

RunTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية. ويعني 0 عدم وجود مهلة.
`idleOutputTimeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية لعرض الناتج في مجموعات بث الإخراج
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run

RunTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                ICacheClient cacheClient, 
                String... command)

طريقة مساعِدة لتنفيذ أمر نظام باستخدام التخزين المؤقت

إذا تم تحديد cacheClient، سيتم تفعيل التخزين المؤقت. إذا كانت ذاكرة التخزين المؤقت متاحة، سيتم عرض النتيجة المخزَّنة مؤقتًا. في الحالات الأخرى، سيتم استخدام runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String) لتنفيذ الأمر وسيتم تحميل النتيجة للتخزين المؤقت.

المعلّمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية: يشير إلى عدم تحديد مهلة.
`idleOutputTimeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية لعرض الناتج في مجموعات بث الإخراج.
`stdout`	`OutputStream`: `ERROR(/OutputStream)` حيث ستتم إعادة توجيه إخراج std يمكن أن تكون القيمة فارغة.
`stderr`	`OutputStream`: `ERROR(/OutputStream)` حيث ستتم إعادة توجيه ناتج الخطأ. يمكن أن تكون القيمة فارغة.
`cacheClient`	`ICacheClient`: مثيل لـ `ICacheClient` يُستخدم لمعالجة التخزين المؤقت.
`command`	`String`: أمر النظام المحدّد والوسيطات الاختيارية إلى exec.

الركلات المردودة
`CommandResult`	عنصر `CommandResult` يحتوي على نتيجة من الأمر run.

RunTimedإعادة المحاولة

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` في حال اكتمال العملية بنجاح قبل الوصول إلى المحاولات.

RunTimedRenameWithOutputMonitor

public boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

المعلّمات
`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)

حظر عملية وتنفيذها، ويتم إلغاؤها إذا استغرقت وقتًا أطول من وقت محدد. وتراقب أيضًا مصادر الإخراج للنشاط، ويتم إيقافها في حال عدم رصد أي نشاط للبث لفترة زمنية معيّنة. وفي حال ضبط مهلة العمل غير النشطة على صفر، لن يتم رصد البث.

المعلّمات
`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)

السماح باستخدام مقاطعة "kill" في نظام linux عند التشغيل من خلال طرق #runTimed عند انتهاء المهلة. لا يمكن استخدامها على مثيل IRunUtil التلقائي.

المعلّمات
`interrupt`	`boolean`

setredirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

يمكنك ضبط تدفق الأخطاء العادي لإعادة التوجيه إلى مصدر الإخراج العادي عند تشغيل أوامر النظام. القيمة الأولية false.

المعلّمات
`redirect`	`boolean`: قيمة جديدة لتحديد ما إذا كان ستتم إعادة التوجيه أم لا

setWorkingDir

public void setWorkingDir (File dir)

لضبط دليل العمل لأوامر النظام.

المعلّمات
`dir`	`File`: دليل العمل

النوم

public void sleep (long time)

طريقة مساعِدة للنوم في وقت معين، مع تجاهل أي استثناءات.

المعلّمات
`time`	`long`: ملي ثانية للنوم. سيتم تجاهل القيم التي تقل عن 0 أو تساويه.

إلغاء ضبطEnvVariable

public void unsetEnvVariable (String key)

يؤدي هذا الإجراء إلى إلغاء ضبط متغيّر بيئة، وبالتالي يتم تشغيل أوامر النظام بدون متغيّر البيئة هذا. قد تكتسب متغيرات البيئة من العملية الرئيسية، لذلك نحتاج إلى حذف متغيّر البيئة من ProcessBuilder.environment()

المعلّمات
`key`	`String`: اسم المتغيّر

يُرجى الاطّلاع أيضًا على:

ProcessBuilder.environment()