IRunUtil
public interface IRunUtil
com.android.tradefed.util.IRunUtil |
Giao diện chạy các thao tác hẹn giờ và lệnh hệ thống.
Bản tóm tắt
Các lớp lồng nhau | |
---|---|
enum | IRunUtil.EnvPriority Enum xác định việc đặt hay bỏ đặt một env cụ thể. |
interface | IRunUtil.IRunnableResult Một giao diện để thực hiện không đồng bộ một hoạt động trả về trạng thái boolean. |
Phương pháp 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) Làm gián đoạn các hoạt động chạy đang diễn ra / sắp tới trên chuỗi đã cho. |
abstract void | interrupt (Thread thread, String message) Làm gián đoạn các hoạt động chạy đang diễn ra / sắp tới trên chuỗi đã cho. |
abstract boolean | isInterruptAllowed () Đưa ra trạng thái ngắt của RunUtil. |
abstract Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Phương thức |
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 ( command) runCmdInBackground ( command) Phương thức |
abstract Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) Đang chạy lệnh có |
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 hiện một thao tác nhiều lần cho đến khi thành công. |
abstract boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Chặn và thực hiện một thao tác nhiều lần cho đến khi thành công. |
abstract CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Chặn và thực hiện một hoạt động, hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian nhất định. |
abstract CommandResult | runTimedCmd (long timeout, String... command) Phương thức trợ giúp để thực thi một lệnh hệ thống và hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể. |
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, hủy bỏ nếu mất nhiều thời gian hơn một thời gian cụ thể và chuyển hướng đầu ra đến các tệp nếu được chỉ định. |
abstract 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à hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể. |
abstract CommandResult | runTimedCmdSilently (long timeout, String... command) Phương thức trợ giúp để thực thi một lệnh hệ thống và hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể. |
abstract 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à hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể. |
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, hủy bỏ nếu mất nhiều thời gian hơn một thời gian cụ thể và chuyển hướng đầu ra đến các tệp nếu được chỉ định. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, command) 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à hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể. |
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à hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể. |
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à hủy bỏ nếu quá trình này mất nhiều thời gian hơn một thời gian cụ thể. |
abstract boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Chặn và thực hiện một thao tác nhiều lần cho đến khi thành công. |
abstract void | setEnvVariable (String key, 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. |
abstract void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Quyết định xem có hay không khi tạo một quy trình, việc bỏ đặt biến môi trường có mức độ ưu tiên cao hơn so với việc đặt chúng. |
abstract void | setInterruptibleInFuture (Thread thread, long timeMs) Đặt là có thể bị gián đoạn sau một thời gian chờ đợi. |
abstract void | setLinuxInterruptProcess (boolean interrupt) Cho phép sử dụng sự gián đoạn 'tiêu diệt' linux trên tiến trình chạy qua các phương thức #runTimed khi nó đến thời gian chờ. |
abstract void | setRedirectStderrToStdout (boolean redirect) Đặt luồng lỗi tiêu chuẩn để chuyển hướng đến luồng đầu ra tiêu chuẩn khi chạy các lệnh hệ thống. |
abstract void | setWorkingDir (File dir) Đặt thư mục làm việc cho các lệnh hệ thống. |
abstract void | sleep (long time) Phương pháp trợ giúp để ngủ trong thời gian nhất định, bỏ qua bất kỳ trường hợp ngoại lệ nào. |
abstract void | unsetEnvVariable (String key) Hủy đặt một biến môi trường, do đó, các lệnh hệ thống chạy mà không có biến môi trường này. |
Phương pháp 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 nó được cho phép, các hoạt động chạy của luồng hiện tại có thể bị ngắt khỏi các luồng khác thông qua phương thức interrupt(Thread, String)
.
Thông số | |
---|---|
allow | boolean : có cho phép chạy ngắt trên luồng hiện tại hay không. |
ngắt
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Làm gián đoạn các hoạt động chạy đang diễn ra / sắp tới trên chuỗi đã cho. Các hoạt động chạy trên luồng đã cho sẽ ném RunInterruptedException
.
Thông số | |
---|---|
message | String : thông báo cho RunInterruptedException . |
errorId | ErrorIdentifier : Đại diện cho nguyên nhân của sự gián đoạn khi đã biết. |
ngắt
public abstract void interrupt (Thread thread, String message)
Làm gián đoạn các hoạt động chạy đang diễn ra / sắp tới trên chuỗi đã cho. Các hoạt động chạy trên luồng đã cho sẽ ném RunInterruptedException
.
Thông số | |
---|---|
message | String : thông báo cho RunInterruptedException . |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
Đưa ra trạng thái ngắt của RunUtil.
Lợi nhuận | |
---|---|
boolean | true nếu Run có thể bị gián đoạn, false nếu ngược lại. |
runCmdInBackground
public abstract 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)
.
Thông 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ố tùy chọn để thực thi |
Lợi nhuận | |
---|---|
Process | Process của lệnh được thực thi |
Ném | |
---|---|
| nếu lệnh không chạy được |
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ẽ quay lại ngay sau khi khởi chạy lệnh.
Thông số | |
---|---|
command | String : lệnh hệ thống được chỉ định và các đối số tùy chọn để thực thi |
Lợi nhuận | |
---|---|
Process | Process của lệnh được thực thi |
Ném | |
---|---|
| nếu lệnh không chạy được |
runCmdInBackground
public abstract 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)
.
Thông số | |
---|---|
command | ERROR(/List) chứa lệnh hệ thống được chỉ định và các đối số tùy chọn để thực thi |
Lợi nhuận | |
---|---|
Process | Process của lệnh được thực thi |
Ném | |
---|---|
| nếu lệnh không chạy được |
runCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
Đang chạy lệnh có ERROR(/OutputStream)
ghi lại kết quả đầu ra của lệnh. Stdout và stderr được hợp nhất với nhau.
Thông số | |
---|---|
command | |
output | OutputStream : Dòng đầu ra để lưu đầu ra |
Lợi nhuận | |
---|---|
Process | Process chạy 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ẽ quay lại ngay sau khi khởi chạy lệnh.
Thông 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ố tùy chọn để thực thi |
Lợi nhuận | |
---|---|
Process | Process của lệnh được thực thi |
Ném | |
---|---|
| nếu lệnh không chạy được |
runEscalatingTimedRetry
public abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Chặn và thực hiện một thao tác nhiều lần cho đến khi thành công.
Tăng thời gian chờ giữa các lần thao tác theo cấp số nhân. Điều này nhằm mục đích được sử dụng khi thực hiện một thao tác như thăm dò máy chủ, để cho máy chủ thời gian khôi phục trong trường hợp máy chủ tạm thời ngừng hoạt động.Thông số | |
---|---|
opTimeout | long : thời gian chờ tối đa tính bằng mili giây cho một lần thao tác |
initialPollInterval | long : thời gian ban đầu để đợi giữa các lần thử thao tác |
maxPollInterval | long : thời gian tối đa để 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ử hoạt động |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
Lợi nhuận | |
---|---|
boolean | true nếu hoạt động 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 hiện một thao tác nhiều lần cho đến khi thành công.
Thông số | |
---|---|
opTimeout | long : thời gian chờ tối đa tính bằng mili giây cho một lần thao tác |
pollInterval | long : thời gian ban đầu để đợi 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ử hoạt động |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult để thực thi |
Lợi nhuận | |
---|---|
boolean | true nếu hoạt động 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 hiện một hoạt động, hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian nhất định.
Thông 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ệ hoặc không. |
Lợi nhuận | |
---|---|
CommandStatus | kết quả hoạt động của CommandStatus . |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống và hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể.
Thông số | |
---|---|
timeout | long : thời gian chờ tối đa tính bằng ms. 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ố tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
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, hủy bỏ nếu mất nhiều thời gian hơn một thời gian cụ thể 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ẽ bị bỏ ngỏ ở cuối hàm.
Thông số | |
---|---|
timeout | long : thời gian chờ tối đa để chờ 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ể là null. |
stderr | OutputStream : ERROR(/OutputStream) nơi đầu ra lỗi sẽ được chuyển hướng. Có thể là null. |
command | String : lệnh hệ thống được chỉ định và các đối số tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
runTimedCmdRetry
public abstract 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à hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể.
Thông 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ố tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Phương thức trợ giúp để thực thi một lệnh hệ thống và hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể. Tương tự như runTimedCmd(long, String)
, nhưng không ghi bất kỳ lỗi nào về ngoại lệ.
Thông 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ố tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
runTimedCmdSilentlyRetry
public abstract 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à hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể. Tương tự như runTimedCmdRetry(long, long, int, String[])
, nhưng không ghi lại bất kỳ lỗi nào trên ngoại lệ.
Thông 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ố tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
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, hủy bỏ nếu mất nhiều thời gian hơn một thời gian cụ thể và chuyển hướng đầu ra đến các tệp nếu được chỉ định.
Thông số | |
---|---|
timeout | long : thời gian chờ tối đa để chờ tính bằng mili giây. 0 có nghĩa là không có thời gian chờ. |
input | String : đầu vào stdin cần chuyển để xử lý |
stdoutFile | File : ERROR(/File) nơi đầu ra std sẽ được chuyển hướng. Có thể là null. |
stderrFile | File : ERROR(/File) nơi đầu ra lỗi sẽ được chuyển hướng. Có thể là null. |
command | String : lệnh hệ thống được chỉ định và các đối số tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
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à hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể.
Thông số | |
---|---|
timeout | long : thời gian chờ tối đa tính bằng mili giây |
input | String : đầu vào stdin cần chuyển để xử lý |
command | ERROR(/List) chứa lệnh hệ thống và các đối số tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
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à hủy bỏ nếu nó mất nhiều thời gian hơn một thời gian cụ thể.
Thông số | |
---|---|
timeout | long : thời gian chờ tối đa tính bằng mili giây |
input | String : đầu vào stdin cần chuyển để xử lý |
command | String : lệnh hệ thống được chỉ định và các đối số tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
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à hủy bỏ nếu quá trình này mất nhiều thời gian hơn một thời gian cụ thể.
Thông 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 làm đầu vào tiêu chuẩn bằng ProcessBuilder.redirectInput() . Nếu null, stdin sẽ không được chuyển hướng. |
command | String : lệnh hệ thống được chỉ định và các đối số tùy chọn để thực thi |
Lợi nhuận | |
---|---|
CommandResult | một CommandResult chứa kết quả từ việc chạy lệnh |
runTimedRetry
public abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Chặn và thực hiện một thao tác nhiều lần cho đến khi thành công.
Thông 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 |
Lợi nhuận | |
---|---|
boolean | true nếu hoạt động hoàn thành thành công trước khi đạt được lần thử. |
setEnvVariable
public abstract void setEnvVariable (String key, 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.
Thông số | |
---|---|
key | String : tên biến |
value | String : giá trị biến |
Xem thêm:
setEnvVariablePosystem
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Quyết định xem có hay không khi tạo một quy trình, việc bỏ đặt biến môi trường có mức độ ưu tiên cao hơn so với việc đặt chúng. Theo Mặc định, việc bỏ đặt có mức độ ưu tiên cao hơn: có nghĩa là nếu bạn cố gắng đặt một biến có cùng tên được thực hiện, thì điều đó 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.
Thông số | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
Đặt là có thể bị gián đoạn sau một thời gian chờ đợi. ERROR(/CommandScheduler#shutdownHard())
để thực thi chúng tôi chấm dứt cuối cùng.
Thông số | |
---|---|
thread | Thread : luồng sẽ trở nên gián đoạn. |
timeMs | long : thời gian chờ trước khi thiết lập có thể ngắt. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Cho phép sử dụng sự gián đoạn 'tiêu diệt' linux trên tiến trình chạy qua các phương thức #runTimed khi nó đến thời gian chờ. Không thể sử dụng trên phiên bản IRunUtil
mặc định.
Thông số | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
Đặt luồng lỗi tiêu chuẩn để chuyển hướng đến luồng đầu ra tiêu chuẩn khi chạy các lệnh hệ thống. Giá trị ban đầu là sai.
Thông số | |
---|---|
redirect | boolean : giá trị mới để biết có chuyển hướng hay không |
setWorkingDir
public abstract void setWorkingDir (File dir)
Đặt thư mục làm việc cho các lệnh hệ thống.
Thông số | |
---|---|
dir | File : thư mục làm việc |
Xem thêm:
ngủ
public abstract void sleep (long time)
Phương pháp trợ giúp để ngủ trong thời gian nhất định, bỏ qua bất kỳ trường hợp ngoại lệ nào.
Thông 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)
Hủy đặt một biến môi trường, do đó, các lệnh hệ thống chạy mà không có biến môi trường này.
Thông số | |
---|---|
key | String : tên biến |
Xem thêm:
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2022-08-15 UTC.