IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil


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

ملخص

فئات متداخلة

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 : القيمة المتغيرة

أنظر أيضا:

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 : قيمة جديدة لإعادة التوجيه من عدمه

setWorkingDir

public abstract void setWorkingDir (File dir)

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

حدود
dir File : دليل العمل

أنظر أيضا:

ينام

public abstract void sleep (long time)

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

حدود
time long : مللي للنوم. سيتم تجاهل القيم التي تقل عن 0 أو تساويها

unsetEnvvariable

public abstract void unsetEnvVariable (String key)

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

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

أنظر أيضا: