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

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).

abstract Process runCmdInBackground( command, OutputStream output)

Chạy lệnh bằng ERROR(/OutputStream) ghi lại kết quả của lệnh.

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, 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 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 ExecutableActionResult gần đây nhất lên bằng cacheClient.

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

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

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

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.