با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

RunUtil

public class RunUtil
extends Object implements IRunUtil گسترش می دهد

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


مجموعه ای از روش های کمکی برای اجرای عملیات.

خلاصه

زمینه های

public static final String INHERITIO_PREFIX

public static final String RUNNABLE_NOTIFIER_NAME

سازندگان عمومی

RunUtil ()

یک شی RunUtil جدید برای استفاده ایجاد کنید.

روش های عمومی

void allowInterrupt (boolean allow)

اجازه/عدم اجازه وقفه های اجرا در رشته جاری را می دهد.

static IRunUtil getDefault ()

یک مرجع به شی RunUtil پیش فرض دریافت کنید.

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

عملیات اجرا در حال انجام/آینده در رشته داده شده را قطع می کند.

void interrupt (Thread thread, String message)

عملیات اجرا در حال انجام/آینده در رشته داده شده را قطع می کند.

boolean isInterruptAllowed ()

وضعیت وقفه RunUtil را بدهید.

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

یک متد جایگزین runCmdInBackground(String) که آرگومان های فرمان را در ERROR(/List) می پذیرد.

Process runCmdInBackground (String... command)

روش کمکی برای اجرای یک فرمان سیستم به صورت ناهمزمان.

Process runCmdInBackground ( command) runCmdInBackground ( command)

یک متد جایگزین runCmdInBackground(String) که آرگومان های فرمان را در ERROR(/List) می پذیرد.

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

اجرای دستور با یک ERROR(/OutputStream) خروجی فرمان را ثبت کنید.

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

روش کمکی برای اجرای یک فرمان سیستم به صورت ناهمزمان.

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

یک عملیات را چندین بار مسدود و اجرا می کند تا زمانی که موفقیت آمیز باشد.

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

یک عملیات را چندین بار مسدود و اجرا می کند تا زمانی که موفقیت آمیز باشد.

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

یک عملیات را مسدود و اجرا می کند، اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود.

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

روش کمکی برای اجرای یک فرمان سیستم و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود.

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

روش کمکی برای اجرای یک فرمان سیستم، اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود و در صورت مشخص شدن، خروجی را به فایل ها هدایت می کنید.

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

روش کمکی برای اجرای یک فرمان سیستم و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود.

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

روش کمکی برای اجرای یک فرمان سیستم و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود.

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

روش کمکی برای اجرای یک فرمان سیستم و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود.

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

روش کمکی برای اجرای یک فرمان سیستم، اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود و در صورت مشخص شدن، خروجی را به فایل ها هدایت می کنید.

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

روش کمکی برای اجرای یک فرمان سیستمی که به ورودی stdin نیاز دارد و اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود.

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

روش کمکی برای اجرای یک فرمان سیستمی که به ورودی 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)

یک متغیر محیطی را از حالت تنظیم خارج می کند، بنابراین دستورات سیستم بدون این متغیر محیطی اجرا می شوند. متغیرهای محیطی ممکن است از فرآیند والد ارث ببرند، بنابراین باید متغیر محیطی را از ProcessBuilder.environment() حذف کنیم.

زمینه های

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

سازندگان عمومی

RunUtil

public RunUtil ()

یک شی RunUtil جدید برای استفاده ایجاد کنید.

روش های عمومی

اجازه وقفه

public void allowInterrupt (boolean allow)

اجازه/عدم اجازه وقفه های اجرا در رشته جاری را می دهد. اگر مجاز باشد، عملیات اجرای رشته فعلی را می توان از طریق روش interrupt(Thread, String) از رشته های دیگر قطع کرد.

مولفه های
allow boolean : اجازه دادن به وقفه های اجرا در رشته فعلی.

getDefault

public static IRunUtil getDefault ()

یک مرجع به شی RunUtil پیش فرض دریافت کنید.

این برای تماس گیرندگانی که می خواهند از IRunUtil بدون سفارشی سازی استفاده کنند مفید است. توصیه می شود تماس گیرندگانی که نیاز به یک نمونه سفارشی IRunUtil دارند (یعنی باید setEnvVariable(String, String) یا setWorkingDir(File) را فراخوانی کنند.

برمی گرداند
IRunUtil

قطع کردن

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

عملیات اجرا در حال انجام/آینده در رشته داده شده را قطع می کند. عملیات اجرا در رشته داده شده RunInterruptedException را پرتاب می کند.

مولفه های
message String : پیام RunInterruptedException .

errorId ErrorIdentifier : نشان دهنده علت وقفه در صورت شناخته شدن است.

قطع کردن

public void interrupt (Thread thread, 
                String message)

عملیات اجرا در حال انجام/آینده در رشته داده شده را قطع می کند. عملیات اجرا در رشته داده شده RunInterruptedException را پرتاب می کند.

مولفه های
message String : پیام RunInterruptedException .

isinterruptAllowed است

public boolean isInterruptAllowed ()

وضعیت وقفه RunUtil را بدهید.

برمی گرداند
boolean اگر بتوان Run را قطع کرد true، در غیر این صورت 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 (String... command)

روش کمکی برای اجرای یک فرمان سیستم به صورت ناهمزمان.

بلافاصله پس از راه اندازی فرمان باز می گردد.

مولفه های
command String : فرمان سیستم مشخص شده و آرگومان های اختیاری برای اجرا

برمی گرداند
Process Process فرمان اجرا شده

runCmdInBackground

public Process runCmdInBackground ( command)

یک متد جایگزین runCmdInBackground(String) که آرگومان های فرمان را در ERROR(/List) می پذیرد.

مولفه های
command : ERROR(/List) حاوی فرمان مشخص شده سیستم و به صورت اختیاری آرگومان هایی برای اجرا

برمی گرداند
Process Process فرمان اجرا شده

runCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

اجرای دستور با یک ERROR(/OutputStream) خروجی فرمان را ثبت کنید. Stdout و stderr با هم ادغام می شوند.

مولفه های
command : دستور اجرا

output OutputStream : OutputStream برای ذخیره خروجی

برمی گرداند
Process Process اجرای فرمان

runCmdInBackground

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

روش کمکی برای اجرای یک فرمان سیستم به صورت ناهمزمان.

بلافاصله پس از راه اندازی فرمان باز می گردد.

مولفه های
redirect Redirect : ERROR(/Redirect) برای اعمال به ProcessBuilder .

command String : فرمان سیستم مشخص شده و آرگومان های اختیاری برای اجرا

برمی گرداند
Process Process فرمان اجرا شده

runEscalatingTimedRetry

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

یک عملیات را چندین بار مسدود و اجرا می کند تا زمانی که موفقیت آمیز باشد.

زمان انتظار بین تلاش های عملیاتی را به صورت تصاعدی افزایش دهید. این در نظر گرفته شده است که هنگام انجام عملیاتی مانند نظرسنجی از یک سرور استفاده شود تا در صورت قطع موقت آن زمان بازیابی شود.

مولفه های
opTimeout long : حداکثر زمان انتظار بر حسب میلی‌ثانیه برای یک عملیات واحد

initialPollInterval long : زمان اولیه برای انتظار بین تلاش های عملیاتی

maxPollInterval long : حداکثر زمان برای انتظار بین تلاش های عملیاتی

maxTime long : مجموع حداکثر زمان تقریبی برای ادامه تلاش برای عملیات

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult برای اجرا

برمی گرداند
boolean true اگر عملیات قبل از انقضای maxTime با موفقیت انجام شود

runFixedTimedRetry

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

یک عملیات را چندین بار مسدود و اجرا می کند تا زمانی که موفقیت آمیز باشد.

مولفه های
opTimeout long : حداکثر زمان انتظار بر حسب میلی‌ثانیه برای یک عملیات واحد

pollInterval long : زمان اولیه برای انتظار بین تلاش های عملیاتی

maxTime long : مجموع حداکثر زمان تقریبی برای ادامه تلاش برای عملیات

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult برای اجرا

برمی گرداند
boolean true اگر عملیات قبل از انقضای maxTime با موفقیت انجام شود

اجرا شده است

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, 
                String... command)

روش کمکی برای اجرای یک فرمان سیستم و در صورتی که بیشتر از زمان مشخصی طول بکشد، لغو می شود.

مولفه های
timeout long : حداکثر زمان انتظار بر حسب ms. 0 به معنی عدم وجود مهلت است.

command String : فرمان سیستم مشخص شده و آرگومان های اختیاری برای اجرا

برمی گرداند
CommandResult یک CommandResult حاوی نتیجه اجرای دستور

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 حاوی نتیجه اجرای دستور

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, 
                 command)

روش کمکی برای اجرای یک فرمان سیستمی که به ورودی stdin نیاز دارد و اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود.

مولفه های
timeout long : حداکثر زمان انتظار بر حسب ms

input String : ورودی stdin برای ارسال به پردازش

command : ERROR(/List) حاوی فرمان سیستم و به صورت اختیاری آرگومان هایی برای اجرا

برمی گرداند
CommandResult یک CommandResult حاوی نتیجه اجرای دستور

runTimedCmdWithInput

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

روش کمکی برای اجرای یک فرمان سیستمی که به ورودی stdin نیاز دارد و اگر بیشتر از زمان مشخصی طول بکشد، لغو می شود.

مولفه های
timeout long : حداکثر زمان انتظار بر حسب ms

input String : ورودی stdin برای ارسال به پردازش

command String : فرمان سیستم مشخص شده و آرگومان های اختیاری برای اجرا

برمی گرداند
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 : نام متغیر

همچنین ببینید: