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, command) runCmdInBackground (Redirect redirect, command) یک روش جایگزین |
Process | runCmdInBackground ( command) runCmdInBackground ( command) یک روش جایگزین |
Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) اجرای دستور با یک |
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) یک عملیات را چندین بار مسدود و اجرا می کند تا زمانی که موفقیت آمیز باشد. |
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 | 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, command) runTimedCmdWithInput (long timeout, String input, command) روش کمکی برای اجرای یک فرمان سیستمی که به ورودی stdin نیاز دارد و اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود. |
CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) روش کمکی برای اجرای یک فرمان سیستمی که نیاز به تغییر مسیر 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) اجازه استفاده از وقفه 'kill' لینوکس در فرآیندی که از طریق روش های #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 : آیا اجازه دادن به وقفه های اجرا در رشته فعلی. |
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 . |
isinterruptAllowed است
public boolean isInterruptAllowed ()
وضعیت وقفه RunUtil را بدهید.
برمی گرداند | |
---|---|
boolean | درست است اگر بتوان Run را قطع کرد، در غیر این صورت false. |
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 (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 (String... command)
روش کمکی برای اجرای یک فرمان سیستم به صورت ناهمزمان.
بلافاصله پس از راه اندازی فرمان باز می گردد.
مولفه های | |
---|---|
command | String : فرمان مشخص شده سیستم و آرگومان های اختیاری برای اجرا |
برمی گرداند | |
---|---|
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 با موفقیت انجام شود |
اجرا شده است
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
یک عملیات را مسدود و اجرا می کند، اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود.
مولفه های | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms |
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 : حداکثر زمان انتظار بر حسب ms. 0 به معنی عدم وجود مهلت است. |
stdout | OutputStream : ERROR(/OutputStream) که در آن خروجی std هدایت خواهد شد. می تواند پوچ باشد. |
stderr | OutputStream : ERROR(/OutputStream) که در آن خروجی خطا هدایت می شود. می تواند پوچ باشد. |
command | String : فرمان مشخص شده سیستم و آرگومان های اختیاری برای اجرا |
برمی گرداند | |
---|---|
CommandResult | یک CommandResult حاوی نتیجه اجرای دستور |
runTimedCmd
public CommandResult runTimedCmd (long timeout, String... command)
روش کمکی برای اجرای یک فرمان سیستم، و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود.
مولفه های | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms. 0 به معنی عدم وجود مهلت است. |
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 حاوی نتیجه اجرای دستور |
runTimedCmdSilently
public CommandResult runTimedCmdSilently (long timeout, String... command)
روش کمکی برای اجرای یک فرمان سیستم، و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود. مشابه runTimedCmd(long, String)
است، اما هیچ خطایی را در استثنا ثبت نمی کند.
مولفه های | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms |
command | String : فرمان مشخص شده سیستم و آرگومان های اختیاری برای اجرا |
برمی گرداند | |
---|---|
CommandResult | یک CommandResult حاوی نتیجه اجرای دستور |
runTimedCmdSilentlyRetry
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
روش کمکی برای اجرای یک فرمان سیستم، و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود. مشابه runTimedCmdRetry(long, long, int, String[])
، اما هیچ خطایی را در مورد استثنا ثبت نمی کند.
مولفه های | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms |
retryInterval | long : زمان انتظار بین تلاش های مجدد دستور |
attempts | int : حداکثر تعداد تلاش برای امتحان |
command | String : فرمان مشخص شده سیستم و آرگومان های اختیاری برای اجرا |
برمی گرداند | |
---|---|
CommandResult | یک CommandResult حاوی نتیجه اجرای دستور |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
روش کمکی برای اجرای یک فرمان سیستم، اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود و در صورت مشخص شدن، خروجی را به فایل ها هدایت می کنید.
مولفه های | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms. 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, String... command)
روش کمکی برای اجرای یک فرمان سیستمی که به ورودی stdin نیاز دارد و اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود.
مولفه های | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms |
input | String : ورودی stdin برای ارسال به پردازش |
command | String : فرمان مشخص شده سیستم و آرگومان های اختیاری برای اجرا |
برمی گرداند | |
---|---|
CommandResult | یک CommandResult حاوی نتیجه اجرای دستور |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
روش کمکی برای اجرای یک فرمان سیستمی که به ورودی stdin نیاز دارد و اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود.
مولفه های | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms |
input | String : ورودی stdin برای ارسال به پردازش |
command | ERROR(/List) حاوی فرمان سیستم و به صورت اختیاری آرگومان هایی برای اجرا |
برمی گرداند | |
---|---|
CommandResult | یک CommandResult حاوی نتیجه اجرای دستور |
runTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
روش کمکی برای اجرای یک فرمان سیستمی که نیاز به تغییر مسیر Stdin از یک فایل دارد و اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود.
مولفه های | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms |
inputRedirect | File : ERROR(/File) برای تغییر مسیر به عنوان ورودی استاندارد با استفاده از ProcessBuilder.redirectInput() . اگر null باشد، 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 : مقدار متغیر |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
تصمیم بگیرید که آیا هنگام ایجاد یک فرآیند، عدم تنظیم متغیرهای محیطی اولویت بیشتری نسبت به تنظیم آنها دارد یا خیر. به طور پیش فرض، unsetting اولویت بالاتری دارد: به این معنی که اگر تلاشی برای تنظیم متغیری با همان نام انجام شود، این اتفاق نمی افتد زیرا متغیر تنظیم نمی شود. نمی توان در نمونه پیش فرض 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' لینوکس در فرآیندی که از طریق روش های #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 : نام متغیر |
همچنین ببینید: