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()
يجب إنشاء عنصر |
الطرق العامة | |
---|---|
void
|
allowInterrupt(boolean allow)
للسماح أو عدم السماح بتشغيل المقاطعات في سلسلة المحادثات الحالية. |
static
IRunUtil
|
getDefault()
الحصول على مرجع إلى عنصر |
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
تؤدي إلى إيقاف عمليات التشغيل الجارية/التالية على سلسلة المحادثات المحدّدة. |
void
|
interrupt(Thread thread, String message)
تؤدي إلى إيقاف عمليات التشغيل الجارية/التالية على سلسلة المحادثات المحدّدة. |
boolean
|
isInterruptAllowed()
أدخِل حالة المقاطعة لـ RunUtil. |
Process
|
runCmdInBackground(Redirect redirect,
طريقة |
Process
|
runCmdInBackground(
طريقة |
Process
|
runCmdInBackground(
يتم تنفيذ الأمر مع تسجيل |
Process
|
runCmdInBackground(String... command)
طريقة مساعد لتنفيذ أمر نظام بشكل غير متزامن. |
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)
يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح. |
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح. |
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
حظر عملية وتنفيذها، ويتم إلغاؤها إذا استغرقت وقتًا أطول من وقت محدد. |
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
طريقة مساعد لتنفيذ أمر نظام، ويتم إيقافها إذا استغرق وقتًا أطول من وقت محدد، وإعادة توجيه الناتج إلى الملفات إذا تم تحديدها. |
CommandResult
|
runTimedCmd(long timeout, String... command)
طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد |
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد |
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, 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, String... command)
طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال stdin والإلغاء إذا استغرق ذلك وقتًا أطول من الوقت المحدد. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال stdin والإلغاء إذا استغرق ذلك وقتًا أطول من الوقت المحدد. |
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
هي طريقة مساعِدة لتنفيذ أمر نظام يتطلّب إعادة توجيه Stdin من ملف والإلغاء إذا استغرق ذلك وقتًا أطول من الوقت المحدّد. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
طريقة مساعد لتنفيذ أمر نظام، ويتم إيقافها إذا استغرق وقتًا أطول من وقت محدد، وإعادة توجيه الناتج إلى الملفات إذا تم تحديدها. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
طريقة مساعِدة لتنفيذ أمر نظام باستخدام التخزين المؤقت |
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح. |
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
يشير هذا المصطلح إلى حظر العمليات وتنفيذها عدة مرات إلى أن تتم بنجاح. |
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
حظر عملية وتنفيذها، ويتم إلغاؤها إذا استغرقت وقتًا أطول من وقت محدد. |
void
|
setEnvVariable(String name, String value)
تحدِّد هذه السياسة متغيّر بيئة ليتم استخدامه عند تشغيل أوامر النظام. |
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
حدِّد ما إذا كان إلغاء ضبط متغيّر البيئة يكون أولوية أعلى من ضبطه عند إنشاء عملية أم لا. |
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
ضبط السياسة على أنّها قابلة للمقاطعة بعد فترة من الانتظار |
void
|
setLinuxInterruptProcess(boolean interrupt)
السماح باستخدام مقاطعة "kill" في نظام linux عند التشغيل من خلال طرق #runTimed عند انتهاء المهلة. |
void
|
setRedirectStderrToStdout(boolean redirect)
يمكنك ضبط تدفق الأخطاء العادي لإعادة التوجيه إلى مصدر الإخراج العادي عند تشغيل أوامر النظام. |
void
|
setWorkingDir(File dir)
لضبط دليل العمل لأوامر النظام. |
void
|
sleep(long time)
طريقة مساعِدة للنوم في وقت معين، مع تجاهل أي استثناءات. |
void
|
unsetEnvVariable(String key)
يؤدي هذا الإجراء إلى إلغاء ضبط متغيّر بيئة، وبالتالي يتم تشغيل أوامر النظام بدون متغيّر البيئة هذا.
قد تكتسب متغيرات البيئة من العملية الرئيسية، لذلك نحتاج إلى حذف متغيّر البيئة من |
الحقول
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
شركة إنشاءات عامة
الطرق العامة
السماح بالمقاطعة
public void allowInterrupt (boolean allow)
للسماح أو عدم السماح بتشغيل المقاطعات في سلسلة المحادثات الحالية. وفي حال السماح بذلك، يمكن مقاطعة عمليات تنفيذ سلسلة المحادثات الحالية من سلاسل المحادثات الأخرى باستخدام طريقة interrupt(Thread, String)
.
المعلّمات | |
---|---|
allow |
boolean : ما إذا كان سيتم السماح بتشغيل المقاطعات في سلسلة المحادثات الحالية. |
الحصول على الإصدار التلقائي
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 |
مسموح بالمقاطعة
public boolean isInterruptAllowed ()
أدخِل حالة المقاطعة لـ RunUtil.
الركلات المردودة | |
---|---|
boolean |
true إذا كان من الممكن مقاطعة التشغيل، false في الحالات الأخرى. |
RunCmdInفي الخلفية
public Process runCmdInBackground (Redirect redirect,command)
طريقة runCmdInBackground(String)
بديلة تقبل وسيطات الأوامر في شكل ERROR(/List)
.
المعلّمات | |
---|---|
redirect |
Redirect : السمة ERROR(/Redirect) المطلوب تطبيقها على ProcessBuilder |
command |
: السمة ERROR(/List) التي تحتوي على أمر نظام محدّد ووسيطات اختيارية
إلى exec |
الركلات المردودة | |
---|---|
Process |
Process للأمر الذي تم تنفيذه |
RunCmdInفي الخلفية
public Process runCmdInBackground (command)
طريقة runCmdInBackground(String)
بديلة تقبل وسيطات الأوامر في شكل ERROR(/List)
.
المعلّمات | |
---|---|
command |
: السمة ERROR(/List) التي تحتوي على أمر نظام محدّد ووسيطات اختيارية
إلى exec |
الركلات المردودة | |
---|---|
Process |
Process للأمر الذي تم تنفيذه |
RunCmdInفي الخلفية
public Process runCmdInBackground (command, OutputStream output)
يتم تنفيذ الأمر مع تسجيل ERROR(/OutputStream)
لإخراج الأمر.
يتم دمج Stdout وstderr معًا.
المعلّمات | |
---|---|
command |
: الأمر المطلوب تشغيله |
output |
OutputStream : OutputStream لحفظ الناتج |
الركلات المردودة | |
---|---|
Process |
Process ينفذ الأمر |
RunCmdInفي الخلفية
public Process runCmdInBackground (String... command)
طريقة مساعد لتنفيذ أمر نظام بشكل غير متزامن.
سيعود فورًا بعد تشغيل الأمر.
المعلّمات | |
---|---|
command |
String : أمر النظام المحدد والوسيطات الاختيارية إلى exec |
الركلات المردودة | |
---|---|
Process |
Process للأمر الذي تم تنفيذه |
RunCmdInفي الخلفية
public Process runCmdInBackground (Redirect redirect, String... command)
طريقة مساعد لتنفيذ أمر نظام بشكل غير متزامن.
سيعود فورًا بعد تشغيل الأمر.
المعلّمات | |
---|---|
redirect |
Redirect : السمة ERROR(/Redirect) المطلوب تطبيقها على ProcessBuilder |
command |
String : أمر النظام المحدد والوسيطات الاختيارية إلى exec |
الركلات المردودة | |
---|---|
Process |
Process للأمر الذي تم تنفيذه |
ٍrunEscalatingTimedإعادة المحاولة
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 |
RunFixedTimed المراد إعادة المحاولة
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 |
runFixedTimedreWithOutputMonitor
public 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 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, 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 CommandResult runTimedCmd (long timeout, String... command)
طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد
المعلّمات | |
---|---|
timeout |
long : الحد الأقصى لوقت الانتظار بالمللي ثانية. ويعني 0 عدم وجود مهلة. |
command |
String : أمر النظام المحدد والوسيطات الاختيارية إلى exec |
الركلات المردودة | |
---|---|
CommandResult |
عنصر CommandResult يحتوي على نتيجة من الأمر run |
runTimedCmd إعادة المحاولة
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد
المعلّمات | |
---|---|
timeout |
long : الحد الأقصى لوقت الانتظار بالمللي ثانية لكل محاولة |
retryInterval |
long : وقت الانتظار بين إعادة محاولة تنفيذ الأمر |
attempts |
int : الحد الأقصى لعدد المحاولات |
command |
String : أمر النظام المحدد والوسيطات الاختيارية إلى exec |
الركلات المردودة | |
---|---|
CommandResult |
عنصر CommandResult يحتوي على نتيجة من الأمر run |
runTimedCmdreWithOutputMonitor
public 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 CommandResult runTimedCmdSilently (long timeout, String... command)
طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من
وقت محدد يشبه هذا الإجراء runTimedCmd(long, String)
، ولكنّه لا يسجّل أي أخطاء في الاستثناء.
المعلّمات | |
---|---|
timeout |
long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
command |
String : أمر النظام المحدد والوسيطات الاختيارية إلى exec |
الركلات المردودة | |
---|---|
CommandResult |
عنصر CommandResult يحتوي على نتيجة من الأمر run |
runTimedCmdSilentlyRename
public 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 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 CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال stdin والإلغاء إذا استغرق ذلك وقتًا أطول من الوقت المحدد.
المعلّمات | |
---|---|
timeout |
long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
input |
String : إدخال الإدخال القياسي المطلوب تمريره إلى المعالجة |
command |
String : أمر النظام المحدد والوسيطات الاختيارية إلى exec |
الركلات المردودة | |
---|---|
CommandResult |
عنصر CommandResult يحتوي على نتيجة من الأمر run |
RunTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
طريقة مساعد لتنفيذ أمر نظام يتطلب إدخال stdin والإلغاء إذا استغرق ذلك وقتًا أطول من الوقت المحدد.
المعلّمات | |
---|---|
timeout |
long : الحد الأقصى لوقت الانتظار بالمللي ثانية |
input |
String : إدخال الإدخال القياسي المطلوب تمريره إلى المعالجة |
command |
: ERROR(/List) يحتوي على أمر النظام والوسيطات الاختيارية إلى exec |
الركلات المردودة | |
---|---|
CommandResult |
عنصر CommandResult يحتوي على نتيجة من الأمر run |
runTimedCmdWithInputRedirect
public 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 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 CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
طريقة مساعِدة لتنفيذ أمر نظام والإلغاء إذا استغرق الأمر وقتًا أطول من وقت محدد وتراقب أيضًا مصادر مخرجات النتائج للنشاط، ويتم إيقافها في حال عدم رصد أي نشاط للبث لفترة زمنية معيّنة. وفي حال ضبط مهلة العمل غير النشطة على صفر، لن يتم رصد أي بث مباشر.
المعلّمات | |
---|---|
timeout |
long : الحد الأقصى لوقت الانتظار بالمللي ثانية. ويعني 0 عدم وجود مهلة. |
idleOutputTimeout |
long : الحد الأقصى لوقت الانتظار بالمللي ثانية لعرض الناتج في مجموعات بث الإخراج |
command |
String : أمر النظام المحدد والوسيطات الاختيارية إلى exec |
الركلات المردودة | |
---|---|
CommandResult |
عنصر CommandResult يحتوي على نتيجة من الأمر run |
RunTimedCmdWithOutputMonitor
public 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 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 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 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 void setEnvVariable (String name, String value)
تحدِّد هذه السياسة متغيّر بيئة ليتم استخدامه عند تشغيل أوامر النظام.
المعلّمات | |
---|---|
name |
String : اسم المتغيّر |
value |
String : قيمة المتغيّر |
setEnvVariablePriority
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)
السماح باستخدام مقاطعة "kill" في نظام linux عند التشغيل من خلال طرق #runTimed عند
انتهاء المهلة.
لا يمكن استخدامها على مثيل IRunUtil
التلقائي.
المعلّمات | |
---|---|
interrupt |
boolean |
setredirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
يمكنك ضبط تدفق الأخطاء العادي لإعادة التوجيه إلى مصدر الإخراج العادي عند تشغيل أوامر النظام. القيمة الأولية false.
المعلّمات | |
---|---|
redirect |
boolean : قيمة جديدة لتحديد ما إذا كان ستتم إعادة التوجيه أم لا |
setWorkingDir
public void setWorkingDir (File dir)
لضبط دليل العمل لأوامر النظام.
المعلّمات | |
---|---|
dir |
File : دليل العمل |
النوم
public void sleep (long time)
طريقة مساعِدة للنوم في وقت معين، مع تجاهل أي استثناءات.
المعلّمات | |
---|---|
time |
long : ملي ثانية للنوم. سيتم تجاهل القيم التي تقل عن 0 أو تساويه. |
إلغاء ضبطEnvVariable
public void unsetEnvVariable (String key)
يؤدي هذا الإجراء إلى إلغاء ضبط متغيّر بيئة، وبالتالي يتم تشغيل أوامر النظام بدون متغيّر البيئة هذا.
قد تكتسب متغيرات البيئة من العملية الرئيسية، لذلك نحتاج إلى حذف متغيّر البيئة من ProcessBuilder.environment()
المعلّمات | |
---|---|
key |
String : اسم المتغيّر |
يُرجى الاطّلاع أيضًا على: