IRunUtil
public
interface
IRunUtil
com.android.tradefed.util.IRunUtil |
時間指定オペレーションやシステム コマンドを実行するためのインターフェース。
概要
ネストされたクラス | |
---|---|
interface |
IRunUtil.IRunnableResult
ブール値のステータスを返すオペレーションを非同期で実行するためのインターフェース。 |
パブリック メソッド | |
---|---|
abstract
void
|
allowInterrupt(boolean allow)
現在のスレッドでの実行割り込みを許可または禁止します。 |
abstract
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
指定されたスレッドでの進行中または今後の実行オペレーションを中断します。 |
abstract
void
|
interrupt(Thread thread, String message)
指定されたスレッドでの進行中または今後の実行オペレーションを中断します。 |
abstract
boolean
|
isInterruptAllowed()
RunUtil の割り込みステータスを指定します。 |
abstract
Process
|
runCmdInBackground(Redirect redirect,
コマンド引数を受け入れる代替 |
abstract
Process
|
runCmdInBackground(
コマンド引数を受け入れる代替 |
abstract
Process
|
runCmdInBackground(
|
abstract
Process
|
runCmdInBackground(String... command)
システム コマンドを非同期で実行するヘルパー メソッド。 |
abstract
Process
|
runCmdInBackground(Redirect redirect, String... command)
システム コマンドを非同期で実行するヘルパー メソッド。 |
abstract
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。 |
abstract
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。 |
abstract
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。 |
abstract
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
オペレーションをブロックして実行し、指定した時間よりも時間がかかる場合は中止します。 |
abstract
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
システム コマンドを実行するためのヘルパー メソッド。指定した時間よりも時間がかかった場合は中止します。 指定した場合は出力をファイルにリダイレクトします。 |
abstract
CommandResult
|
runTimedCmd(long timeout, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。 |
abstract
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。 |
abstract
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。 |
abstract
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。 |
abstract
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。 |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
システム コマンドを実行するためのヘルパー メソッド。指定した時間よりも時間がかかった場合は中止します。 指定した場合は出力をファイルにリダイレクトします。 |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
stdin 入力を必要とするシステム コマンドを実行し、必要に応じて中止するヘルパー メソッド より長い時間を要していることを示します。 |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
stdin 入力を必要とするシステム コマンドを実行し、必要に応じて中止するヘルパー メソッド より長い時間を要していることを示します。 |
abstract
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
ファイルから Stdin をリダイレクトする必要があるシステム コマンドを実行するヘルパー メソッド 処理が指定の時間より長い場合は中止します |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
システム コマンドを実行するためのヘルパー メソッド。指定した時間よりも時間がかかった場合は中止します。 指定した場合は出力をファイルにリダイレクトします。 |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。 |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
キャッシュを利用したシステム コマンドを実行するためのヘルパー メソッド。 |
abstract
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。 |
abstract
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。 |
abstract
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
オペレーションをブロックして実行し、指定した時間よりも時間がかかる場合は中止します。 |
abstract
void
|
setEnvVariable(String key, String value)
システム コマンドの実行時に使用される環境変数を設定します。 |
abstract
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
プロセスの作成時に環境変数の設定解除のほうが大きいかどうかを判断する 優先順位を付けることができます |
abstract
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
一定の待機時間後に割り込み可能として設定される。 |
abstract
void
|
setLinuxInterruptProcess(boolean interrupt)
Linux の「kill」の使用を許可する#runTimed メソッドで実行中のプロセスの中断が タイムアウトします。 |
abstract
void
|
setRedirectStderrToStdout(boolean redirect)
システムの実行時に標準出力ストリームにリダイレクトするように標準エラー ストリームを設定する 使用できます。 |
abstract
void
|
setWorkingDir(File dir)
システム コマンドの作業ディレクトリを設定します。 |
abstract
void
|
sleep(long time)
例外を無視して、指定された時間スリープするヘルパー メソッド。 |
abstract
void
|
unsetEnvVariable(String key)
環境変数の設定を解除して、この環境変数なしでシステム コマンドが実行されるようにします。 |
パブリック メソッド
allowInterrupt
public abstract void allowInterrupt (boolean allow)
現在のスレッドでの実行割り込みを許可または禁止します。許可されている場合、次のオペレーションを実行します:
現在のスレッドは、interrupt(Thread, String)
メソッドを介して他のスレッドから中断できます。
パラメータ | |
---|---|
allow |
boolean : 現在のスレッドでの実行割り込みを許可するかどうか。 |
割り込み
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
指定されたスレッドでの進行中または今後の実行オペレーションを中断します。実行オペレーションは
指定したスレッドが RunInterruptedException
をスローする。
パラメータ | |
---|---|
message |
String : RunInterruptedException のメッセージ。 |
errorId |
ErrorIdentifier : 既知の場合、中断の原因を表します。 |
割り込み
public abstract void interrupt (Thread thread, String message)
指定されたスレッドでの進行中または今後の実行オペレーションを中断します。実行オペレーションは
指定したスレッドが RunInterruptedException
をスローする。
パラメータ | |
---|---|
message |
String : RunInterruptedException のメッセージ。 |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
RunUtil の割り込みステータスを指定します。
戻り値 | |
---|---|
boolean |
実行を中断できる場合は true、それ以外の場合は false。 |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
コマンド引数を受け入れる代替 runCmdInBackground(String)
メソッド
(ERROR(/List)
形式)。
パラメータ | |
---|---|
redirect |
Redirect : ProcessBuilder に適用する ERROR(/Redirect) 。 |
command |
: 指定されたシステム コマンドとオプションの引数を含む ERROR(/List)
役員 |
戻り値 | |
---|---|
Process |
実行されたコマンドの Process |
例外 | |
---|---|
|
コマンドの実行が失敗した場合 |
runCmdInBackground
public abstract Process runCmdInBackground (command)
コマンド引数を受け入れる代替 runCmdInBackground(String)
メソッド
(ERROR(/List)
形式)。
パラメータ | |
---|---|
command |
: 指定されたシステム コマンドとオプションの引数を含む ERROR(/List)
役員 |
戻り値 | |
---|---|
Process |
実行されたコマンドの Process |
例外 | |
---|---|
|
コマンドの実行が失敗した場合 |
runCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
ERROR(/OutputStream)
を指定してコマンドを実行すると、コマンドの出力がログに記録されます。
stdout と stderr が統合される。
パラメータ | |
---|---|
command |
: 実行するコマンド |
output |
OutputStream : 出力を保存する OutputStream |
戻り値 | |
---|---|
Process |
コマンドを実行している Process |
例外 | |
---|---|
|
IOException |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
システム コマンドを非同期で実行するヘルパー メソッド。
コマンドを起動した直後に返されます。
パラメータ | |
---|---|
command |
String : 指定されたシステム コマンドと exec 引数(省略可) |
戻り値 | |
---|---|
Process |
実行されたコマンドの Process |
例外 | |
---|---|
|
コマンドの実行が失敗した場合 |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
システム コマンドを非同期で実行するヘルパー メソッド。
コマンドを起動した直後に返されます。
パラメータ | |
---|---|
redirect |
Redirect : ProcessBuilder に適用する ERROR(/Redirect) 。 |
command |
String : 指定されたシステム コマンドと exec 引数(省略可) |
戻り値 | |
---|---|
Process |
実行されたコマンドの Process |
例外 | |
---|---|
|
コマンドの実行が失敗した場合 |
runEscalatingTimedRetry
public abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。
オペレーションの試行間の待機時間が指数関数的に長くなります。これは UDM イベントで サーバーのポーリングなどの操作を実行するときに、障害が発生した場合に復旧する時間を確保 停止している場合です
パラメータ | |
---|---|
opTimeout |
long : 1 回のオペレーションの試行の最大待機時間(ミリ秒) |
initialPollInterval |
long : オペレーション試行間の初期待機時間 |
maxPollInterval |
long : オペレーションの試行間の最大待機時間 |
maxTime |
long : オペレーションの試行を続行するおおよその最大時間の合計 |
runnable |
IRunUtil.IRunnableResult : 実行する IRunUtil.IRunnableResult |
戻り値 | |
---|---|
boolean |
maxTime の期限が切れる前にオペレーションが正常に完了した場合は true |
runFixedTimedRetry
public abstract boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。
パラメータ | |
---|---|
opTimeout |
long : 1 回のオペレーションの試行の最大待機時間(ミリ秒) |
pollInterval |
long : オペレーション試行間の初期待機時間 |
maxTime |
long : オペレーションの試行を続行するおおよその最大時間の合計 |
runnable |
IRunUtil.IRunnableResult : 実行する IRunUtil.IRunnableResult |
戻り値 | |
---|---|
boolean |
maxTime の期限が切れる前にオペレーションが正常に完了した場合は true |
runFixedTimedRetryWithOutputMonitor
public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。また、 アクティビティの出力ストリーム。指定された時間にわたってストリーム アクティビティが確認されなかった場合は中止します。 emptyOutputTimeout を 0 に設定した場合、ストリームのモニタリングは行われません。
パラメータ | |
---|---|
opTimeout |
long : 1 回のオペレーションの試行の最大待機時間(ミリ秒) |
idleOutputTimeout |
long : 出力ストリームでの出力の最大待機時間(ミリ秒) |
pollInterval |
long : オペレーション試行間の初期待機時間 |
maxTime |
long : オペレーションの試行を続行するおおよその最大時間の合計 |
runnable |
IRunUtil.IRunnableResult : 実行する IRunUtil.IRunnableResult |
戻り値 | |
---|---|
boolean |
maxTime の期限が切れる前にオペレーションが正常に完了した場合は true |
runTimed
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
オペレーションをブロックして実行し、指定した時間よりも時間がかかる場合は中止します。
パラメータ | |
---|---|
timeout |
long : 最大待機時間(ミリ秒) |
runnable |
IRunUtil.IRunnableResult : 実行する IRunUtil.IRunnableResult |
logErrors |
boolean : 例外の発生時にエラーをログに記録します。 |
戻り値 | |
---|---|
CommandStatus |
演算の CommandStatus の結果。 |
runTimedCmd
public abstract 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 abstract CommandResult runTimedCmd (long timeout, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。
パラメータ | |
---|---|
timeout |
long : 最大待機時間(ミリ秒)。0 はタイムアウトがないことを意味します。 |
command |
String : 指定されたシステム コマンドと exec 引数(省略可) |
戻り値 | |
---|---|
CommandResult |
コマンド実行の結果を含む CommandResult |
runTimedCmdRetry
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。
パラメータ | |
---|---|
timeout |
long : 各試行の最大待機時間(ミリ秒) |
retryInterval |
long : コマンド再試行までの待機時間 |
attempts |
int : 試行の最大回数 |
command |
String : 指定されたシステム コマンドと exec 引数(省略可) |
戻り値 | |
---|---|
CommandResult |
コマンド実行の結果を含む CommandResult |
runTimedCmdRetryWithOutputMonitor
public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。また、出力ストリームでアクティビティをモニタリングし、ストリーム アクティビティがない場合は中止する モニタリングします。idleOutputTimeout が 0 に設定されている場合、ストリーム モニタリングは行われません。 発生します。
パラメータ | |
---|---|
timeout |
long : 各試行の最大待機時間(ミリ秒) |
idleOutputTimeout |
long : 出力ストリームでの出力の最大待機時間(ミリ秒) |
retryInterval |
long : コマンド再試行までの待機時間 |
attempts |
int : 試行の最大回数 |
command |
String : 指定されたシステム コマンドと exec 引数(省略可) |
戻り値 | |
---|---|
CommandResult |
コマンド実行の結果を含む CommandResult |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド
あります。runTimedCmd(long, String)
に似ていますが、エラーを記録しません。
発生します。
パラメータ | |
---|---|
timeout |
long : 最大待機時間(ミリ秒) |
command |
String : 指定されたシステム コマンドと exec 引数(省略可) |
戻り値 | |
---|---|
CommandResult |
コマンド実行の結果を含む CommandResult |
runTimedCmdSilentlyRetry
public abstract 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 abstract 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 abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
stdin 入力を必要とするシステム コマンドを実行し、必要に応じて中止するヘルパー メソッド より長い時間を要していることを示します。
パラメータ | |
---|---|
timeout |
long : 最大待機時間(ミリ秒) |
input |
String : プロセスに渡す stdin 入力 |
command |
String : 指定されたシステム コマンドと exec 引数(省略可) |
戻り値 | |
---|---|
CommandResult |
コマンド実行の結果を含む CommandResult |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
stdin 入力を必要とするシステム コマンドを実行し、必要に応じて中止するヘルパー メソッド より長い時間を要していることを示します。
パラメータ | |
---|---|
timeout |
long : 最大待機時間(ミリ秒) |
input |
String : プロセスに渡す stdin 入力 |
command |
: システム コマンドとオプションの exec 引数を含む ERROR(/List) |
戻り値 | |
---|---|
CommandResult |
コマンド実行の結果を含む CommandResult |
runTimedCmdWithInputRedirect
public abstract 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 abstract 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 abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
システム コマンドを実行し、指定された時間よりも時間がかかった場合に中止するヘルパー メソッド あります。また、出力ストリームでアクティビティをモニタリングし、ストリーム アクティビティがない場合は中止する モニタリングします。idleOutputTimeout が 0 に設定されている場合、ストリーム モニタリングは行われません。 発生します。
パラメータ | |
---|---|
timeout |
long : 最大待機時間(ミリ秒)。0 はタイムアウトがないことを意味します。 |
idleOutputTimeout |
long : 出力ストリームでの出力の最大待機時間(ミリ秒) |
command |
String : 指定されたシステム コマンドと exec 引数(省略可) |
戻り値 | |
---|---|
CommandResult |
コマンド実行の結果を含む CommandResult |
runTimedCmdWithOutputMonitor
public abstract 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) 。null の場合もあります。 |
stderr |
OutputStream : エラー出力のリダイレクト先の ERROR(/OutputStream) 。null の場合もあります。 |
cacheClient |
ICacheClient : キャッシュの処理に使用される ICacheClient のインスタンス。 |
command |
String : 指定されたシステム コマンドと exec 引数(省略可)。 |
戻り値 | |
---|---|
CommandResult |
コマンド実行の結果を含む CommandResult 。 |
runTimedRetry
public abstract 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 abstract boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
オペレーションをブロックし、成功するまで複数回実行します。また、 アクティビティの出力ストリーム。指定された時間にわたってストリーム アクティビティが確認されなかった場合は中止します。 emptyOutputTimeout を 0 に設定した場合、ストリームのモニタリングは行われません。
パラメータ | |
---|---|
opTimeout |
long : 1 回のオペレーションの試行の最大待機時間(ミリ秒) |
idleOutputTimeout |
long : 出力ストリームでの出力の最大待機時間(ミリ秒) |
pollInterval |
long : コマンド再試行までの待機時間 |
attempts |
int : 試行の最大回数 |
runnable |
IRunUtil.IRunnableResult : 実行する IRunUtil.IRunnableResult |
戻り値 | |
---|---|
boolean |
試行回数に達する前にオペレーションが正常に完了した場合は true です。 |
runTimedWithOutputMonitor
public abstract CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
オペレーションをブロックして実行し、指定した時間よりも時間がかかる場合は中止します。また、 出力ストリームをモニタリングしてアクティビティの有無を確認し、 表示されます。emptyOutputTimeout を 0 に設定した場合、ストリームのモニタリングは行われません。
パラメータ | |
---|---|
timeout |
long : 最大待機時間(ミリ秒) |
idleOutputTimeout |
long : 出力ストリームでの出力の最大待機時間(ミリ秒) |
runnable |
IRunUtil.IRunnableResult : 実行する IRunUtil.IRunnableResult |
logErrors |
boolean : 例外の発生時にエラーをログに記録します。 |
戻り値 | |
---|---|
CommandStatus |
演算の CommandStatus の結果。 |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
システム コマンドの実行時に使用される環境変数を設定します。
パラメータ | |
---|---|
key |
String : 変数名 |
value |
String : 変数の値 |
setEnvVariablePriority
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
プロセスの作成時に環境変数の設定解除のほうが大きいかどうかを判断する
優先順位を付けることができます
デフォルトでは、設定を解除するほうが優先度が高く、
変数は設定されないため、重複することはありません。
デフォルトの IRunUtil
インスタンスでは使用できません。
パラメータ | |
---|---|
priority |
IRunUtil.EnvPriority |
setInterruptibleInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
一定の待機時間後に割り込み可能として設定される。
ERROR(/CommandScheduler#shutdownHard())
を使用し、最終的に終了するように強制します。
パラメータ | |
---|---|
thread |
Thread : 割り込み可能になるスレッド。 |
timeMs |
long : 割り込み可能に設定するまでの待機時間。 |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Linux の「kill」の使用を許可する#runTimed メソッドで実行中のプロセスの中断が
タイムアウトします。
デフォルトの IRunUtil
インスタンスでは使用できません。
パラメータ | |
---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
システムの実行時に標準出力ストリームにリダイレクトするように標準エラー ストリームを設定する 使用できます。初期値は false です。
パラメータ | |
---|---|
redirect |
boolean : リダイレクトするかどうかの新しい値 |
setWorkingDir
public abstract void setWorkingDir (File dir)
システム コマンドの作業ディレクトリを設定します。
パラメータ | |
---|---|
dir |
File : 作業ディレクトリ |
sleep
public abstract void sleep (long time)
例外を無視して、指定された時間スリープするヘルパー メソッド。
パラメータ | |
---|---|
time |
long : スリープ時間(ミリ秒)。0 以下の値は無視されます。 |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
環境変数の設定を解除して、この環境変数なしでシステム コマンドが実行されるようにします。
パラメータ | |
---|---|
key |
String : 変数名 |