IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil

الفئات الفرعية المعروفة غير المباشرة RunUtil 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) السماح باستخدام مقاطعة "kill" في نظام linux عند التشغيل من خلال طرق #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)

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

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

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

المعلّمات
timeout	long: الحد الأقصى لوقت الانتظار بالمللي ثانية: يشير إلى عدم تحديد مهلة.
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: الحد الأقصى لوقت الانتظار بالمللي ثانية: يشير إلى عدم تحديد مهلة.
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)

السماح باستخدام مقاطعة "kill" في نظام linux عند التشغيل من خلال طرق #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()