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 (Redirect redirect, command) أسلوب runCmdInBackground(String) بديل يقبل وسيطات الأمر في نموذج ERROR(/List) .
abstract Process	runCmdInBackground ( command) runCmdInBackground ( command) أسلوب runCmdInBackground(String) بديل يقبل وسيطات الأمر في نموذج ERROR(/List) .
abstract Process	runCmdInBackground ( command, OutputStream output) 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 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	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) طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
abstract CommandResult	runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) طريقة Helper لتنفيذ أمر نظام يتطلب إدخال stdin ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
abstract CommandResult	runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) طريقة Helper لتنفيذ أمر نظام يتطلب إعادة توجيه Stdin من ملف ، والإحباط إذا استغرق وقتًا أطول من الوقت المحدد.
abstract boolean	runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) منع العملية وتنفيذها عدة مرات حتى تنجح.
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)

يقطع عمليات التشغيل الجارية / القادمة على مؤشر الترابط المحدد. ستؤدي عمليات التشغيل على مؤشر الترابط المحدد إلى طرح RunInterruptedException .

حدود
message	String : الرسالة الخاصة بـ RunInterruptedException .

هو InterruptAllowed

public abstract boolean isInterruptAllowed ()

امنح حالة المقاطعة لـ RunUtil.

عائدات
boolean	صحيح إذا كان من الممكن مقاطعة التشغيل ، أو خطأ إذا كان الأمر كذلك.

runCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                 command)

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

حدود
redirect	Redirect : ERROR(/Redirect) المطلوب تطبيقه على ProcessBuilder .
command	: ERROR(/List) الذي يحتوي على أمر نظام محدد ووسيطات اختياريًا لتنفيذها

عائدات
Process	Process تنفيذ الأمر

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

runCmdInBackground

public abstract Process runCmdInBackground ( command)

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

حدود
command	: ERROR(/List) الذي يحتوي على أمر نظام محدد ووسيطات اختياريًا لتنفيذها

عائدات
Process	Process تنفيذ الأمر

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

runCmdInBackground

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

الأمر الذي يتم تشغيله باستخدام ERROR(/OutputStream) يقوم بتسجيل إخراج الأمر. يتم دمج Stdout و stderr معًا.

حدود
command	: الأمر للتشغيل
output	OutputStream : تيار OutputStream لحفظ الإخراج

عائدات
Process	Process تشغيل الأمر

رميات
	IOException

runCmdInBackground

public abstract Process runCmdInBackground (String... command)

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

سيعود مباشرة بعد إطلاق الأمر.

حدود
command	String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
Process	Process تنفيذ الأمر

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

runCmdInBackground

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

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

سيعود مباشرة بعد إطلاق الأمر.

حدود
redirect	Redirect : ERROR(/Redirect) المطلوب تطبيقه على ProcessBuilder .
command	String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
Process	Process تنفيذ الأمر

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

runEscalatingTimedRetry

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

runFixedTimedRetry

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

runTimed

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 : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedCmd

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

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

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

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedCmdRetry

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

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

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

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedCmd بصمت

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

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

حدود
timeout	long : أقصى وقت للانتظار بالمللي ثانية
command	String : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedCmd بصمت إعادة المحاولة

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 : أمر النظام المحدد والوسيطات التي يجب تنفيذها اختياريًا

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedCmdWithInput

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

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

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

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedCmdWithInput

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

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

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

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedCmdWithInput

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

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

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

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedCmdWithInputRedirect

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

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

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

عائدات
CommandResult	يحتوي CommandResult على نتيجة من تشغيل الأمر

runTimedRetry

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

setEnvVariable

public abstract void setEnvVariable (String key, 
                String value)

يضبط متغير بيئة لاستخدامه عند تشغيل أوامر النظام.

حدود
key	String : اسم المتغير
value	String : القيمة المتغيرة

أنظر أيضا:

• ProcessBuilder.environment()

setEnvVariable الأولوية

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)

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

حدود
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 أو تساويها

unsetEnvvariable

public abstract void unsetEnvVariable (String key)

إلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا.

حدود
key	String : اسم المتغير

أنظر أيضا:

• ProcessBuilder.environment()