本頁面由 Cloud Translation API 翻譯而成。

RunUtil

public class RunUtil
extends Object implements IRunUtil

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

執行作業的輔助方法集合。

摘要

欄位
`public static final String`	`INHERITIO_PREFIX`
`public static final String`	`RUNNABLE_NOTIFIER_NAME`

公用建構函式
`RunUtil()` 建立要使用的新 `RunUtil` 物件。
`RunUtil(boolean inheritEnvVars)`

公用方法
`void`	`allowInterrupt(boolean allow)` 允許/禁止在目前執行緒上中斷執行。
`ProcessBuilder`	`createProcessBuilder(Redirect redirect, commandList, boolean enableCache)`
`static IRunUtil`	`getDefault()` 取得預設 `RunUtil` 物件的參照。
`void`	`interrupt(Thread thread, String message, ErrorIdentifier errorId)` 中斷指定執行緒進行中/即將執行的執行作業。
`void`	`interrupt(Thread thread, String message)` 中斷指定執行緒進行中/即將執行的執行作業。
`boolean`	`isInterruptAllowed()` 提供 RunUtil 的中斷狀態。
`static File`	`linkFile(File destRoot, String relToRoot, File target)` 將 `target` 連結至 `destRoot` 底下的地點。
`Process`	`runCmdInBackground(Redirect redirect, command)` 替代的 `runCmdInBackground(String)` 方法，可接受 `ERROR(/List)` 形式中的指令引數。
`Process`	`runCmdInBackground( command)` 可接受 `ERROR(/List)` 格式指令引數的替代 `runCmdInBackground(String)` 方法。
`Process`	`runCmdInBackground( command, OutputStream output)` 使用 `ERROR(/OutputStream)` 執行指令，記錄指令的輸出內容。
`Process`	`runCmdInBackground(String... command)` 用於非同步執行系統指令的輔助方法。
`Process`	`runCmdInBackground(Redirect redirect, String... command)` 用於非同步執行系統指令的輔助方法。
`boolean`	`runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` 封鎖並多次執行作業，直到成功為止。
`boolean`	`runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` 封鎖並多次執行作業，直到成功為止。
`boolean`	`runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` 封鎖並多次執行作業，直到成功為止。
`CommandStatus`	`runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` 封鎖並執行作業，如果作業時間超過指定時間，則中止作業。
`CommandResult`	`runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)` 執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止，並將輸出內容重新導向至指定的檔案。
`CommandResult`	`runTimedCmd(long timeout, String... command)` 執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。
`CommandResult`	`runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)` 執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。
`CommandResult`	`runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)` 執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。
`CommandResult`	`runTimedCmdSilently(long timeout, String... command)` 執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。
`CommandResult`	`runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)` 執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)` 執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止，並將輸出內容重新導向至指定的檔案。
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, String... command)` 輔助方法，用於執行需要 stdin 輸入內容的系統指令，並在執行時間超過指定時間時中止。
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, command)` 輔助方法，用於執行需要 stdin 輸入內容的系統指令，並在執行時間超過指定時間時中止。
`CommandResult`	`runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)` 輔助方法，用於執行需要從檔案重新導向 Stdin 的系統指令，並在執行時間超過指定時間時中止。
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)` 執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止，並將輸出內容重新導向至指定的檔案。
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)` 輔助方法執行系統指令，並在所需時間超過指定時間時取消。
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)` 輔助方法，可執行具有快取功能的系統指令。
`boolean`	`runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` 多次封鎖並執行一項作業，直到成功為止。
`boolean`	`runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` 封鎖並多次執行作業，直到成功為止。
`CommandStatus`	`runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` 封鎖並執行作業，如果作業時間超過指定時間，則中止作業。
`void`	`setEnvVariable(String name, String value)` 設定執行系統指令時要使用的環境變數。
`void`	`setEnvVariablePriority(IRunUtil.EnvPriority priority)` 決定在建立程序時，是否應將未設定的環境變數優先於設定的環境變數。
`void`	`setInterruptibleInFuture(Thread thread, long timeMs)` 設為等待一段時間後可中斷。
`void`	`setLinuxInterruptProcess(boolean interrupt)` 允許在達到逾時時，使用 Linux 的「kill」中斷功能，對透過 #runTimed 方法執行的程序進行中斷。
`void`	`setRedirectStderrToStdout(boolean redirect)` 設定標準錯誤串流，以便在執行系統指令時重新導向至標準輸出串流。
`void`	`setWorkingDir(File dir)` 設定系統指令的工作目錄。
`void`	`sleep(long time)` 輔助方法：在指定時間入睡，忽略任何例外狀況。
`static String`	`toRelative(File start, File target)`
`static String`	`toRelative(File start, String target)`
`void`	`unsetEnvVariable(String key)` 取消設定環境變數，讓系統指令在沒有這個環境變數的情況下執行。環境變數可能會繼承父項程序，因此我們需要從 `ProcessBuilder.environment()` 中刪除環境變數
`void`	`uploadCache(ICacheClient cacheClient, ExecutableActionResult actionResult)` 使用 cacheClient 上傳上次執行的 `ExecutableActionResult`。

