IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil


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

ملخص

فئات متداخلة

enum IRunUtil.EnvPriority

التعداد الذي يحدد ما إذا كان وضع أو عدم ضبط بيئة معينة.

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 (String... command)

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

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 (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, String... command)

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

abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, 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, command) runTimedCmdWithInput (long timeout, String input, command)

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

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

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

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

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

عائدات
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 تشغيل الأمر

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, 
                String... command)

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

المعلمات
timeout long : أقصى وقت للانتظار بالمللي ثانية. 0 يعني عدم وجود مهلة.

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

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

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 على نتيجة من تشغيل الأمر

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, 
                 command)

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

المعلمات
timeout long : أقصى وقت للانتظار بالمللي ثانية

input String : إدخال stdin لتمريرها إلى العملية

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

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

runTimedCmdWithInput

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

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

المعلمات
timeout long : أقصى وقت للانتظار بالمللي ثانية

input String : إدخال stdin لتمريرها إلى العملية

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

عائدات
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 : اسم المتغير

أنظر أيضا: