تمت ترجمة هذه الصفحة بواسطة 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` جديد لاستخدامه.
`RunUtil(boolean inheritEnvVars)`

الطرق العامة
`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.
`static void`	`linkFile(File destRoot, String relToRoot, File target)` يربط `target` بمكان ضمن `destRoot`.
`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)` السماح باستخدام Linux 'kill' انقطاع في العملية التي تعمل من خلال طرق #runTimed عند انتهاء المهلة.
`void`	`setRedirectStderrToStdout(boolean redirect)` ضبط تدفق الأخطاء العادي لإعادة التوجيه إلى بث الإخراج العادي عند تشغيل النظام الأوامر.
`void`	`setWorkingDir(File dir)` لضبط دليل العمل لأوامر النظام.
`void`	`sleep(long time)` طريقة مساعِدة للنوم في وقت معين، مع تجاهل أي استثناءات.
`static String`	`toRelative(File start, String target)`
`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 جديد لاستخدامه.

RunUtil

public RunUtil (boolean inheritEnvVars)

المعلمات
`inheritEnvVars`	`boolean`

الطرق العامة

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

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 في الحالات الأخرى.

ملف الرابط

public static void linkFile (File destRoot, 
                String relToRoot, 
                File target)

يربط target بمكان ضمن destRoot.

إذا كان الملف الهدف أو الرابط الرمزي موجودًا بالفعل ضمن destRoot، فإن الملف .

المعلمات
`destRoot`	`File`: جذر الوجهة
`relToRoot`	`String`: المسار النسبي من الوجهة dir إلى الجذر
`target`	`File`: الملف الهدف المطلوب ربطه

الرميات
	في حال فشل ربط الملف الهدف.

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`: الحد الأقصى لوقت الانتظار بالملي ثانية وتعني القيمة 0 عدم انتهاء المهلة.
`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`: الحد الأقصى لوقت الانتظار بالملي ثانية وتعني القيمة 0 عدم انتهاء المهلة.
`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`: الحد الأقصى لوقت الانتظار بالملي ثانية وتعني القيمة 0 عدم انتهاء المهلة.
`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`: الحد الأقصى لوقت الانتظار بالملي ثانية وتعني القيمة 0 عدم انتهاء المهلة.
`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)

السماح باستخدام Linux 'kill' انقطاع في العملية التي تعمل من خلال طرق #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

إلى قريب

public static String toRelative (File start, 
                String target)

المعلمات
`start`	`File`
`target`	`String`

المرتجعات
`String`

إلغاء ضبطEnvVariable

public void unsetEnvVariable (String key)

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

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

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

ProcessBuilder.environment()