欄位

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

公用建構函式

RunUtil

public RunUtil ()

建立要使用的新 RunUtil 物件。

執行工具

public RunUtil (boolean inheritEnvVars)

參數
`inheritEnvVars`	`boolean`

公用方法

allowInterrupt

public void allowInterrupt (boolean allow)

允許/禁止在目前執行緒上執行中斷。如果允許，則可透過 interrupt(Thread, String) 方法，從其他執行緒中中斷目前執行緒的執行作業。

參數
`allow`	`boolean`：是否允許在目前執行緒上執行中斷。

createProcessBuilder

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

參數
`redirect`	`Redirect`
`commandList`
`enableCache`	`boolean`

傳回
`ProcessBuilder`

getDefault

public static IRunUtil getDefault ()

取得預設 RunUtil 物件的參照。

如果呼叫端不想自訂，這項做法就很實用。建議需要自訂 IRunUtil 例項 (例如需要呼叫 setEnvVariable(String, String) 或 setWorkingDir(File)) 的呼叫端自行建立副本。

傳回
`IRunUtil`

中斷

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

中斷指定執行緒上正在執行/即將執行的作業。在指定執行緒上執行的作業會擲回 RunInterruptedException。

參數
`message`	`String`：`RunInterruptedException` 的訊息。
`errorId`	`ErrorIdentifier`：代表中斷原因 (如果已知)。

中斷

public void interrupt (Thread thread, 
                String message)

中斷指定執行緒上正在執行/即將執行的作業。在指定執行緒上執行的作業會擲回 RunInterruptedException。

參數
`message`	`String`：`RunInterruptedException` 的訊息。

isInterruptAllowed

public boolean isInterruptAllowed ()

提供 RunUtil 的中斷狀態。

傳回
`boolean`	如果可中斷執行作業，則傳回「true」，否則傳回「false」。

linkFile

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

將 target 連結至 destRoot 底下的地點。

如果目標檔案或符號連結已存在於 destRoot 底下，則系統不會連結檔案。

參數
`destRoot`	`File`：目的地的根。
`relToRoot`	`String`：從目的地目錄到根目錄的相對路徑。
`target`	`File`：要連結的目標檔案。

傳回
`File`	符號連結

擲回
	如果無法連結目標檔案。

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

可接受 ERROR(/List) 格式指令引數的替代 runCmdInBackground(String) 方法。

參數
`redirect`	`Redirect`：要套用至 `ProcessBuilder` 的 `ERROR(/Redirect)`。
`command`	：包含指定系統指令和選用引數的 `ERROR(/List)`，用於執行

傳回
`Process`	已執行指令的 `Process`

runCmdInBackground

public Process runCmdInBackground ( command)

可接受 ERROR(/List) 格式指令引數的替代 runCmdInBackground(String) 方法。

參數
`command`	：包含指定系統指令和選用引數的 `ERROR(/List)` (可供執行)

傳回
`Process`	已執行指令的 `Process`

runCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

使用 ERROR(/OutputStream) 執行指令，即可記錄指令的輸出內容。將 stdout 和 stderr 合併在一起。

參數
`command`	：要執行的指令
`output`	`OutputStream`：用於儲存輸出的 OutputStream

傳回
`Process`	執行指令的 `Process`

runCmdInBackground

public Process runCmdInBackground (String... command)

以非同步方式執行系統指令的輔助方法。

會在啟動指令後立即傳回。

參數
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`Process`	已執行指令的 `Process`

runCmdInBackground

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

以非同步方式執行系統指令的輔助方法。

會在啟動指令後立即傳回。

參數
`redirect`	`Redirect`：要套用至 `ProcessBuilder` 的 `ERROR(/Redirect)`。
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`Process`	已執行指令的 `Process`

runEscalatingTimedRetry

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

封鎖並多次執行作業，直到成功為止。

以指數方式增加每次嘗試作業之間的等待時間。這項屬性適用於執行作業 (例如輪詢伺服器) 時，可讓伺服器在暫時關閉時有時間復原。

參數
`opTimeout`	`long`：單一作業嘗試的最大等待時間 (以毫秒為單位)
`initialPollInterval`	`long`：作業嘗試之間的初始等待時間
`maxPollInterval`	`long`：作業嘗試之間的最大等待時間
`maxTime`	`long`：持續嘗試該作業的總預估時間上限
`runnable`	`IRunUtil.IRunnableResult`：要執行的 `IRunUtil.IRunnableResult`

傳回
`boolean`	`true`：如果作業在 maxTime 到期前順利完成

runFixedTimedRetry

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

封鎖並多次執行作業，直到成功為止。

參數
`opTimeout`	`long`：單一作業嘗試的最大等待時間 (以毫秒為單位)
`pollInterval`	`long`：作業嘗試之間的初始等待時間
`maxTime`	`long`：嘗試執行作業的總時間約略值
`runnable`	`IRunUtil.IRunnableResult`：要執行的 `IRunUtil.IRunnableResult`

傳回
`boolean`	`true`：如果作業在 maxTime 到期前順利完成

runFixedTimedRetryWithOutputMonitor

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

封鎖並多次執行作業，直到成功為止。也會監控輸出串流的活動，如果在指定時間內未偵測到任何串流活動，就會中止。如果將 idleOutputTimeout 設為零，系統就不會監控串流。

參數
`opTimeout`	`long`：單一作業嘗試的等待時間上限 (毫秒)
`idleOutputTimeout`	`long`：輸出串流的輸出內容等候時間上限 (以毫秒為單位)
`pollInterval`	`long`：作業嘗試之間的初始等待時間
`maxTime`	`long`：持續嘗試該作業的總預估時間上限
`runnable`	`IRunUtil.IRunnableResult`：要執行的 `IRunUtil.IRunnableResult`

傳回
`boolean`	`true`：如果作業在 maxTime 到期前順利完成

執行時間

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

封鎖並執行作業，如果作業時間超過指定時間，則中止作業。

參數
`timeout`	`long`：等待時間上限 (以毫秒為單位)
`runnable`	`IRunUtil.IRunnableResult`：要執行的 `IRunUtil.IRunnableResult`
`logErrors`	`boolean`：是否記錄例外狀況的錯誤。

傳回
`CommandStatus`	`CommandStatus` 作業的結果。

runTimedCmd

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

輔助方法可執行系統指令，如果執行時間超過指定時間，則中止執行，並將輸出內容重新導向至檔案 (如果指定)。以這種方式提供 ERROR(/OutputStream) 時，會在函式結束時將其保持開啟狀態。

