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