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 |
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. |
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 khoảng thời gian đã chỉ định và chuyển hướng đầu ra đến các tệp nếu được chỉ định. |
CommandResult
|
runTimedCmd(long timeout, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. |
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. |
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. |
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. |
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. |
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 khoảng thời gian đã chỉ định và chuyển hướng đầu ra đến các 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 một lệnh hệ thống yêu cầu nhập stdin và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
Phương thức trợ giúp để thực thi một lệnh hệ thống yêu cầu nhập stdin và huỷ nếu mất nhiều thời gian hơn một 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 khoảng 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 khoảng thời gian đã chỉ định và chuyển hướng đầu ra đến các 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 một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. |
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 tạo một quy trình hay không, việc huỷ thiết lập biến môi trường sẽ có mức độ ưu tiên cao hơn so với việc đặt biến. |
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 giá trị gián đoạn "kill" của linux trên quy 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 các lệnh hệ thống. |
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ệ. |
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 khỏi |
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
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 cho phép, việc 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 cho 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ó một thực thể 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. Các thao tác chạy trên luồng đã cho sẽ gửi RunInterruptedException
.
Tham số | |
---|---|
message |
String : thông báo cho RunInterruptedException . |
errorId |
ErrorIdentifier : Trình bày nguyên nhân 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. Các thao tác chạy trên luồng đã cho 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). |
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 để thực thi |
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 để thực thi |
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. Tính năng này được dùng khi thực hiện một thao tác như thăm dò máy chủ, để có thời gian khôi phục trong trường hợp máy chủ 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 các luồng đầu ra để tìm hoạt động, huỷ nếu không quan sát thấy hoạt động nào trong luồng trong một thời gian đã 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 khoảng thời gian đã chỉ định và chuyển hướng đầu ra đến các 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 một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một 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. 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 một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một 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 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 một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. Đồ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 quan sát thấy hoạt động nào trong luồng trong một thời gian nhất định. Nếu bạn đặt thời gian không hoạt động rảnh (idOutput) thành 0, thì hoạt động giám sát luồng sẽ không diễn 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 một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. Tương tự như runTimedCmd(long, 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 |
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 một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. 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 khoảng thời gian đã chỉ định và chuyển hướng đầu ra đến các 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 một lệnh hệ thống yêu cầu nhập stdin và huỷ nếu mất nhiều thời gian hơn một 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 một lệnh hệ thống yêu cầu nhập stdin và huỷ nếu mất nhiều thời gian hơn một 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 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 |
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 khoảng thời gian đã chỉ định và chuyển hướng đầu ra đến các 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 một lệnh hệ thống và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định. Đồ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 quan sát thấy hoạt động nào trong luồng trong một thời gian nhất định. Nếu bạn đặt thời gian không hoạt động rảnh (idOutput) thành 0, thì hoạt động giám sát luồng sẽ không diễn 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 có bộ nhớ đệm, thì kết quả được lưu vào 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 các luồng đầu ra để tìm hoạt động, huỷ nếu không quan sát thấy hoạt động nào trong luồng trong một thời gian đã 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. Đồ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 quan sát thấy hoạt động nào trong luồng 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ố | |
---|---|
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 tạo một quy trình hay không, việc huỷ thiết lập biến môi trường sẽ có mức độ ưu tiên
cao hơn so với việc đặt biến.
Theo mặc định, việc huỷ đặt có mức độ ưu tiên cao hơn: nghĩa là nếu bạn cố đặt một biến có cùng tên, thì việc đó 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ể bị 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 giá trị gián đoạn "kill" của linux trên quy 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 các lệnh hệ thống. 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 |
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 khỏi ProcessBuilder.environment()
Tham số | |
---|---|
key |
String : tên biến |
Xem thêm: