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 (boolean inheritEnvVars) |
روش های عمومی | |
---|---|
void | allowInterrupt (boolean allow) اجازه/عدم اجازه اجرای وقفه در رشته فعلی. |
ProcessBuilder | createProcessBuilder (Redirect redirect, commandList, boolean enableCache) createProcessBuilder (Redirect redirect, commandList, boolean enableCache) |
static IRunUtil | getDefault () یک مرجع به شی |
void | interrupt (Thread thread, String message, ErrorIdentifier errorId) عملیات اجرا در حال انجام/آینده در رشته داده شده را قطع می کند. |
void | interrupt (Thread thread, String message) عملیات اجرا در حال انجام/آینده در رشته داده شده را قطع می کند. |
boolean | isInterruptAllowed () وضعیت وقفه RunUtil را بدهید. |
static File | linkFile (File destRoot, String relToRoot, File target) |
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) یک عملیات را چندین بار مسدود و اجرا می کند تا زمانی که موفقیت آمیز باشد. |
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, command) runTimedCmdWithInput (long timeout, String input, command) روش کمکی برای اجرای یک فرمان سیستمی که به ورودی 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' لینوکس در فرآیندی که از طریق روش های #runTimed اجرا می شود، هنگامی که به زمان پایان رسید. |
void | setRedirectStderrToStdout (boolean redirect) هنگام اجرای دستورات سیستم، جریان خطای استاندارد را طوری تنظیم کنید که به جریان خروجی استاندارد تغییر مسیر دهد. |
void | setWorkingDir (File dir) دایرکتوری کاری را برای دستورات سیستم تنظیم می کند. |
void | sleep (long time) روش کمکی برای خوابیدن برای زمان معین، با نادیده گرفتن هرگونه استثنا. |
static String | toRelative (File start, File target) |
static String | toRelative (File start, String target) |
void | unsetEnvVariable (String key) یک متغیر محیطی را از حالت تنظیم خارج می کند، بنابراین دستورات سیستم بدون این متغیر محیطی اجرا می شوند. متغیرهای محیطی ممکن است از فرآیند والد ارث ببرند، بنابراین باید متغیر محیطی را از |
void | uploadCache ( ICacheClient cacheClient, ExecutableActionResult actionResult) آخرین |
فیلدها
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
سازندگان عمومی
RunUtil
public RunUtil (boolean inheritEnvVars)
پارامترها | |
---|---|
inheritEnvVars | boolean |
روش های عمومی
اجازه وقفه
public void allowInterrupt (boolean allow)
اجازه/عدم اجازه اجرای وقفه در رشته فعلی. اگر مجاز باشد، عملیات اجرای رشته فعلی را می توان از طریق روش interrupt(Thread, String)
از رشته های دیگر قطع کرد.
پارامترها | |
---|---|
allow | boolean : آیا اجازه دادن به وقفه های اجرا در رشته فعلی. |
createProcessBuilder
public ProcessBuilder createProcessBuilder (Redirect redirect,commandList, boolean enableCache)
پارامترها | |
---|---|
redirect | Redirect |
commandList | |
enableCache | boolean |
برمی گرداند | |
---|---|
ProcessBuilder |
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. |
فایل لینک
public static File linkFile (File destRoot, String relToRoot, File target)
target
به مکانی تحت destRoot
پیوند می دهد.
اگر فایل هدف یا پیوند نمادین قبلاً در زیر destRoot
وجود داشته باشد، فایل پیوند داده نخواهد شد.
پارامترها | |
---|---|
destRoot | File : ریشه مقصد. |
relToRoot | String : مسیر نسبی از dir به ریشه مقصد. |
target | File : فایل هدفی که باید پیوند داده شود. |
برمی گرداند | |
---|---|
File | پیوند نمادین |
پرتاب می کند | |
---|---|
| اگر فایل هدف نتواند پیوند داده شود. |
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 با موفقیت انجام شود |
runFixedTimedRetryWithOutputMonitor
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
یک عملیات را چندین بار مسدود و اجرا می کند تا زمانی که موفقیت آمیز باشد. همچنین جریانهای خروجی را برای فعالیت نظارت میکند، اگر هیچ فعالیت جریانی برای مدت زمان مشخصی مشاهده نشد، لغو میشود. اگر idleOutputTimeout روی صفر تنظیم شود، هیچ نظارت جریانی رخ نخواهد داد.
پارامترها | |
---|---|
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 : حداکثر زمان انتظار بر حسب 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 حاوی نتیجه اجرای دستور |
runTimedCmdRetryWithOutputMonitor
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
روش کمکی برای اجرای یک فرمان سیستم و در صورتی که بیشتر از زمان مشخصی طول بکشد لغو می شود. همچنین جریانهای خروجی را برای فعالیت نظارت میکند، اگر هیچ فعالیت جریانی برای مدت زمان مشخصی مشاهده نشد، لغو میشود. اگر idleOutputTimeout روی صفر تنظیم شود، هیچ نظارت جریانی رخ نخواهد داد.
پارامترها | |
---|---|
timeout | long : حداکثر زمان برای انتظار بر حسب میلی ثانیه برای هر تلاش |
idleOutputTimeout | 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 حاوی نتیجه اجرای دستور |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
روش کمکی برای اجرای یک فرمان سیستم، اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود و در صورت مشخص شدن، خروجی را به فایل ها هدایت می کنید. هنگامی که ERROR(/OutputStream)
به این شکل ارائه می شود، در انتهای تابع باز می مانند.
پارامترها | |
---|---|
timeout | long : حداکثر زمان انتظار در ms. 0 به معنای بدون مهلت است. |
idleOutputTimeout | long : حداکثر زمان انتظار بر حسب میلی ثانیه برای خروجی در جریان های خروجی |
stdout | OutputStream : ERROR(/OutputStream) که در آن خروجی std هدایت خواهد شد. می تواند پوچ باشد. |
stderr | OutputStream : ERROR(/OutputStream) که در آن خروجی خطا هدایت می شود. می تواند پوچ باشد. |
command | String : فرمان مشخص شده سیستم و آرگومان های اختیاری برای اجرا |
برمی گرداند | |
---|---|
CommandResult | یک CommandResult حاوی نتیجه اجرای دستور |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
روش کمکی برای اجرای یک فرمان سیستم، و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود. همچنین جریانهای خروجی را برای فعالیت نظارت میکند، اگر هیچ فعالیت جریانی برای مدت زمان مشخصی مشاهده نشد، لغو میشود. اگر idleOutputTimeout روی صفر تنظیم شود، هیچ نظارت جریانی رخ نخواهد داد.
پارامترها | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms. 0 به معنای عدم وجود مهلت است. |
idleOutputTimeout | long : حداکثر زمان انتظار بر حسب میلی ثانیه برای خروجی در جریان های خروجی |
command | String : فرمان مشخص شده سیستم و آرگومان های اختیاری برای اجرا |
برمی گرداند | |
---|---|
CommandResult | یک CommandResult حاوی نتیجه اجرای دستور |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
روش کمکی برای اجرای یک فرمان سیستم با کش.
اگر cacheClient
مشخص شده باشد، cache فعال خواهد شد. اگر کش موجود باشد، نتیجه ذخیره شده برگردانده می شود. در غیر این صورت، runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String)
برای اجرای دستور استفاده می شود و نتیجه برای ذخیره سازی آپلود می شود.
پارامترها | |
---|---|
timeout | long : حداکثر زمان انتظار در ms. 0 به معنای عدم وجود مهلت است. |
idleOutputTimeout | long : حداکثر زمان انتظار بر حسب میلی ثانیه برای خروجی در جریان های خروجی. |
stdout | OutputStream : ERROR(/OutputStream) که در آن خروجی std هدایت خواهد شد. می تواند پوچ باشد. |
stderr | OutputStream : ERROR(/OutputStream) که در آن خروجی خطا هدایت می شود. می تواند پوچ باشد. |
cacheClient | ICacheClient : نمونه ای از ICacheClient که برای مدیریت کش استفاده می شود. |
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 اگر عملیات قبل از رسیدن به تلاش با موفقیت انجام شود. |
runTimedRetryWithOutputMonitor
public boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
یک عملیات را چندین بار مسدود و اجرا می کند تا زمانی که موفقیت آمیز باشد. همچنین جریانهای خروجی را برای فعالیت نظارت میکند، اگر هیچ فعالیت جریانی برای مدت زمان مشخصی مشاهده نشد، لغو میشود. اگر idleOutputTimeout روی صفر تنظیم شود، هیچ نظارت جریانی رخ نخواهد داد.
پارامترها | |
---|---|
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)
یک عملیات را مسدود و اجرا می کند، اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود. همچنین جریانهای خروجی را برای فعالیت نظارت میکند، اگر هیچ فعالیت جریانی برای مدت زمان مشخصی مشاهده نشد، لغو میشود. اگر idleOutputTimeout روی صفر تنظیم شود، هیچ نظارت جریانی رخ نخواهد داد.
پارامترها | |
---|---|
timeout | long : حداکثر زمان انتظار بر حسب ms |
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)
تصمیم بگیرید که آیا هنگام ایجاد یک فرآیند، عدم تنظیم متغیرهای محیطی اولویت بیشتری نسبت به تنظیم آنها دارد یا خیر. به طور پیش فرض، 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 نادیده گرفته می شوند |
نسبت به
public static String toRelative (File start, File target)
پارامترها | |
---|---|
start | File |
target | File |
برمی گرداند | |
---|---|
String |
نسبت به
public static String toRelative (File start, String target)
پارامترها | |
---|---|
start | File |
target | String |
برمی گرداند | |
---|---|
String |
unsetEnvVariable
public void unsetEnvVariable (String key)
یک متغیر محیطی را از حالت تنظیم خارج می کند، بنابراین دستورات سیستم بدون این متغیر محیطی اجرا می شوند. متغیرهای محیطی ممکن است از فرآیند والد ارث ببرند، بنابراین باید متغیر محیطی را از ProcessBuilder.environment()
حذف کنیم.
پارامترها | |
---|---|
key | String : نام متغیر |
همچنین ببینید:
آپلود کش
public void uploadCache (ICacheClient cacheClient, ExecutableActionResult actionResult)
آخرین ExecutableActionResult
اجرا شده با cacheClient را آپلود می کند.
پارامترها | |
---|---|
cacheClient | ICacheClient : ICacheClient برای آپلود نتیجه استفاده می شود. |
actionResult | ExecutableActionResult : ExecutableActionResult برای آپلود. |