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

IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil

الفئات الفرعية المعروفة غير المباشرة

RunUtil يشير ذلك المصطلح إلى مجموعة من الطرق المساعدة لتنفيذ العمليات.

واجهة لتشغيل العمليات المحددة بوقت وأوامر النظام.

ملخّص

الصفوف المتداخلة
`interface`	`IRunUtil.IRunnableResult` واجهة لتنفيذ عملية بشكل غير متزامن تعرض حالة منطقية.

الطرق العامة
`abstract void`	`allowInterrupt(boolean allow)` للسماح أو عدم السماح بتشغيل المقاطعات في سلسلة المحادثات الحالية.
`abstract void`	`interrupt(Thread thread, String message, ErrorIdentifier errorId)` تؤدي إلى إيقاف عمليات التشغيل الجارية/التالية على سلسلة المحادثات المحدّدة.
`abstract void`	`interrupt(Thread thread, String message)` تؤدي إلى إيقاف عمليات التشغيل الجارية/التالية على سلسلة المحادثات المحدّدة.
`abstract boolean`	`isInterruptAllowed()` أدخِل حالة المقاطعة لـ RunUtil.
`abstract Process`	`runCmdInBackground(Redirect redirect, command)` طريقة `runCmdInBackground(String)` بديلة تقبل وسيطات الأوامر في شكل `ERROR(/List)`.
`abstract Process`	`runCmdInBackground( command)` طريقة `runCmdInBackground(String)` بديلة تقبل وسيطات الأوامر في شكل `ERROR(/List)`.
`abstract Process`	`runCmdInBackground( command, OutputStream output)` يتم تنفيذ الأمر مع تسجيل `ERROR(/OutputStream)` لإخراج الأمر.
`abstract Process`	`runCmdInBackground(String... command)` طريقة مساعد لتنفيذ أمر نظام بشكل غير متزامن.
`abstract Process`	`runCmdInBackground(Redirect redirect, String... command)` طريقة مساعد لتنفيذ أمر نظام بشكل غير متزامن.
`abstract boolean`	`runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح.
`abstract boolean`	`runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح.
`abstract boolean`	`runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح.
`abstract CommandStatus`	`runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` حظر عملية وتنفيذها، ويتم إلغاؤها إذا استغرقت وقتًا أطول من وقت محدد.
`abstract CommandResult`	`runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)` الطريقة المساعدة لتنفيذ أمر نظام، ويتم إيقافه إذا استغرق وقتًا أطول من وقت محدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديدها.
`abstract CommandResult`	`runTimedCmd(long timeout, String... command)` طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من مهلة محددة الوقت.
`abstract CommandResult`	`runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)` طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من مهلة محددة الوقت.
`abstract CommandResult`	`runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)` طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من مهلة محددة الوقت.
`abstract CommandResult`	`runTimedCmdSilently(long timeout, String... command)` طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من مهلة محددة الوقت.
`abstract CommandResult`	`runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)` طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من مهلة محددة الوقت.
`abstract CommandResult`	`runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)` الطريقة المساعدة لتنفيذ أمر نظام، ويتم إيقافه إذا استغرق وقتًا أطول من وقت محدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديدها.
`abstract CommandResult`	`runTimedCmdWithInput(long timeout, String input, String... command)` طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال stdin والإلغاء إذا كان تستغرق وقتًا أطول من الوقت المحدد.
`abstract CommandResult`	`runTimedCmdWithInput(long timeout, String input, command)` طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال stdin والإلغاء إذا كان تستغرق وقتًا أطول من الوقت المحدد.
`abstract CommandResult`	`runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)` الطريقة المساعدة لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف الإلغاء إذا استغرقت وقتًا أطول من فترة زمنية محددة.
`abstract CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)` الطريقة المساعدة لتنفيذ أمر نظام، ويتم إيقافه إذا استغرق وقتًا أطول من وقت محدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديدها.
`abstract CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)` طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من مهلة محددة الوقت.
`abstract CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)` طريقة مساعِدة لتنفيذ أمر نظام باستخدام التخزين المؤقت
`abstract boolean`	`runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح.
`abstract boolean`	`runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح.
`abstract CommandStatus`	`runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` حظر عملية وتنفيذها، ويتم إلغاؤها إذا استغرقت وقتًا أطول من وقت محدد.
`abstract void`	`setEnvVariable(String key, String value)` تحدِّد هذه السياسة متغيّر بيئة ليتم استخدامه عند تشغيل أوامر النظام.
`abstract void`	`setEnvVariablePriority(IRunUtil.EnvPriority priority)` تحديد ما إذا كان إلغاء ضبط متغيّر البيئة عند إنشاء عملية أعلى أولوية من إعدادها.
`abstract void`	`setInterruptibleInFuture(Thread thread, long timeMs)` ضبط السياسة على أنّها قابلة للمقاطعة بعد فترة من الانتظار
`abstract void`	`setLinuxInterruptProcess(boolean interrupt)` السماح باستخدام Linux 'kill' انقطاع في العملية التي تعمل من خلال طرق #runTimed عند انتهاء المهلة.
`abstract void`	`setRedirectStderrToStdout(boolean redirect)` ضبط تدفق الأخطاء العادي لإعادة التوجيه إلى بث الإخراج العادي عند تشغيل النظام الأوامر.
`abstract void`	`setWorkingDir(File dir)` لضبط دليل العمل لأوامر النظام.
`abstract void`	`sleep(long time)` طريقة مساعِدة للنوم في وقت معين، مع تجاهل أي استثناءات.
`abstract void`	`unsetEnvVariable(String key)` يؤدي هذا الإجراء إلى إلغاء ضبط متغيّر بيئة، وبالتالي يتم تشغيل أوامر النظام بدون متغيّر البيئة هذا.

الطرق العامة

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

public abstract void allowInterrupt (boolean allow)

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

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

يقاطع

public abstract void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

تؤدي إلى إيقاف عمليات التشغيل الجارية/التالية على سلسلة المحادثات المحدّدة. تتم عمليات التشغيل على ستعرض سلسلة التعليمات المحددة RunInterruptedException.

المعلمات
`message`	`String`: رسالة إلى `RunInterruptedException`
`errorId`	`ErrorIdentifier`: لتمثيل سبب انقطاع الخدمة عند معرفته

يقاطع

public abstract void interrupt (Thread thread, 
                String message)

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

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

public abstract boolean isInterruptAllowed ()

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

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

RunCmdInفي الخلفية

public abstract Process runCmdInBackground (Redirect redirect, 
                 command)

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

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

المرتجعات
`Process`	`Process` للأمر الذي تم تنفيذه

الرميات
	إذا فشل تشغيل الأمر

RunCmdInفي الخلفية

public abstract Process runCmdInBackground ( command)

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

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

المرتجعات
`Process`	`Process` للأمر الذي تم تنفيذه

الرميات
	إذا فشل تشغيل الأمر

RunCmdInفي الخلفية

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

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

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

المرتجعات
`Process`	`Process` ينفذ الأمر

الرميات
	IOاستثناء

RunCmdInفي الخلفية

public abstract Process runCmdInBackground (String... command)

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

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

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

المرتجعات
`Process`	`Process` للأمر الذي تم تنفيذه

الرميات
	إذا فشل تشغيل الأمر

RunCmdInفي الخلفية

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

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

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

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

المرتجعات
`Process`	`Process` للأمر الذي تم تنفيذه

الرميات
	إذا فشل تشغيل الأمر

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

public abstract boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح.

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

المعلمات
`opTimeout`	`long`: أقصى وقت للانتظار بالملي ثانية لمحاولة إجراء عملية واحدة
`initialPollInterval`	`long`: الوقت الأولي للانتظار بين محاولات العملية
`maxPollInterval`	`long`: الحد الأقصى لوقت الانتظار بين محاولات التشغيل
`maxTime`	`long`: إجمالي الوقت التقريبي التقريبي لمواصلة محاولة إجراء العملية
`runnable`	`IRunUtil.IRunnableResult`: يجب تنفيذ `IRunUtil.IRunnableResult`.

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

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

public abstract boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح.

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

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

runFixedTimedreWithOutputMonitor

public abstract 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 abstract CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

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

المعلمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية
`runnable`	`IRunUtil.IRunnableResult`: يجب تنفيذ `IRunUtil.IRunnableResult`.
`logErrors`	`boolean`: تسجيل الأخطاء عند الاستثناء أم لا.

المرتجعات
`CommandStatus`	نتيجة العملية `CommandStatus`.

RunTimedCmd

public abstract CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

الطريقة المساعدة لتنفيذ أمر نظام، ويتم إيقافه إذا استغرق وقتًا أطول من وقت محدد، وإعادة توجيه الإخراج إلى الملفات إذا تم تحديدها. عند توفير ERROR(/OutputStream) بهذه الطريقة، سيتم تركها مفتوحة في نهاية الدالة.

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

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

RunTimedCmd

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

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

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

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

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

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

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

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

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

runTimedCmdreWithOutputMonitor

public abstract 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 abstract CommandResult runTimedCmdSilently (long timeout, 
                String... command)

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

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

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

runTimedCmdSilentlyRename

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

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

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

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

RunTimedCmdWithInput

public abstract 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 abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

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

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

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

RunTimedCmdWithInput

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

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

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

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

runTimedCmdWithInputRedirect

public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

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

المعلمات
`timeout`	`long`: الحد الأقصى لوقت الانتظار بالمللي ثانية
`inputRedirect`	`File`: السمة `ERROR(/File)` المطلوب إعادة التوجيه إليها كإدخال عادي باستخدام `ProcessBuilder.redirectInput()`. وإذا كانت القيمة فارغة، لن تتم إعادة توجيه الدالة stdin.
`command`	`String`: أمر النظام المحدد والوسيطات الاختيارية إلى exec

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

RunTimedCmdWithOutputMonitor

public abstract 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 abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

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

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

RunTimedCmdWithOutputMonitor

public abstract 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 abstract boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح.

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

المرتجعات
`boolean`	`true` في حال اكتمال العملية بنجاح قبل الوصول إلى المحاولات.

RunTimedRenameWithOutputMonitor

public abstract 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 abstract 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 abstract void setEnvVariable (String key, 
                String value)

تحدِّد هذه السياسة متغيّر بيئة ليتم استخدامه عند تشغيل أوامر النظام.

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

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

ProcessBuilder.environment()

setEnvVariablePriority

public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)

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

المعلمات
`priority`	`IRunUtil.EnvPriority`

setInterruptibleInFuture

public abstract void setInterruptibleInFuture (Thread thread, 
                long timeMs)

ضبط السياسة على أنّها قابلة للمقاطعة بعد فترة من الانتظار ERROR(/CommandScheduler#shutdownHard()) لفرض إنهاء الاتفاقية في نهاية المطاف.

المعلمات
`thread`	`Thread`: سلسلة المحادثات التي ستصبح غير قابلة للمقاطعة
`timeMs`	`long`: وقت الانتظار قبل ضبط موضع الإعلانات للمقاطعة

setLinuxInterruptProcess

public abstract void setLinuxInterruptProcess (boolean interrupt)

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

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

setredirectStderrToStdout

public abstract void setRedirectStderrToStdout (boolean redirect)

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

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

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

ProcessBuilder.redirectErrorStream(boolean)

setWorkingDir

public abstract void setWorkingDir (File dir)

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

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

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

ProcessBuilder.directory(File)

النوم

public abstract void sleep (long time)

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

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

إلغاء ضبطEnvVariable

public abstract void unsetEnvVariable (String key)

يؤدي هذا الإجراء إلى إلغاء ضبط متغيّر بيئة، وبالتالي يتم تشغيل أوامر النظام بدون متغيّر البيئة هذا.

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

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

ProcessBuilder.environment()

IRunUtil

ملخّص

الصفوف المتداخلة

الطرق العامة

الطرق العامة

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

يقاطع

يقاطع

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

RunCmdInفي الخلفية

RunCmdInفي الخلفية

RunCmdInفي الخلفية

RunCmdInفي الخلفية

RunCmdInفي الخلفية

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

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

runFixedTimedreWithOutputMonitor

وقت التشغيل

RunTimedCmd

RunTimedCmd

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

runTimedCmdreWithOutputMonitor

تشغيلTimedCmdSilently

runTimedCmdSilentlyRename

RunTimedCmdWithInput

RunTimedCmdWithInput

RunTimedCmdWithInput

runTimedCmdWithInputRedirect

RunTimedCmdWithOutputMonitor

RunTimedCmdWithOutputMonitor

RunTimedCmdWithOutputMonitor

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

RunTimedRenameWithOutputMonitor

RunTimedWithOutputMonitor

متغيّر setEnvVariable

setEnvVariablePriority

setInterruptibleInFuture

setLinuxInterruptProcess

setredirectStderrToStdout

setWorkingDir

النوم

إلغاء ضبطEnvVariable