參數
`timeout`	`long`：逾時等候時間上限 (毫秒)。0 代表沒有逾時。
`stdout`	`OutputStream`：`ERROR(/OutputStream)`，其中 std 輸出內容會重新導向。可以是空值。
`stderr`	`OutputStream`：`ERROR(/OutputStream)` 會將錯誤輸出內容重新導向。可以是空值。
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`CommandResult`	含有執行指令執行結果的 `CommandResult`

runTimedCmd

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

執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。

參數
`timeout`	`long`：等待時間上限 (以毫秒為單位)。0 表示沒有逾時。
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`CommandResult`	含有執行指令執行結果的 `CommandResult`

runTimedCmdRetry

public CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。

參數
`timeout`	`long`：每次嘗試時等待的時間上限 (毫秒)
`retryInterval`	`long`：每次重試指令前等待的時間
`attempts`	`int`：嘗試次數上限
`command`	`String`：指定的系統指令和 exec 的選用引數

傳回
`CommandResult`	包含指令執行結果的 `CommandResult`

runTimedCmd 重試 WithOutputMonitor

public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                long retryInterval, 
                int attempts, 
                String... command)

執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。同時監控輸出串流的活動，如果在指定時間內未偵測到任何串流活動，就會中止。如果將 idleOutputTimeout 設為零，系統就不會監控串流。

參數
`timeout`	`long`：每次嘗試時等待的時間上限 (毫秒)
`idleOutputTimeout`	`long`：輸出串流的輸出內容等候時間上限 (以毫秒為單位)
`retryInterval`	`long`：指令重試之間的等待時間
`attempts`	`int`：嘗試次數上限
`command`	`String`：指定的系統指令和 exec 的選用引數

傳回
`CommandResult`	包含指令執行結果的 `CommandResult`

runTimedCmdSilently

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

輔助方法執行系統指令，並在所需時間超過指定時間時取消。與 runTimedCmd(long, String) 類似，但不會在例外狀況中記錄任何錯誤。

參數
`timeout`	`long`：等待時間上限 (毫秒)
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`CommandResult`	包含指令執行結果的 `CommandResult`

runTimedCmdSilentlyRetry

public CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

執行系統指令的輔助方法，如果執行時間超過指定時間，就會中止。與 runTimedCmdRetry(long, long, int, String[]) 類似，但不會在例外狀況中記錄任何錯誤。

參數
`timeout`	`long`：等待時間上限 (以毫秒為單位)
`retryInterval`	`long`：指令重試之間的等待時間
`attempts`	`int`：嘗試次數上限
`command`	`String`：指定的系統指令和 exec 的選用引數

傳回
`CommandResult`	包含指令執行結果的 `CommandResult`

runTimedCmdWithInput

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

輔助方法，用於執行系統指令，如果執行時間超過指定時間，則中止執行，並將輸出內容重新導向至檔案 (如果指定)。

參數
`timeout`	`long`：逾時的最大等待時間 (以毫秒為單位)。0 表示沒有逾時。
`input`	`String`：要傳遞至處理程序的 stdin 輸入內容
`stdoutFile`	`File`：要重新導向 std 輸出內容的 `ERROR(/File)`。可為空值。
`stderrFile`	`File`：`ERROR(/File)` 會將錯誤輸出內容重新導向。可為空值。
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`CommandResult`	含有執行指令執行結果的 `CommandResult`

runTimedCmdWithInput

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

輔助方法可執行需要 stdin 輸入的系統指令，並在所需時間超過指定時間時取消。

參數
`timeout`	`long`：等待時間上限 (以毫秒為單位)
`input`	`String`：要傳遞至處理程序的 stdin 輸入內容
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`CommandResult`	含有執行指令執行結果的 `CommandResult`

runTimedCmdWithInput

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

