RunUtil

public class RunUtil
extends Object implements IRunUtil

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


オペレーションを実行するためのヘルパー メソッドのコレクション。

概要

定数

String INHERITIO_PREFIX

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 の割り込みステータスを返します。

Process runCmdInBackground(Redirect redirect, command)

コマンド引数を ERROR(/List) 形式で受け取る代替の runCmdInBackground(String) メソッド。

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)

システム コマンドを実行し、指定した時間より長くかかった場合は中止するヘルパー メソッド。

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)

タイムアウトに達したときに #runTimed メソッドで実行されているプロセスで Linux の「kill」割り込みを使用できるようにします。

void setRedirectStderrToStdout(boolean redirect)

システム コマンドの実行時に標準エラー ストリームが標準出力ストリームにリダイレクトされるように設定します。

void setWorkingDir(File dir)

システム コマンドの作業ディレクトリを設定します。

void sleep(long time)

指定された時間スリープし、例外を無視するヘルパー メソッド。

void unsetEnvVariable(String key)

環境変数の設定を解除します。これにより、システム コマンドはこの環境変数なしで実行されます。環境変数は親プロセスから継承される可能性があるため、ProcessBuilder.environment() から環境変数を削除する必要があります。

定数

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

定数値: "inheritio-"

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

定数値: "RunnableNotifier"

パブリック コンストラクタ

RunUtil

public RunUtil ()

使用する新しい 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 を使用したい発信者にとって便利です。カスタム 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 Run を中断できる場合は true、それ以外の場合は false。

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: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
Process 実行されたコマンドの Process

runCmdInBackground

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

システム コマンドを非同期で実行するヘルパー メソッド。

コマンドの起動直後に返されます。

パラメータ
redirect Redirect: ProcessBuilder に適用する ERROR(/Redirect)

command String: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
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 maxTime が切れる前にオペレーションが正常に完了した場合は true

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 maxTime が切れる前にオペレーションが正常に完了した場合は true

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 maxTime が切れる前にオペレーションが正常に完了した場合は true

runTimed

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)。null の場合もあります。

stderr OutputStream: エラー出力のリダイレクト先となる ERROR(/OutputStream)。null の場合もあります。

command String: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
CommandResult コマンド実行の結果を含む CommandResult

runTimedCmd

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

システム コマンドを実行し、指定した時間より長くかかった場合は中止するヘルパー メソッド。

パラメータ
timeout long: 待機する最大時間(ミリ秒単位)。0 はタイムアウトなしを意味します。

command String: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
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

runTimedCmdRetryWithOutputMonitor

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: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
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: 標準出力がリダイレクトされる ERROR(/File)。null の場合もあります。

stderrFile File: エラー出力のリダイレクト先となる ERROR(/File)。null の場合もあります。

command String: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
CommandResult コマンド実行の結果を含む CommandResult

runTimedCmdWithInput

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

stdin 入力を必要とするシステム コマンドを実行し、指定された時間よりも長くかかった場合は中止するヘルパー メソッド。

パラメータ
timeout long: 待機する最大時間(ミリ秒)

input String: プロセスに渡す stdin 入力

command String: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
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: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
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)。null の場合もあります。

stderr OutputStream: エラー出力のリダイレクト先となる ERROR(/OutputStream)。null の場合もあります。

command String: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
CommandResult コマンド実行の結果を含む CommandResult

runTimedCmdWithOutputMonitor

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

システム コマンドを実行し、指定した時間より長くかかった場合は中止するヘルパー メソッド。また、出力ストリームのアクティビティもモニタリングし、指定した時間内にストリーム アクティビティが検出されない場合は中止します。idleOutputTimeout がゼロに設定されている場合、ストリーム モニタリングは行われません。

パラメータ
timeout long: 待機する最大時間(ミリ秒単位)。0 はタイムアウトなしを意味します。

idleOutputTimeout long: 出力ストリームの出力の最大待機時間(ミリ秒)

command String: 指定されたシステム コマンドと、必要に応じて exec に渡す引数

戻り値
CommandResult コマンド実行の結果を含む CommandResult

runTimedRetry

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

オペレーションが成功するまで、オペレーションを複数回ブロックして実行します。

パラメータ
opTimeout long: 1 回のオペレーション試行で待機する最大時間(ミリ秒単位)

pollInterval long: コマンドの再試行の間に待機する時間

attempts int: 試行する最大回数

runnable IRunUtil.IRunnableResult: 実行する IRunUtil.IRunnableResult

戻り値
boolean 試行回数に達する前にオペレーションが正常に完了した場合は true

runTimedRetryWithOutputMonitor

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

オペレーションが成功するまで、オペレーションを複数回ブロックして実行します。また、出力ストリームのアクティビティもモニタリングし、指定した時間ストリーム アクティビティが検出されない場合は中止します。idleOutputTimeout がゼロに設定されている場合、ストリーム モニタリングは行われません。

パラメータ
opTimeout long: 1 回のオペレーション試行で待機する最大時間(ミリ秒単位)

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: 作業ディレクトリ

sleep

public void sleep (long time)

例外を無視して、指定された時間だけスリープするヘルパー メソッド。

パラメータ
time long: スリープするまでの時間(ミリ秒単位)。0 以下の値は無視されます。

unsetEnvVariable

public void unsetEnvVariable (String key)

環境変数の設定を解除します。これにより、システム コマンドはこの環境変数なしで実行されます。環境変数は親プロセスから継承される可能性があるため、ProcessBuilder.environment() から環境変数を削除する必要があります。

パラメータ
key String: 変数名