IRunUtil
public
interface
IRunUtil
com.android.tradefed.util.IRunUtil |
Giao diện để chạy các thao tác được tính giờ và lệnh hệ thống.
Tóm tắt
Lớp lồng ghép | |
---|---|
interface |
IRunUtil.IRunnableResult
Giao diện để thực thi không đồng bộ một thao tác trả về trạng thái boolean. |
Phương thức công khai | |
---|---|
abstract
void
|
allowInterrupt(boolean allow)
Cho phép/không cho phép chạy các ngắt trên luồng hiện tại. |
abstract
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Gián đoạn các thao tác chạy đang diễn ra/sắp diễn ra trên luồng đã cho. |
abstract
void
|
interrupt(Thread thread, String message)
Gián đoạn các thao tác chạy đang diễn ra/sắp diễn ra trên luồng đã cho. |
abstract
boolean
|
isInterruptAllowed()
Cung cấp trạng thái ngắt của RunUtil. |
abstract
Process
|
runCmdInBackground(Redirect redirect,
Một phương thức |
abstract
Process
|
runCmdInBackground(
Một phương thức |
abstract
Process
|
runCmdInBackground(
Chạy lệnh bằng |
abstract
Process
|
runCmdInBackground(String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống không đồng bộ. |
abstract
Process
|
runCmdInBackground(Redirect redirect, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống không đồng bộ. |
abstract
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. |
abstract
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. |
abstract
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. |
abstract
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Chặn và thực thi một thao tác, huỷ nếu thao tác đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định và chuyển hướng đầu ra đến các tệp nếu được chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định và chuyển hướng đầu ra đến các tệp nếu được chỉ định. |
abstract
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 đầu vào stdin và huỷ nếu lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 đầu vào stdin và huỷ nếu lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống yêu cầu chuyển hướng Stdin từ một tệp và huỷ nếu lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định và chuyển hướng đầu ra đến các tệp nếu được chỉ định. |
abstract
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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
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 cách lưu vào bộ nhớ đệm. |
abstract
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. |
abstract
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. |
abstract
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Chặn và thực thi một thao tác, huỷ nếu thao tác đó mất nhiều thời gian hơn thời gian đã chỉ định. |
abstract
void
|
setEnvVariable(String key, String value)
Đặt biến môi trường để sử dụng khi chạy các lệnh hệ thống. |
abstract
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Quyết định xem khi tạo một quy trình, việc huỷ đặt biến môi trường có mức độ ưu tiên cao hơn việc đặt biến môi trường hay không. |
abstract
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Đặt trạng thái là có thể ngắt sau một khoảng thời gian chờ. |
abstract
void
|
setLinuxInterruptProcess(boolean interrupt)
Cho phép sử dụng tính năng 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 quy trình đó đạt đến thời gian chờ. |
abstract
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. |
abstract
void
|
setWorkingDir(File dir)
Đặt thư mục hoạt động cho các lệnh hệ thống. |
abstract
void
|
sleep(long time)
Phương thức trợ giúp để ngủ trong một khoảng thời gian nhất định, bỏ qua mọi trường hợp ngoại lệ. |
abstract
void
|
unsetEnvVariable(String key)
Huỷ đặ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. |
abstract
void
|
uploadCache(ICacheClient cacheClient, ExecutableActionResult actionResult)
Tải |
Phương thức công khai
allowInterrupt
public abstract void allowInterrupt (boolean allow)
Cho phép/không cho phép chạy các ngắt trên luồng hiện tại. Nếu được cho phép, các thao tác chạy 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 : cho phép chạy các ngắt trên luồng hiện tại hay không. |
gián đoạn
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Gián đoạn các thao tác chạy đang diễn ra/sắp diễn ra trên luồng đã cho. 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 : Biểu thị nguyên nhân gây gián đoạn (nếu có). |
gián đoạn
public abstract void interrupt (Thread thread, String message)
Gián đoạn các thao tác chạy đang diễn ra/sắp diễn ra trên luồng đã cho. 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 abstract boolean isInterruptAllowed ()
Cung cấp trạng thái ngắt của RunUtil.
Giá trị trả về | |
---|---|
boolean |
true nếu có thể làm gián đoạn Run (Chạy), false nếu không. |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
Một phương thức runCmdInBackground(String)
thay thế chấp nhận các đối số lệnh ở dạng ERROR(/List)
.
Tham số | |
---|---|
redirect |
Redirect : ERROR(/Redirect) để áp dụng cho ProcessBuilder . |
command |
: ERROR(/List) chứa lệnh hệ thống đã chỉ định và các đối số tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
Process |
Process của lệnh đã thực thi |
Gửi | |
---|---|
|
nếu không chạy được lệnh |
runCmdInBackground
public abstract Process runCmdInBackground (command)
Một phương thức runCmdInBackground(String)
thay thế chấp nhận các đối số lệnh ở dạng ERROR(/List)
.
Tham số | |
---|---|
command |
: ERROR(/List) chứa lệnh hệ thống đã chỉ định và các đối số tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
Process |
Process của lệnh đã thực thi |
Gửi | |
---|---|
|
nếu không chạy được lệnh |
runCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
Chạy lệnh bằng ERROR(/OutputStream)
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 để chạy |
output |
OutputStream : OutputStream để lưu đầu ra |
Giá trị trả về | |
---|---|
Process |
Process đang chạy lệnh |
Gửi | |
---|---|
|
IOException |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống không đồng bộ.
Sẽ trả về ngay sau khi chạy lệnh.
Tham số | |
---|---|
command |
String : lệnh hệ thống được chỉ định và các đối số tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
Process |
Process của lệnh đã thực thi |
Gửi | |
---|---|
|
nếu không chạy được lệnh |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
Phương thức trợ giúp để thực thi lệnh hệ thống không đồng bộ.
Sẽ trả về 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ố tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
Process |
Process của lệnh đã thực thi |
Gửi | |
---|---|
|
nếu không chạy được lệnh |
runEscalatingTimedRetry
public abstract 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 thời gian chờ theo cấp số nhân giữa các lần thử thao tác. Bạn nên sử dụng tính năng này khi thực hiện một thao tác như thăm dò ý kiến máy chủ để cho máy chủ có thời gian khôi phục trong trường hợp máy chủ tạm thời ngừng hoạt động.
Tham số | |
---|---|
opTimeout |
long : thời gian chờ tối đa tính bằng mili giây cho một lần thử thao tác |
initialPollInterval |
long : thời gian chờ ban đầu 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 maxTime hết hạn |
runFixedTimedRetry
public abstract 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 chờ tối đa tính bằng mili giây cho một lần thử thao tác |
pollInterval |
long : thời gian chờ ban đầu 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 maxTime hết hạn |
runFixedTimedRetryWithOutputMonitor
public abstract 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. Ngoài ra, còn theo dõi luồng đầu ra để tìm hoạt động, huỷ nếu không quan sát thấy hoạt động luồng trong một khoảng thời gian cụ thể. Nếu bạn đặt idleOutputTimeout thành 0, thì sẽ không có hoạt động giám sát luồng nào xảy ra.
Tham số | |
---|---|
opTimeout |
long : thời gian chờ tối đa tính bằng mili giây cho một lần thử thao tác |
idleOutputTimeout |
long : thời gian chờ tối đa tính bằng mili giây cho đầu ra trên luồng đầu ra |
pollInterval |
long : thời gian chờ ban đầu 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 maxTime hết hạn |
runTimed
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Chặn và thực thi một thao tác, huỷ nếu thao tác đó mất nhiều thời gian hơn 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 trên ngoại lệ hay không. |
Giá trị trả về | |
---|---|
CommandStatus |
kết quả CommandStatus của phép toán. |
runTimedCmd
public abstract 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 lệnh đó mất nhiều thời gian hơn 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,
các hàm này 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 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ể là giá trị rỗng. |
stderr |
OutputStream : ERROR(/OutputStream) nơi đầu ra lỗi sẽ được chuyển hướng. Có thể là giá trị rỗng. |
command |
String : lệnh hệ thống được chỉ định và các đối số tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmd
public abstract 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 lệnh đó mất nhiều thời gian hơn 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ố tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdRetry
public abstract 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 lệnh đó mất nhiều thời gian hơn 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ố tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdRetryWithOutputMonitor
public abstract 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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. Ngoài ra, còn theo dõi luồng đầu ra để tìm hoạt động, huỷ nếu không có hoạt động luồng nào được quan sát trong một khoảng thời gian cụ thể. Nếu bạn đặt idleOutputTimeout thành 0, thì sẽ không có hoạt động giám sát luồng nào 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 chờ tối đa 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ố tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdSilently
public abstract 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 lệnh đó mất nhiều thời gian hơn 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ố tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdSilentlyRetry
public abstract 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 lệnh đó mất nhiều thời gian hơn 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ề trường hợp 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ố tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdWithInput
public abstract 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 lệnh đó mất nhiều thời gian hơn 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 nghĩa là không có thời gian chờ. |
input |
String : dữ liệu đầu vào stdin để truyền đến quy trình |
stdoutFile |
File : ERROR(/File) nơi đầu ra std sẽ được chuyển hướng. Có thể là giá trị rỗng. |
stderrFile |
File : ERROR(/File) nơi đầu ra lỗi sẽ được chuyển hướng. Có thể là giá trị rỗng. |
command |
String : lệnh hệ thống được chỉ định và các đối số tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdWithInput
public abstract 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 đầu vào stdin và huỷ nếu lệnh đó mất nhiều thời gian hơn 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 : dữ liệu đầu vào stdin để truyền đến quy trình |
command |
String : lệnh hệ thống được chỉ định và các đối số tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdWithInput
public abstract 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 đầu vào stdin và huỷ nếu lệnh đó mất nhiều thời gian hơn 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 : dữ liệu đầu vào stdin để truyền đến quy trình |
command |
: ERROR(/List) chứa lệnh hệ thống và các đối số tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống yêu cầu chuyển hướng Stdin từ một tệp và huỷ nếu lệnh đó mất nhiều thời gian hơn 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 dữ liệu đầu vào chuẩn bằng ProcessBuilder.redirectInput() . Nếu 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ố tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdWithOutputMonitor
public abstract 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 lệnh đó mất nhiều thời gian hơn 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,
các hàm này 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 nghĩa là không có thời gian chờ. |
idleOutputTimeout |
long : thời gian chờ tối đa 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ể là giá trị rỗng. |
stderr |
OutputStream : ERROR(/OutputStream) nơi đầu ra lỗi sẽ được chuyển hướng. Có thể là giá trị rỗng. |
command |
String : lệnh hệ thống được chỉ định và các đối số tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdWithOutputMonitor
public abstract 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 lệnh đó mất nhiều thời gian hơn thời gian đã chỉ định. Ngoài ra, còn theo dõi luồng đầu ra để tìm hoạt động, huỷ nếu không có hoạt động luồng nào được quan sát trong một khoảng thời gian cụ thể. Nếu bạn đặt idleOutputTimeout thành 0, thì sẽ không có hoạt động giám sát luồng nào 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 chờ tối đa 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ố tuỳ chọn để thực thi |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy |
runTimedCmdWithOutputMonitor
public abstract 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 cách lưu vào bộ nhớ đệm.
Nếu bạn chỉ định cacheClient
, thì tính năng lưu vào bộ nhớ đệm sẽ được bật. Nếu bộ nhớ đệm có sẵn, 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 nghĩa là không có thời gian chờ. |
idleOutputTimeout |
long : thời gian chờ tối đa 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ể là giá trị rỗng. |
stderr |
OutputStream : ERROR(/OutputStream) nơi đầu ra lỗi sẽ được chuyển hướng. Có thể là 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 đã chỉ định và các đối số tuỳ chọn để thực thi. |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả từ lệnh chạy. |
runTimedRetry
public abstract 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 chờ tối đa 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ử. |
runTimedRetryWithOutputMonitor
public abstract 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. Ngoài ra, còn theo dõi luồng đầu ra để tìm hoạt động, huỷ nếu không quan sát thấy hoạt động luồng trong một khoảng thời gian cụ thể. Nếu bạn đặt idleOutputTimeout thành 0, thì sẽ không có hoạt động giám sát luồng nào xảy ra.
Tham số | |
---|---|
opTimeout |
long : thời gian chờ tối đa tính bằng mili giây cho một lần thử thao tác |
idleOutputTimeout |
long : thời gian chờ tối đa 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ử. |
runTimedWithOutputMonitor
public abstract CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Chặn và thực thi một thao tác, huỷ nếu thao tác đó mất nhiều thời gian hơn thời gian đã chỉ định. Ngoài ra, trình này còn giám sát luồng đầu ra để tìm hoạt động, huỷ nếu không có hoạt động luồng nào được quan sát trong một khoảng thời gian nhất định. Nếu bạn đặt idleOutputTimeout thành 0, thì sẽ không có hoạt động giám sát luồng nào xảy ra.
Tham số | |
---|---|
timeout |
long : thời gian chờ tối đa tính bằng mili giây |
idleOutputTimeout |
long : thời gian chờ tối đa 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 trên ngoại lệ hay không. |
Giá trị trả về | |
---|---|
CommandStatus |
kết quả CommandStatus của phép toán. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
Đặt biến môi trường để sử dụng khi chạy các lệnh hệ thống.
Tham số | |
---|---|
key |
String : tên biến |
value |
String : giá trị biến |
Xem thêm:
setEnvVariablePriority
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Quyết định xem khi tạo một quy trình, việc huỷ đặt biến môi trường có mức độ ưu tiên cao hơn việc đặt biến môi trường hay không.
Theo mặc định, việc huỷ thiết lập có mức độ ưu tiên cao hơn: nghĩa là nếu bạn cố gắng đặt một biến có cùng tên, thì việc này sẽ không xảy ra vì biến sẽ bị huỷ thiết lập.
Không thể sử dụng trên thực thể IRunUtil
mặc định.
Tham số | |
---|---|
priority |
IRunUtil.EnvPriority |
setInterruptibleInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
Đặt trạng thái là có thể ngắt sau một khoảng thời gian chờ.
ERROR(/CommandScheduler#shutdownHard())
để thực thi việc chấm dứt.
Tham số | |
---|---|
thread |
Thread : luồng sẽ trở thành có thể ngắt. |
timeMs |
long : thời gian chờ trước khi đặt trạng thái có thể ngắt. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Cho phép sử dụng tính năng 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 quy trình đó đạt đến thời gian chờ.
Không thể sử dụng trên thực thể IRunUtil
mặc định.
Tham số | |
---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public abstract 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 cho việc có chuyển hướng hay không |
setWorkingDir
public abstract void setWorkingDir (File dir)
Đặt thư mục hoạt động cho các lệnh hệ thống.
Tham số | |
---|---|
dir |
File : thư mục đang hoạt động |
Xem thêm:
ngủ
public abstract void sleep (long time)
Phương thức trợ giúp để ngủ trong một khoảng thời gian nhất định, bỏ qua mọi trường hợp ngoại lệ.
Tham số | |
---|---|
time |
long : ms để ngủ. các giá trị nhỏ hơn hoặc bằng 0 sẽ bị bỏ qua |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Huỷ đặ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.
Tham số | |
---|---|
key |
String : tên biến |
Xem thêm:
uploadCache
public abstract void uploadCache (ICacheClient cacheClient, ExecutableActionResult actionResult)
Tải ExecutableActionResult
gần đây nhất lên bằng cacheClient.
Tham số | |
---|---|
cacheClient |
ICacheClient : ICacheClient dùng để tải kết quả lên. |
actionResult |
ExecutableActionResult : ExecutableActionResult cần tải lên. |