輔助方法可執行需要 stdin 輸入的系統指令，並在所需時間超過指定時間時取消。

參數
`timeout`	`long`：等待時間上限 (以毫秒為單位)
`input`	`String`：要傳遞至處理程序的 stdin 輸入內容
`command`	：`ERROR(/List)` 包含系統指令和執行選用引數

傳回
`CommandResult`	包含指令執行結果的 `CommandResult`

runTimedCmdWithInputRedirect

public CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

輔助方法可執行需要從檔案重新導向 Stdin 的系統指令，並在所需時間超過指定時間時取消。

參數
`timeout`	`long`：等待時間上限 (以毫秒為單位)
`inputRedirect`	`File`：使用 `ProcessBuilder.redirectInput()` 重新導向至標準輸入的 `ERROR(/File)`。如果為 null，則不會重新導向 stdin。
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`CommandResult`	包含指令執行結果的 `CommandResult`

runTimedCmdWithOutputMonitor

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

輔助方法可執行系統指令，如果執行時間超過指定時間，則會中止，並將輸出內容重新導向至檔案 (如果指定)。以這種方式提供 ERROR(/OutputStream) 時，會在函式結束時將其保持開啟狀態。

參數
`timeout`	`long`：逾時的最大等待時間 (以毫秒為單位)。0 表示沒有逾時。
`idleOutputTimeout`	`long`：輸出串流的輸出內容等候時間上限 (以毫秒為單位)
`stdout`	`OutputStream`：`ERROR(/OutputStream)`，其中 std 輸出內容會重新導向。可為空值。
`stderr`	`OutputStream`：`ERROR(/OutputStream)` 會將錯誤輸出內容重新導向。可為空值。
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`CommandResult`	包含指令執行結果的 `CommandResult`

runTimedCmdWithOutputMonitor

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

參數
`timeout`	`long`：等待時間上限 (以毫秒為單位)。0 表示沒有逾時。
`idleOutputTimeout`	`long`：輸出串流的輸出內容最長 (以毫秒為單位)
`command`	`String`：指定的系統指令和選用的執行引數

傳回
`CommandResult`	含有執行指令執行結果的 `CommandResult`

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                ICacheClient cacheClient, 
                String... command)

輔助方法，可執行具有快取功能的系統指令。

如果指定 cacheClient，系統就會啟用快取。如果快取可用，系統會傳回快取的結果。否則，系統會使用 runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String) 執行指令，並上傳結果以供快取。

參數
`timeout`	`long`：逾時的最大等待時間 (以毫秒為單位)。0 表示沒有逾時。
`idleOutputTimeout`	`long`：輸出串流的輸出內容最長 (以毫秒為單位)。
`stdout`	`OutputStream`：`ERROR(/OutputStream)`，其中 std 輸出內容會重新導向。可為空值。
`stderr`	`OutputStream`：`ERROR(/OutputStream)` 會將錯誤輸出內容重新導向。可為空值。
`cacheClient`	`ICacheClient`：用於處理快取的 `ICacheClient` 例項。
`command`	`String`：指定的系統指令和選用的執行引數。

傳回
`CommandResult`	包含指令執行結果的 `CommandResult`。

runTimedRetry

public boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

封鎖並多次執行作業，直到成功為止。

參數
`opTimeout`	`long`：單一作業嘗試的最大等待時間 (以毫秒為單位)
`pollInterval`	`long`：每次重試指令前等待的時間
`attempts`	`int`：嘗試次數上限
`runnable`	`IRunUtil.IRunnableResult`：要執行的 `IRunUtil.IRunnableResult`

傳回
`boolean`	如果在嘗試次數達到上限之前，作業已順利完成，則為 `true`。

runTimed 重試 WithOutputMonitor

public boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

封鎖並多次執行作業，直到成功為止。也會監控輸出串流的活動，如果在指定時間內未偵測到任何串流活動，就會中止。如果閒置輸出逾時設為零，就不會發生串流監控事件。

