RunUtil

public class RunUtil
extends Object implements IRunUtil

java.lang.Object
com.android.tradefed.util.RunUtil


مجموعة من الطرق المساعدة لتنفيذ العمليات.

ملخص

مجالات

public static final String INHERITIO_PREFIX

public static final String RUNNABLE_NOTIFIER_NAME

المنشئون العامة

RunUtil ()

قم بإنشاء كائن RunUtil جديد لاستخدامه.

الأساليب العامة

void allowInterrupt (boolean allow)

يسمح / لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي.

static IRunUtil getDefault ()

احصل على مرجع لكائن RunUtil الافتراضي.

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

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

void interrupt (Thread thread, String message)

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

boolean isInterruptAllowed ()

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

Process runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command)

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

Process runCmdInBackground (String... command)

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

Process runCmdInBackground ( command) runCmdInBackground ( command)

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

Process runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output)

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

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

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

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

منع العملية وتنفيذها عدة مرات حتى تنجح.

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

منع العملية وتنفيذها عدة مرات حتى تنجح.

CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

منع العملية وتنفيذها عدة مرات حتى تنجح.

void setEnvVariable (String name, String value)

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

void setEnvVariablePriority ( IRunUtil.EnvPriority priority)

قرر ما إذا كان عدم ضبط متغير البيئة يمثل أولوية أعلى من تعيينها عند إنشاء عملية أم لا.

void setInterruptibleInFuture (Thread thread, long timeMs)

تعيين كمقاطعة بعد بعض وقت الانتظار.

void setLinuxInterruptProcess (boolean interrupt)

اسمح باستخدام مقاطعة linux 'kill' في العملية التي تعمل من خلال أساليب #runTimed عندما تصل إلى مهلة.

void setRedirectStderrToStdout (boolean redirect)

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

void setWorkingDir (File dir)

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

void sleep (long time)

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

void unsetEnvVariable (String key)

يقوم بإلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأصلية ، لذلك نحتاج إلى حذف متغير البيئة من ProcessBuilder.environment()

مجالات

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

المنشئون العامة

RunUtil

public RunUtil ()

قم بإنشاء كائن RunUtil جديد لاستخدامه.

الأساليب العامة

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

public void allowInterrupt (boolean allow)

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

المعلمات
allow boolean : ما إذا كان سيتم السماح بمقاطعات التشغيل على مؤشر الترابط الحالي.

getDefault

public static IRunUtil getDefault ()

احصل على مرجع لكائن RunUtil الافتراضي.

هذا مفيد للمتصلين الذين يريدون استخدام IRunUtil بدون تخصيص. من المستحسن أن يقوم المتصلون الذين يحتاجون إلى مثيل IRunUtil مخصص (أي يحتاجون إلى استدعاء إما setEnvVariable(String, String) أو setWorkingDir(File) لإنشاء نسختهم الخاصة.

عائدات
IRunUtil

يقطع

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

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

المعلمات
message String : الرسالة الخاصة بـ RunInterruptedException .

errorId ErrorIdentifier : يمثل سبب الانقطاع عند معرفته.

يقطع

public void interrupt (Thread thread, 
                String message)

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

المعلمات
message String : الرسالة الخاصة بـ RunInterruptedException .

هو InterruptAllowed

public boolean isInterruptAllowed ()

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

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

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

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

المعلمات
redirect Redirect : ERROR(/Redirect) المطلوب تطبيقه على ProcessBuilder .

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

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

runCmdInBackground

public Process runCmdInBackground (String... command)

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

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

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

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

runCmdInBackground

public Process runCmdInBackground ( command)

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

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

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

runCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

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

المعلمات
command : الأمر للتشغيل

output OutputStream : تيار OutputStream لحفظ الإخراج

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

runCmdInBackground

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

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

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

المعلمات
redirect Redirect : ERROR(/Redirect) المطلوب تطبيقه على ProcessBuilder .

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

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

runEscalatingTimedRetry

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

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

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

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ

logErrors boolean : سجل أخطاء استثناء أم لا.

عائدات
CommandStatus CommandStatus نتيجة العملية.

runTimedCmd

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

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

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

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

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

runTimedCmd

public 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 CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

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

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

retryInterval long : وقت الانتظار بين محاولات إعادة الأمر

attempts int : أقصى عدد من محاولات المحاولة

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

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

runTimedCmd بصمت

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

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

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

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

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

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

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

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

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

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

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

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

runTimedCmdWithInput

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

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

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

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

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

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

runTimedCmdWithInputRedirect

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

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

المعلمات
name String : اسم المتغير

value String : القيمة المتغيرة

الأولوية setEnvVariable

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

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

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

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

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

المعلمات
thread Thread : الخيط الذي سيصبح قابلاً للمقاطعة.

timeMs long : حان وقت الانتظار قبل ضبط المقاطعة.

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

اسمح باستخدام مقاطعة linux 'kill' في العملية التي تعمل من خلال أساليب #runTimed عندما تصل إلى مهلة. لا يمكن استخدامها على المثيل الافتراضي IRunUtil .

المعلمات
interrupt boolean

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

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

المعلمات
redirect boolean : قيمة جديدة لإعادة التوجيه من عدمه

setWorkingDir

public void setWorkingDir (File dir)

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

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

ينام

public void sleep (long time)

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

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

unsetEnvvariable

public void unsetEnvVariable (String key)

يقوم بإلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأصلية ، لذلك نحتاج إلى حذف متغير البيئة من ProcessBuilder.environment()

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

أنظر أيضا:

و

RunUtil

public class RunUtil
extends Object implements IRunUtil

java.lang.Object
com.android.tradefed.util.RunUtil


مجموعة من الطرق المساعدة لتنفيذ العمليات.

ملخص

مجالات

public static final String INHERITIO_PREFIX

public static final String RUNNABLE_NOTIFIER_NAME

المنشئون العامة

RunUtil ()

قم بإنشاء كائن RunUtil جديد لاستخدامه.

الأساليب العامة

void allowInterrupt (boolean allow)

يسمح / لا يسمح بتشغيل المقاطعات على مؤشر الترابط الحالي.

static IRunUtil getDefault ()

احصل على مرجع لكائن RunUtil الافتراضي.

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

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

void interrupt (Thread thread, String message)

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

boolean isInterruptAllowed ()

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

Process runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command)

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

