Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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 hoạt động.

Bản tóm tắt

Lĩnh vực

public static final String INHERITIO_PREFIX

public static final String RUNNABLE_NOTIFIER_NAME

Các nhà xây dựng công cộng

RunUtil ()

Tạo một đối tượng RunUtil mới để sử dụng.

Phương pháp công khai

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.

static IRunUtil getDefault ()

Nhận tham chiếu đến đối tượng RunUtil mặc định.

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.

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.

boolean isInterruptAllowed ()

Đưa ra trạng thái ngắt của RunUtil.

Process runCmdInBackground (Redirect redirect, command) 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) .

Process runCmdInBackground (String... command)

Phương thức trợ giúp để thực thi lệnh hệ thống không đồng bộ.

Process runCmdInBackground ( command) 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) .

Process runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output)

Đang chạy lệnh có ERROR(/OutputStream) ghi lại kết quả đầu ra của lệnh.

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

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.

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.

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.

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

CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)

Phương thức trợ giúp để thực thi một lệnh hệ thống, hủy bỏ nếu nó 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.

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

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

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

CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)

Phương thức trợ giúp để thực thi một lệnh hệ thống, hủy bỏ nếu nó 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.

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

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

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à 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ể.

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.

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

void setInterruptibleInFuture (Thread thread, long timeMs)

Đặt là có thể bị gián đoạn sau một thời gian chờ đợi.

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

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.

void setWorkingDir (File dir)

Đặt thư mục làm việc cho các lệnh hệ thống.

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.

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. Các biến môi trường có thể kế thừa từ tiến trình mẹ, vì vậy chúng ta cần xóa biến môi trường khỏi ProcessBuilder.environment()

Lĩnh vực

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

Các nhà xây dựng công cộng

RunUtil

public RunUtil ()

Tạo một đối tượng RunUtil mới để sử dụng.

Phương pháp công khai

allowInterrupt

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

getDefault

public static IRunUtil getDefault ()

Nhận tham chiếu đến đối tượng RunUtil mặc định.

Điều này hữu ích cho những người gọi muốn sử dụng IRunUtil mà không cần tùy chỉnh. Nó được khuyến nghị rằng những người gọi cần một cá thể IRunUtil tùy 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 họ.

Lợi nhuận
IRunUtil

ngắt

public 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 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 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 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

runCmdInBackground

public 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

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

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

runCmdInBackground

public 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 : lệnh chạy

output OutputStream : Dòng đầu ra để lưu đầu ra

Lợi nhuận
Process Process chạy lệnh

runCmdInBackground

public 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

runEscalatingTimedRetry

public 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 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 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 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 CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

Phương thức trợ giúp để thực thi một lệnh hệ thống, hủy bỏ nếu nó 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 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 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 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 CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

Phương thức trợ giúp để thực thi một lệnh hệ thống, hủy bỏ nếu nó 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 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 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 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à 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 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 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.

Thông số
name String : tên biến

value String : giá trị biến

setEnvVariablePosystem

public 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 cố gắng đặt một biến có cùng tên được thực hiện, đ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 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 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 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 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

ngủ

public 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 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. Các biến môi trường có thể kế thừa từ tiến trình mẹ, vì vậy chúng ta cần xóa biến môi trường khỏi ProcessBuilder.environment()

Thông số
key String : tên biến