參數
`opTimeout`	`long`：單一作業嘗試的最大等待時間 (以毫秒為單位)
`idleOutputTimeout`	`long`：輸出串流的輸出內容等候時間上限 (以毫秒為單位)
`pollInterval`	`long`：指令重試之間的等待時間
`attempts`	`int`：嘗試次數上限
`runnable`	`IRunUtil.IRunnableResult`：要執行的 `IRunUtil.IRunnableResult`

傳回
`boolean`	如果在嘗試次數達到上限之前，作業已順利完成，則為 `true`。

runTimedWithOutputMonitor

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

封鎖並執行作業，如果作業時間超過指定時間，就會取消作業。也會監控輸出串流的活動，如果在指定時間內未偵測到任何串流活動，就會中止。如果將 idleOutputTimeout 設為零，系統就不會監控串流。

參數
`timeout`	`long`：等待時間上限 (以毫秒為單位)
`idleOutputTimeout`	`long`：輸出串流的輸出內容最長 (以毫秒為單位)
`runnable`	`IRunUtil.IRunnableResult`：要執行的 `IRunUtil.IRunnableResult`
`logErrors`	`boolean`：在例外狀況上記錄錯誤。

傳回
`CommandStatus`	運算的 `CommandStatus` 結果。

setEnvVariable

public void setEnvVariable (String name, 
                String value)

設定執行系統指令時要使用的環境變數。

參數
`name`	`String`：變數名稱
`value`	`String`：變數值

setEnvVariablePriority

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

決定是否建立程序時，取消設定環境變數的優先順序是否高於設定值。根據預設，取消設定的優先順序較高：也就是說，如果嘗試設定同名的變數，由於變數會取消設定，因此不會發生。無法用於預設 IRunUtil 執行個體，

參數
`priority`	`IRunUtil.EnvPriority`

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

在一段等待時間後設為可中斷。ERROR(/CommandScheduler#shutdownHard()) 會強制我們最終終止。

參數
`thread`	`Thread`：會變成可中斷的執行緒。
`timeMs`	`long`：設定可中斷前等待的時間。

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

允許在達到逾時時，在透過 #runTimed 方法執行的程序中使用 Linux「kill」中斷。無法在預設 IRunUtil 例項上使用。

參數
`interrupt`	`boolean`

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

設定標準錯誤串流，以便在執行系統指令時重新導向至標準輸出串流。初始值為 false。

參數
`redirect`	`boolean`：是否重新導向的新值

setWorkingDir

public void setWorkingDir (File dir)

設定系統指令的工作目錄。

參數
`dir`	`File`：工作目錄

舒眠

public void sleep (long time)

輔助方法，可讓程式暫停一段時間，並忽略任何例外狀況。

參數
`time`	`long`：休眠毫秒。系統會忽略小於或等於 0 的值

toRelative

public static String toRelative (File start, 
                File target)

參數
`start`	`File`
`target`	`File`

傳回
`String`

toRelative

public static String toRelative (File start, 
                String target)

參數
`start`	`File`
`target`	`String`

傳回
`String`

unsetEnvVariable

public void unsetEnvVariable (String key)

取消設定環境變數，讓系統指令在沒有這個環境變數的情況下執行。環境變數可能會從父程序繼承，因此我們需要從 ProcessBuilder.environment() 刪除環境變數。

參數
`key`	`String`：變數名稱

另請參閱：

ProcessBuilder.environment()

uploadCache

public void uploadCache (ICacheClient cacheClient, 
                ExecutableActionResult actionResult)

使用 cacheClient 上傳上次執行的 ExecutableActionResult。

參數
`cacheClient`	`ICacheClient`：用於上傳結果的 `ICacheClient`。
`actionResult`	`ExecutableActionResult`：要上傳的 `ExecutableActionResult`。