Process runCmdInBackground (String... command)

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

Process runCmdInBackground ( command) runCmdInBackground ( command)

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

Process runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output)

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

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

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

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

منع العملية وتنفيذها عدة مرات حتى تنجح.

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

منع العملية وتنفيذها عدة مرات حتى تنجح.

CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

منع العملية وتنفيذها عدة مرات حتى تنجح.

void setEnvVariable (String name, String value)

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

void setEnvVariablePriority ( IRunUtil.EnvPriority priority)

قرر ما إذا كان عدم ضبط متغير البيئة يمثل أولوية أعلى من تعيينها عند إنشاء عملية أم لا.

void setInterruptibleInFuture (Thread thread, long timeMs)

تعيين كمقاطعة بعد بعض وقت الانتظار.

void setLinuxInterruptProcess (boolean interrupt)

اسمح باستخدام مقاطعة linux 'kill' في العملية التي تعمل من خلال أساليب #runTimed عندما تصل إلى مهلة.

void setRedirectStderrToStdout (boolean redirect)

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

void setWorkingDir (File dir)

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

void sleep (long time)

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

void unsetEnvVariable (String key)

يقوم بإلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأصلية ، لذلك نحتاج إلى حذف متغير البيئة من ProcessBuilder.environment()

مجالات

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

المنشئون العامة

RunUtil

public RunUtil ()

قم بإنشاء كائن RunUtil جديد لاستخدامه.

الأساليب العامة

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

public void allowInterrupt (boolean allow)

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

المعلمات
allow boolean : ما إذا كان سيتم السماح بمقاطعات التشغيل على مؤشر الترابط الحالي.

getDefault

public static IRunUtil getDefault ()

احصل على مرجع لكائن RunUtil الافتراضي.

هذا مفيد للمتصلين الذين يريدون استخدام IRunUtil بدون تخصيص. من المستحسن أن يقوم المتصلون الذين يحتاجون إلى مثيل IRunUtil مخصص (أي يحتاجون إلى استدعاء إما setEnvVariable(String, String) أو setWorkingDir(File) لإنشاء نسختهم الخاصة.

عائدات
IRunUtil

يقطع

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

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

المعلمات
message String : الرسالة الخاصة بـ RunInterruptedException .

errorId ErrorIdentifier : يمثل سبب الانقطاع عند معرفته.

يقطع

public void interrupt (Thread thread, 
                String message)

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

المعلمات
message String : الرسالة الخاصة بـ RunInterruptedException .

هو InterruptAllowed

public boolean isInterruptAllowed ()

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

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

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

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

المعلمات
redirect Redirect : ERROR(/Redirect) المطلوب تطبيقه على ProcessBuilder .

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

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

runCmdInBackground

public Process runCmdInBackground (String... command)

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

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

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

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

runCmdInBackground

public Process runCmdInBackground ( command)

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

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

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

runCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

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

المعلمات
command : الأمر للتشغيل

output OutputStream : تيار OutputStream لحفظ الإخراج

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

runCmdInBackground

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

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

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

المعلمات
redirect Redirect : ERROR(/Redirect) المطلوب تطبيقه على ProcessBuilder .

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

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

runEscalatingTimedRetry

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

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

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

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult للتنفيذ

logErrors boolean : سجل أخطاء استثناء أم لا.

عائدات
CommandStatus CommandStatus نتيجة العملية.

runTimedCmd

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

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

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

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

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

runTimedCmd

public 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 CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

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

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

retryInterval long : وقت الانتظار بين محاولات إعادة الأمر

attempts int : أقصى عدد من محاولات المحاولة

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

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

runTimedCmd بصمت

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

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

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

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

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

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

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

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

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

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

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

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

runTimedCmdWithInput

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

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

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

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

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

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

runTimedCmdWithInputRedirect

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

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

المعلمات
name String : اسم المتغير

value String : القيمة المتغيرة

الأولوية setEnvVariable

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

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

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

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

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

المعلمات
thread Thread : الخيط الذي سيصبح قابلاً للمقاطعة.

timeMs long : حان وقت الانتظار قبل ضبط المقاطعة.

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

اسمح باستخدام مقاطعة linux 'kill' في العملية التي تعمل من خلال أساليب #runTimed عندما تصل إلى مهلة. لا يمكن استخدامها على المثيل الافتراضي IRunUtil .

المعلمات
interrupt boolean

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

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

المعلمات
redirect boolean : قيمة جديدة لإعادة التوجيه من عدمه

setWorkingDir

public void setWorkingDir (File dir)

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

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

ينام

public void sleep (long time)

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

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

unsetEnvvariable

public void unsetEnvVariable (String key)

يقوم بإلغاء تعيين متغير بيئة ، لذلك تعمل أوامر النظام بدون متغير البيئة هذا. قد ترث متغيرات البيئة من العملية الأصلية ، لذلك نحتاج إلى حذف متغير البيئة من ProcessBuilder.environment()

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

أنظر أيضا: