RunUtil
public
class
RunUtil
extends Object
implements
IRunUtil
java.lang.Object | |
↳ | com.android.tradefed.util.RunUtil |
Tập hợp các phương thức trợ giúp để thực thi các thao tác.
Tóm tắt
Trường | |
---|---|
public
static
final
String |
INHERITIO_PREFIX
|
public
static
final
String |
RUNNABLE_NOTIFIER_NAME
|
Hàm khởi tạo công khai | |
---|---|
RunUtil()
Tạo một đối tượng |
|
RunUtil(boolean inheritEnvVars)
|
Phương thức công khai | |
---|---|
void
|
allowInterrupt(boolean allow)
Cho phép/không cho phép chạy các gián đoạn trên luồng hiện tại. |
static
IRunUtil
|
getDefault()
Lấy thông tin tham chiếu đến đối tượng |
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Làm gián đoạn các thao tác đang chạy/tiếp theo trên luồng nhất định. |
void
|
interrupt(Thread thread, String message)
Làm gián đoạn các thao tác đang chạy/tiếp theo trên luồng nhất định. |
boolean
|
isInterruptAllowed()
Cung cấp trạng thái gián đoạn của RunUtil. |
static
void
|
linkFile(File destRoot, String relToRoot, File target)
Liên kết |
Process
|
runCmdInBackground(Redirect redirect,
Phương thức |
Process
|
runCmdInBackground(
Phương thức |
Process
|
runCmdInBackground(
Việc chạy lệnh có |
Process
|
runCmdInBackground(String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống một cách không đồng bộ. |
Process
|
runCmdInBackground(Redirect redirect, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống một cách không đồng bộ. |
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công. |
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công. |
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công. |
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Chặn và thực thi một tác vụ, huỷ bỏ nếu mất nhiều thời gian hơn một thời gian đã chỉ định. |
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống, huỷ nếu mất nhiều thời gian hơn một thời gian đã chỉ định, và chuyển hướng đầu ra đến tệp nếu được chỉ định. |
CommandResult
|
runTimedCmd(long timeout, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào. |
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào. |
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào. |
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào. |
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống, huỷ nếu mất nhiều thời gian hơn một thời gian đã chỉ định, và chuyển hướng đầu ra đến tệp nếu được chỉ định. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống yêu cầu nhập stdin và huỷ nếu phương thức đó lâu hơn khoảng thời gian đã chỉ định. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
Phương thức trợ giúp để thực thi lệnh hệ thống yêu cầu nhập stdin và huỷ nếu phương thức đó lâu hơn khoảng thời gian đã chỉ định. |
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống yêu cầu chuyển hướng Stdin từ một tệp, và huỷ nếu mất nhiều thời gian hơn một thời gian đã chỉ định. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống, huỷ nếu mất nhiều thời gian hơn một thời gian đã chỉ định, và chuyển hướng đầu ra đến tệp nếu được chỉ định. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống bằng chức năng lưu vào bộ nhớ đệm. |
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công. |
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công. |
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Chặn và thực thi một tác vụ, huỷ bỏ nếu mất nhiều thời gian hơn một thời gian đã chỉ định. |
void
|
setEnvVariable(String name, String value)
Đặt một biến môi trường sẽ được sử dụng khi chạy các lệnh hệ thống. |
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Quyết định xem khi bạn tạo một quy trình hay không, giá trị huỷ đặt biến môi trường sẽ cao hơn so với đặt chúng. |
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Đặt là có thể gián đoạn sau một thời gian chờ. |
void
|
setLinuxInterruptProcess(boolean interrupt)
Cho phép sử dụng lệnh "kill" trong linux gián đoạn trong quá trình chạy thông qua các phương thức #runTimed khi hết thời gian chờ. |
void
|
setRedirectStderrToStdout(boolean redirect)
Đặt luồng lỗi chuẩn để chuyển hướng đến luồng đầu ra chuẩn khi chạy hệ thống các lệnh. |
void
|
setWorkingDir(File dir)
Thiết lập thư mục đang hoạt động cho các lệnh hệ thống. |
void
|
sleep(long time)
Phương thức trợ giúp để chuyển sang chế độ ngủ trong một khoảng thời gian nhất định, bỏ qua mọi ngoại lệ. |
static
String
|
toRelative(File start, String target)
|
void
|
unsetEnvVariable(String key)
Huỷ thiết lập một biến môi trường để các lệnh hệ thống chạy mà không cần biến môi trường này.
Biến môi trường có thể kế thừa từ quy trình gốc, vì vậy, chúng ta cần xoá
biến môi trường từ |
Trường
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
Hàm khởi tạo công khai
RunUtil
public RunUtil (boolean inheritEnvVars)
Tham số | |
---|---|
inheritEnvVars |
boolean |
Phương thức công khai
cho phép gián đoạn
public void allowInterrupt (boolean allow)
Cho phép/không cho phép chạy các gián đoạn trên luồng hiện tại. Nếu được phép, hãy chạy các hoạt động của
luồng hiện tại có thể bị gián đoạn từ các luồng khác thông qua phương thức interrupt(Thread, String)
.
Tham số | |
---|---|
allow |
boolean : có cho phép chạy các gián đoạn trên luồng hiện tại hay không. |
getDefault
public static IRunUtil getDefault ()
Lấy thông tin tham chiếu đến đối tượng RunUtil
mặc định.
Điều này sẽ hữu ích đối với những phương thức gọi muốn sử dụng IRunUtil mà không cần tuỳ chỉnh.
Những phương thức gọi cần có phiên bản IRunUtil tuỳ chỉnh
(tức là cần gọi setEnvVariable(String, String)
hoặc
setWorkingDir(File)
tạo bản sao của riêng mình.
Giá trị trả về | |
---|---|
IRunUtil |
làm gián đoạn
public void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Làm gián đoạn các thao tác đang chạy/tiếp theo trên luồng nhất định. Thao tác chạy trên
luồng nhất định sẽ gửi RunInterruptedException
.
Tham số | |
---|---|
message |
String : thông báo cho RunInterruptedException . |
errorId |
ErrorIdentifier : Trình bày nguyên nhân gây gián đoạn khi đã biết. |
làm gián đoạn
public void interrupt (Thread thread, String message)
Làm gián đoạn các thao tác đang chạy/tiếp theo trên luồng nhất định. Thao tác chạy trên
luồng nhất định sẽ gửi RunInterruptedException
.
Tham số | |
---|---|
message |
String : thông báo cho RunInterruptedException . |
isInterruptAllowed
public boolean isInterruptAllowed ()
Cung cấp trạng thái gián đoạn của RunUtil.
Giá trị trả về | |
---|---|
boolean |
giá trị true nếu Run (Chạy) có thể bị gián đoạn, nếu không sẽ là false (sai). |
tệp đường liên kết
public static void linkFile (File destRoot, String relToRoot, File target)
Liên kết target
với một địa điểm trong destRoot
.
Nếu tệp đích hoặc đường liên kết tượng trưng đã tồn tại trong destRoot
, thì tệp này
sẽ không được liên kết.
Tham số | |
---|---|
destRoot |
File : Gốc của đích đến. |
relToRoot |
String : Đường dẫn tương đối từ thư mục đích đến thư mục gốc. |
target |
File : Tệp đích cần liên kết. |
Gửi | |
---|---|
|
nếu không liên kết được tệp đích. |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect,command)
Phương thức runCmdInBackground(String)
thay thế chấp nhận các đối số lệnh
trong biểu mẫu ERROR(/List)
.
Tham số | |
---|---|
redirect |
Redirect : ERROR(/Redirect) để áp dụng cho ProcessBuilder . |
command |
: ERROR(/List) chứa lệnh hệ thống được chỉ định và các đối số không bắt buộc
giám đốc điều hành |
Giá trị trả về | |
---|---|
Process |
Process của lệnh được thực thi |
runCmdInBackground
public Process runCmdInBackground (command)
Phương thức runCmdInBackground(String)
thay thế chấp nhận các đối số lệnh
trong biểu mẫu ERROR(/List)
.
Tham số | |
---|---|
command |
: ERROR(/List) chứa lệnh hệ thống được chỉ định và các đối số không bắt buộc
giám đốc điều hành |
Giá trị trả về | |
---|---|
Process |
Process của lệnh được thực thi |
runCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Việc chạy lệnh có ERROR(/OutputStream)
sẽ ghi lại kết quả của lệnh.
Stdout và stderr được hợp nhất với nhau.
Tham số | |
---|---|
command |
: lệnh cần chạy |
output |
OutputStream : OutputStream để lưu đầu ra |
Giá trị trả về | |
---|---|
Process |
Process đang chạy lệnh |
runCmdInBackground
public Process runCmdInBackground (String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống một cách không đồng bộ.
Sẽ quay lại ngay sau khi chạy lệnh.
Tham số | |
---|---|
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
Process |
Process của lệnh được thực thi |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống một cách không đồng bộ.
Sẽ quay lại ngay sau khi chạy lệnh.
Tham số | |
---|---|
redirect |
Redirect : ERROR(/Redirect) để áp dụng cho ProcessBuilder . |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
Process |
Process của lệnh được thực thi |
RunEscalatingTimedThử lại
public boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.
Tăng theo cấp số nhân thời gian chờ giữa các lần thử thao tác. Mục đích sử dụng khi thực hiện một thao tác như thăm dò máy chủ, để máy chủ có thời gian khôi phục trong trường hợp tạm thời không hoạt động.
Tham số | |
---|---|
opTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho một lần thử thao tác |
initialPollInterval |
long : thời gian ban đầu để chờ giữa các lần thử thao tác |
maxPollInterval |
long : thời gian chờ tối đa giữa các lần thử thao tác |
maxTime |
long : tổng thời gian tối đa gần đúng để tiếp tục thử thao tác |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
Giá trị trả về | |
---|---|
boolean |
true nếu thao tác hoàn tất thành công trước khi hết hạn maxTime |
chạyFixedTimedThử lại
public boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.
Tham số | |
---|---|
opTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho một lần thử thao tác |
pollInterval |
long : thời gian ban đầu để chờ giữa các lần thử thao tác |
maxTime |
long : tổng thời gian tối đa gần đúng để tiếp tục thử thao tác |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
Giá trị trả về | |
---|---|
boolean |
true nếu thao tác hoàn tất thành công trước khi hết hạn maxTime |
runFixedTimedThử lạiWithOutputMonitor
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công. Đồng thời giám sát đầu ra của luồng cho hoạt động, huỷ nếu không quan sát thấy hoạt động trong luồng nào trong một thời gian được chỉ định. Nếu bạn đặt thời gian không hoạt động này thành 0, thì tính năng giám sát luồng sẽ không hoạt động.
Tham số | |
---|---|
opTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho một lần thử thao tác |
idleOutputTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho đầu ra trên luồng đầu ra |
pollInterval |
long : thời gian ban đầu để chờ giữa các lần thử thao tác |
maxTime |
long : tổng thời gian tối đa gần đúng để tiếp tục thử thao tác |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
Giá trị trả về | |
---|---|
boolean |
true nếu thao tác hoàn tất thành công trước khi hết hạn maxTime |
thời gian chạy
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Chặn và thực thi một tác vụ, huỷ bỏ nếu mất nhiều thời gian hơn một thời gian đã chỉ định.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
logErrors |
boolean : ghi lỗi về ngoại lệ hay không. |
Giá trị trả về | |
---|---|
CommandStatus |
kết quả CommandStatus của phép toán. |
runTimedCmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống, huỷ nếu mất nhiều thời gian hơn một thời gian đã chỉ định,
và chuyển hướng đầu ra đến tệp nếu được chỉ định. Khi ERROR(/OutputStream)
được cung cấp theo cách này,
chúng sẽ được để mở ở cuối hàm.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây. 0 có nghĩa là không có thời gian chờ. |
stdout |
OutputStream : ERROR(/OutputStream) , nơi đầu ra std sẽ được chuyển hướng. Có thể có giá trị rỗng. |
stderr |
OutputStream : ERROR(/OutputStream) , trong đó đầu ra lỗi sẽ được chuyển hướng. Có thể có giá trị rỗng. |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmd
public CommandResult runTimedCmd (long timeout, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây. 0 có nghĩa là không có thời gian chờ. |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdThử lại
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây cho mỗi lần thử |
retryInterval |
long : thời gian để chờ giữa các lần thử lại lệnh |
attempts |
int : số lần thử tối đa |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdThử lạiVớiĐầu raMonitor
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào. Đồng thời giám sát các luồng đầu ra để phát hiện hoạt động, huỷ nếu không có hoạt động nào trong luồng quan sát được trong một khoảng thời gian xác định. Nếu bạn đặt thời gian rảnhOutputThiết bị là 0, thì hệ thống sẽ không giám sát luồng nội dung sẽ xảy ra.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây cho mỗi lần thử |
idleOutputTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho đầu ra trên luồng đầu ra |
retryInterval |
long : thời gian để chờ giữa các lần thử lại lệnh |
attempts |
int : số lần thử tối đa |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdIâm lặng
public CommandResult runTimedCmdSilently (long timeout, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định
bất cứ lúc nào. Tương tự như runTimedCmd(long, String)
, nhưng không ghi lại bất kỳ lỗi nào trên
ngoại lệ.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdSilentlyThử lại
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định
bất cứ lúc nào. Tương tự như runTimedCmdRetry(long, long, int, String[])
,
nhưng không ghi lại bất kỳ lỗi nào về ngoại lệ.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây |
retryInterval |
long : thời gian để chờ giữa các lần thử lại lệnh |
attempts |
int : số lần thử tối đa |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống, huỷ nếu mất nhiều thời gian hơn một thời gian đã chỉ định, và chuyển hướng đầu ra đến tệp nếu được chỉ định.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây. 0 có nghĩa là không có thời gian chờ. |
input |
String : đầu vào chuẩn để truyền sang xử lý |
stdoutFile |
File : ERROR(/File) , nơi đầu ra std sẽ được chuyển hướng. Có thể có giá trị rỗng. |
stderrFile |
File : ERROR(/File) , trong đó đầu ra lỗi sẽ được chuyển hướng. Có thể có giá trị rỗng. |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống yêu cầu nhập stdin và huỷ nếu phương thức đó lâu hơn khoảng thời gian đã chỉ định.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây |
input |
String : đầu vào chuẩn để truyền sang xử lý |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
Phương thức trợ giúp để thực thi lệnh hệ thống yêu cầu nhập stdin và huỷ nếu phương thức đó lâu hơn khoảng thời gian đã chỉ định.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây |
input |
String : đầu vào chuẩn để truyền sang xử lý |
command |
: ERROR(/List) chứa lệnh hệ thống và các đối số không bắt buộc để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdWithInputTransition
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống yêu cầu chuyển hướng Stdin từ một tệp, và huỷ nếu mất nhiều thời gian hơn một thời gian đã chỉ định.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây |
inputRedirect |
File : ERROR(/File) để chuyển hướng dưới dạng phương thức nhập chuẩn bằng ProcessBuilder.redirectInput() . Nếu là giá trị rỗng, stdin sẽ không được chuyển hướng. |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống, huỷ nếu mất nhiều thời gian hơn một thời gian đã chỉ định,
và chuyển hướng đầu ra đến tệp nếu được chỉ định. Khi ERROR(/OutputStream)
được cung cấp theo cách này,
chúng sẽ được để mở ở cuối hàm.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây. 0 có nghĩa là không có thời gian chờ. |
idleOutputTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho đầu ra trên luồng đầu ra |
stdout |
OutputStream : ERROR(/OutputStream) , nơi đầu ra std sẽ được chuyển hướng. Có thể có giá trị rỗng. |
stderr |
OutputStream : ERROR(/OutputStream) , trong đó đầu ra lỗi sẽ được chuyển hướng. Có thể có giá trị rỗng. |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn thời gian chỉ định bất cứ lúc nào. Đồng thời giám sát các luồng đầu ra để phát hiện hoạt động, huỷ nếu không có hoạt động nào trong luồng quan sát được trong một khoảng thời gian xác định. Nếu bạn đặt thời gian rảnhOutputThiết bị là 0, thì hệ thống sẽ không giám sát luồng nội dung sẽ xảy ra.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây. 0 có nghĩa là không có thời gian chờ. |
idleOutputTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho đầu ra trên luồng đầu ra |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi |
Giá trị trả về | |
---|---|
CommandResult |
một CommandResult chứa kết quả từ lần chạy lệnh |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống bằng chức năng lưu vào bộ nhớ đệm.
Nếu bạn chỉ định cacheClient
, tính năng lưu vào bộ nhớ đệm sẽ được bật. Nếu bộ nhớ đệm là
sẵn có, thì kết quả được lưu trong bộ nhớ đệm sẽ được trả về. Nếu không, runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String)
sẽ được dùng để thực thi lệnh và kết quả sẽ được tải lên để lưu vào bộ nhớ đệm.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây. 0 có nghĩa là không có thời gian chờ. |
idleOutputTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho đầu ra trên luồng đầu ra. |
stdout |
OutputStream : ERROR(/OutputStream) , nơi đầu ra std sẽ được chuyển hướng. Có thể có giá trị rỗng. |
stderr |
OutputStream : ERROR(/OutputStream) , trong đó đầu ra lỗi sẽ được chuyển hướng. Có thể có giá trị rỗng. |
cacheClient |
ICacheClient : một thực thể của ICacheClient dùng để xử lý việc lưu vào bộ nhớ đệm. |
command |
String : lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi. |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lần chạy lệnh. |
Thử lại theo thời gian chạy
public boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.
Tham số | |
---|---|
opTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho một lần thử thao tác |
pollInterval |
long : thời gian để chờ giữa các lần thử lại lệnh |
attempts |
int : số lần thử tối đa |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
Giá trị trả về | |
---|---|
boolean |
true nếu thao tác đã hoàn tất thành công trước khi đạt đến số lần thử. |
runTimedThử lạiVớiOutputMonitor
public boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công. Đồng thời giám sát đầu ra của luồng cho hoạt động, huỷ nếu không quan sát thấy hoạt động trong luồng nào trong một thời gian được chỉ định. Nếu bạn đặt thời gian không hoạt động này thành 0, thì tính năng giám sát luồng sẽ không hoạt động.
Tham số | |
---|---|
opTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho một lần thử thao tác |
idleOutputTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho đầu ra trên luồng đầu ra |
pollInterval |
long : thời gian để chờ giữa các lần thử lại lệnh |
attempts |
int : số lần thử tối đa |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
Giá trị trả về | |
---|---|
boolean |
true nếu thao tác đã hoàn tất thành công trước khi đạt đến số lần thử. |
runTimedVớiOutputMonitor
public CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Chặn và thực thi một tác vụ, huỷ bỏ nếu mất nhiều thời gian hơn một thời gian đã chỉ định. Ngoài ra giám sát hoạt động trong luồng đầu ra, huỷ bỏ nếu không quan sát thấy hoạt động nào trong luồng thời gian cụ thể. Nếu bạn đặt thời gian không hoạt động này thành 0, thì tính năng giám sát luồng sẽ không hoạt động.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây |
idleOutputTimeout |
long : thời gian tối đa để chờ tính bằng mili giây cho đầu ra trên luồng đầu ra |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
logErrors |
boolean : ghi lỗi về ngoại lệ hay không. |
Giá trị trả về | |
---|---|
CommandStatus |
kết quả CommandStatus của phép toán. |
setEnvVariable
public void setEnvVariable (String name, String value)
Đặt một biến môi trường sẽ được sử dụng khi chạy các lệnh hệ thống.
Tham số | |
---|---|
name |
String : tên biến |
value |
String : giá trị biến |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Quyết định xem khi bạn tạo một quy trình hay không, giá trị huỷ đặt biến môi trường sẽ cao hơn
so với đặt chúng.
Theo mặc định, việc huỷ đặt sẽ có mức độ ưu tiên cao hơn: nghĩa là nếu bạn cố gắng đặt một biến bằng
cùng một tên nhưng sẽ không xảy ra vì biến sẽ không được đặt.
Không thể sử dụng trên phiên bản IRunUtil
mặc định.
Tham số | |
---|---|
priority |
IRunUtil.EnvPriority |
setInterruptibleInFuture
public void setInterruptibleInFuture (Thread thread, long timeMs)
Đặt là có thể gián đoạn sau một thời gian chờ.
ERROR(/CommandScheduler#shutdownHard())
để thực thi thì chúng tôi sẽ chấm dứt ngay.
Tham số | |
---|---|
thread |
Thread : luồng sẽ có thể gây gián đoạn. |
timeMs |
long : thời gian để chờ trước khi đặt trạng thái có thể gây gián đoạn. |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
Cho phép sử dụng lệnh "kill" trong linux gián đoạn trong quá trình chạy thông qua các phương thức #runTimed khi
hết thời gian chờ.
Không thể sử dụng trên phiên bản IRunUtil
mặc định.
Tham số | |
---|---|
interrupt |
boolean |
chuyển hướngStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
Đặt luồng lỗi chuẩn để chuyển hướng đến luồng đầu ra chuẩn khi chạy hệ thống các lệnh. Giá trị ban đầu là false.
Tham số | |
---|---|
redirect |
boolean : giá trị mới để xác định xem có chuyển hướng hay không |
phương thức thiết lập
public void setWorkingDir (File dir)
Thiết lập thư mục đang hoạt động cho các lệnh hệ thống.
Tham số | |
---|---|
dir |
File : thư mục đang hoạt động |
ngủ
public void sleep (long time)
Phương thức trợ giúp để chuyển sang chế độ ngủ trong một khoảng thời gian nhất định, bỏ qua mọi ngoại lệ.
Tham số | |
---|---|
time |
long : mili giây để ngủ. các giá trị nhỏ hơn hoặc bằng 0 sẽ bị bỏ qua |
Họ hàng
public static String toRelative (File start, String target)
Tham số | |
---|---|
start |
File |
target |
String |
Giá trị trả về | |
---|---|
String |
biếnEnvBiến
public void unsetEnvVariable (String key)
Huỷ thiết lập một biến môi trường để các lệnh hệ thống chạy mà không cần biến môi trường này.
Biến môi trường có thể kế thừa từ quy trình gốc, vì vậy, chúng ta cần xoá
biến môi trường từ ProcessBuilder.environment()
Tham số | |
---|---|
key |
String : tên biến |
Xem thêm: