RunUtil

public class RunUtil
extends Object implements IRunUtil

java.lang.Object
↳	com.android.tradefed.util.RunUtil

---

Tập hợp các phương thức trợ giúp để thực thi các thao tác.

Tóm tắt

Trường
public static final String	INHERITIO_PREFIX
public static final String	RUNNABLE_NOTIFIER_NAME

Hàm khởi tạo công khai
RunUtil() Tạo một đối tượng RunUtil mới để sử dụng.
RunUtil(boolean inheritEnvVars)

Phương thức 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.
ProcessBuilder	createProcessBuilder(Redirect redirect, commandList, boolean enableCache)
static IRunUtil	getDefault() Lấy 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 thao tác đang chạy/tiếp theo trên luồng nhất định.
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.
boolean	isInterruptAllowed() Cung cấp trạng thái gián đoạn của RunUtil.
static File	linkFile(File destRoot, String relToRoot, File target) Liên kết target với một địa điểm trong destRoot.
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).
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).
Process	runCmdInBackground( command, OutputStream output) Chạy lệnh bằng ERROR(/OutputStream) ghi lại kết quả của lệnh.
Process	runCmdInBackground(String... command) Phương thức trợ giúp để thực thi lệnh hệ thống một cách không đồng bộ.
Process	runCmdInBackground(Redirect redirect, String... command) Phương thức trợ giúp để thực thi lệnh hệ thống một cách không đồng bộ.
boolean	runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.
boolean	runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.
boolean	runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.
CommandStatus	runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Chặn và thực thi một thao tác, huỷ nếu thao tác đó mất nhiều thời gian hơn thời gian đã chỉ định.
CommandResult	runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command) Phương thức trợ giúp để thực thi lệnh hệ thống, huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định và chuyển hướng đầu ra đến các tệp nếu được chỉ định.
CommandResult	runTimedCmd(long timeout, String... command) Phương thức trợ giúp để thực thi 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.
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.
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.
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.
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.
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.
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.
CommandResult	runTimedCmdWithInput(long timeout, String input, command) Phương thức trợ giúp để thực thi một lệnh hệ thống yêu cầu nhập stdin và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định.
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 quá trình này mất nhiều thời gian hơn thời gian đã chỉ định.
CommandResult	runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command) Phương thức trợ giúp để thực thi lệnh hệ thống, huỷ nếu 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.
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.
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.
boolean	runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.
boolean	runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.
CommandStatus	runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Chặn và thực thi một thao tác, huỷ nếu thao tác đó mất nhiều thời gian hơn thời gian đã chỉ định.
void	setEnvVariable(String name, String value) Đặt biến môi trường để sử dụng khi chạy các lệnh hệ thống.
void	setEnvVariablePriority(IRunUtil.EnvPriority priority) Quyết định xem khi tạo một quy trình hay không, việc huỷ thiết lập biến môi trường sẽ có mức độ ưu tiên cao hơn so với việc đặt biến.
void	setInterruptibleInFuture(Thread thread, long timeMs) Được đặt là có thể gián đoạn sau một thời gian chờ.
void	setLinuxInterruptProcess(boolean interrupt) Cho phép sử dụng linux "kill" gián đoạn trên quy trình chạy thông qua các phương thức #runTimed khi hết thời gian chờ.
void	setRedirectStderrToStdout(boolean redirect) Đặt luồng lỗi chuẩn để chuyển hướng đến luồng đầu ra chuẩn khi chạy các lệnh hệ thống.
void	setWorkingDir(File dir) Đặt thư mục hoạt động cho các lệnh hệ thống.
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ệ.
static String	toRelative(File start, File target)
static String	toRelative(File start, String target)
void	unsetEnvVariable(String key) Huỷ đặt một biến môi trường để các lệnh hệ thống chạy mà không cần biến môi trường này. Các biến môi trường có thể kế thừa từ quy trình mẹ, vì vậy, chúng ta cần xoá biến môi trường khỏi ProcessBuilder.environment()
void	uploadCache(ICacheClient cacheClient, ExecutableActionResult actionResult) Tải ExecutableActionResult gần đây nhất lên bằng cacheClient.

Trường

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

Hàm khởi tạo công khai

RunUtil

public RunUtil ()

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

RunUtil

public RunUtil (boolean inheritEnvVars)

Tham số
inheritEnvVars	boolean

Phương thức 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 được cho phép, việc chạy các hoạt động của luồng hiện tại có thể bị gián đoạn từ các luồng khác thông qua phương thức interrupt(Thread, String).

Tham số
allow	boolean: cho phép chạy các ngắt trên luồng hiện tại hay không.

createProcessBuilder

public ProcessBuilder createProcessBuilder (Redirect redirect, 
                 commandList, 
                boolean enableCache)

Tham số
redirect	Redirect
commandList
enableCache	boolean

Giá trị trả về
ProcessBuilder

getDefault

public static IRunUtil getDefault ()

Lấy tham chiếu đến đối tượng RunUtil mặc định.

Điều này hữu ích cho những phương thức gọi muốn sử dụng IRunUtil mà không cần tuỳ chỉnh. Những phương thức gọi cần một thực thể IRunUtil tuỳ chỉnh (tức là cần gọi setEnvVariable(String, String) hoặc setWorkingDir(File)) nên tạo bản sao của riêng mình.

Giá trị trả về
IRunUtil

gián đoạn

public void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

Làm gián đoạn các thao tác đang chạy/tiếp theo trên luồng nhất định. Các thao tác chạy trên luồng đã cho sẽ gửi RunInterruptedException.

Tham số
message	String: thông báo cho RunInterruptedException.
errorId	ErrorIdentifier: Biểu thị nguyên nhân gây gián đoạn (nếu có).

gián đoạn

public void interrupt (Thread thread, 
                String message)

Làm gián đoạn các thao tác đang chạy/tiếp theo trên luồng nhất định. Các thao tác chạy trên luồng đã cho sẽ gửi RunInterruptedException.

Tham số
message	String: thông báo cho RunInterruptedException.

isInterruptAllowed

public boolean isInterruptAllowed ()

Cung cấp trạng thái 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.

linkFile

public static File linkFile (File destRoot, 
                String relToRoot, 
                File target)

Liên kết target với một địa điểm trong destRoot.

Nếu tệp đích hoặc đường liên kết tượng trưng đã tồn tại trong destRoot, thì tệp đó sẽ không được liên kết.

Tham số
destRoot	File: Phần gốc của đích đến.
relToRoot	String: Đường dẫn tương đối từ thư mục đích đến đến thư mục gốc.
target	File: Tệp đích cần được liên kết.

Giá trị trả về
File	đường liên kết tượng trưng

Gửi
	nếu không liên kết được tệp đích.

runCmdInBackground

public 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

runCmdInBackground

public 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

runCmdInBackground

public 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

runCmdInBackground

public Process runCmdInBackground (String... command)

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

Sẽ quay lại ngay sau khi chạy lệnh.

Tham số
command	String: lệnh hệ thống được chỉ định và các đối số tuỳ chọn để thực thi

Giá trị trả về
Process	Process của lệnh đã thực thi

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                String... command)

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

Sẽ quay lại ngay sau khi chạy lệnh.

Tham số
redirect	Redirect: ERROR(/Redirect) để áp dụng cho ProcessBuilder.
command	String: lệnh hệ thống được chỉ định và các đối số tuỳ chọn để thực thi

Giá trị trả về
Process	Process của lệnh đã thực thi

runEscalatingTimedRetry

public boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công.

Tăng theo cấp số nhân thời gian chờ giữa các lần thử thao tác. 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 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 hết hạn maxTime

runFixedTimedRetryWithOutputMonitor

public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Chặn và thực thi một thao tác nhiều lần cho đến khi thao tác đó thành công. Ngoài ra, còn theo dõi luồng đầu ra để biết 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ố
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

thời gian chạy

public CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

Chặn và thực thi một tác vụ, huỷ bỏ nếu mất nhiều thời gian hơn một thời gian đã chỉ định.

Tham số
timeout	long: thời gian chờ tối đa tính bằng mili giây
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult để thực thi
logErrors	boolean: ghi lỗi 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 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ố không bắt buộc thực thi

Giá trị trả về
CommandResult	một CommandResult chứa kết quả từ lần chạy lệnh

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                String... command)

Phương thức trợ giúp để thực thi 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 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 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. Đồng thời, giám sát các luồng đầu ra để phát hiện hoạt động, huỷ nếu không quan sát thấy hoạt động nào trong luồng trong một thời gian nhất định. Nếu bạn đặt thời gian không hoạt động rảnh (idOutput) thành 0, thì hoạt động giám sát luồng sẽ không diễn ra.

Tham số
timeout	long: thời gian chờ tối đa tính bằng mili giây cho mỗi lần thử
idleOutputTimeout	long: thời gian 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 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	một CommandResult chứa kết quả từ lần 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 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 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 có 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ể có giá trị rỗng.
command	String: lệnh hệ thống được chỉ định và các đối số không bắt buộc thực thi

Giá trị trả về
CommandResult	một CommandResult chứa kết quả từ lần chạy lệnh

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

Phương thức trợ giúp để thực thi một lệnh hệ thống yêu cầu đầ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 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 CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

Phương thức trợ giúp để thực thi lệnh hệ thống yêu cầu chuyển hướng Stdin từ một tệp và huỷ nếu mất nhiều thời gian hơn một khoảng thời gian đã chỉ định.

Tham số
timeout	long: thời gian chờ tối đa tính bằng mili giây
inputRedirect	File: ERROR(/File) để chuyển hướng dưới dạng 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 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ố không bắt buộc thực thi

Giá trị trả về
CommandResult	một CommandResult chứa kết quả từ lần chạy lệnh

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

Phương thức trợ giúp để thực thi 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 để biết 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 CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                ICacheClient cacheClient, 
                String... command)

Phương thức trợ giúp để thực thi lệnh hệ thống bằng chức năng lưu vào bộ nhớ đệm.

Nếu bạn chỉ định cacheClient, 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 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.
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 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 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 để biết 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ố
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 tối đa để chờ tính bằng mili giây cho đầu ra trên luồng đầu ra
pollInterval	long: thời gian chờ giữa các lần thử lại lệnh
attempts	int: số lần thử tối đa
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult để thực thi

Giá trị trả về
boolean	true nếu thao tác hoàn tất thành công trước khi đạt đến số lần thử.

runTimedWithOutputMonitor

public 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. Đồng thời, giám sát các luồng đầu ra để phát hiện hoạt động, huỷ nếu không quan sát thấy hoạt động nào trong luồng trong một thời gian được chỉ định. Nếu bạn đặt 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 void setEnvVariable (String name, 
                String value)

Đặt biến môi trường để sử dụng khi chạy các lệnh hệ thống.

Tham số
name	String: tên biến
value	String: giá trị biến

setEnvVariablePriority

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

Quyết định xem khi tạo một quy trình hay không, việc huỷ thiết lập biến môi trường sẽ có mức độ ưu tiên cao hơn so với việc đặt biến. Theo mặc định, việc huỷ 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 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 void setLinuxInterruptProcess (boolean interrupt)

Cho phép sử dụng linux "kill" gián đoạn trên quy trình chạy thông qua các phương thức #runTimed khi hết thời gian chờ. Không thể sử dụng trên thực thể IRunUtil mặc định.

Tham số
interrupt	boolean

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

Đặt luồng lỗi chuẩn để chuyển hướng đến luồng đầu ra chuẩn khi chạy các lệnh hệ thống. Giá trị ban đầu là false.

Tham số
redirect	boolean: giá trị mới cho việc có chuyển hướng hay không

setWorkingDir

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

toRelative

public static String toRelative (File start, 
                File target)

Tham số
start	File
target	File

Giá trị trả về
String

toRelative

public static String toRelative (File start, 
                String target)

Tham số
start	File
target	String

Giá trị trả về
String

biếnEnvBiến

public void unsetEnvVariable (String key)

Huỷ đặt một biến môi trường để các lệnh hệ thống chạy mà không cần biến môi trường này. Biến môi trường có thể kế thừa từ quy trình gốc, vì vậy, chúng ta cần xoá biến môi trường khỏi ProcessBuilder.environment()

Tham số
key	String: tên biến

Xem thêm:

• ProcessBuilder.environment()

uploadCache

public 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 để tải lên.