RunUtil
public
class
RunUtil
extends Object
implements
IRunUtil
| java.lang.Object | |
| ↳ | com.android.tradefed.util.RunUtil |
Kumpulan metode pembantu untuk menjalankan operasi.
Ringkasan
Konstanta | |
|---|---|
String |
INHERITIO_PREFIX
|
String |
RUNNABLE_NOTIFIER_NAME
|
Konstruktor publik | |
|---|---|
RunUtil()
Buat objek |
|
RunUtil(boolean inheritEnvVars)
|
|
Metode publik | |
|---|---|
void
|
allowInterrupt(boolean allow)
Mengizinkan/tidak mengizinkan interupsi eksekusi pada thread saat ini. |
ProcessBuilder
|
createProcessBuilder(Redirect redirect,
|
static
IRunUtil
|
getDefault()
Dapatkan referensi ke objek |
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Menginterupsi operasi run yang sedang/akan berlangsung pada thread tertentu. |
void
|
interrupt(Thread thread, String message)
Menginterupsi operasi run yang sedang/akan berlangsung pada thread tertentu. |
boolean
|
isInterruptAllowed()
Memberikan status interupsi RunUtil. |
Process
|
runCmdInBackground(Redirect redirect,
Metode |
Process
|
runCmdInBackground(
Metode |
Process
|
runCmdInBackground(
Menjalankan perintah dengan |
Process
|
runCmdInBackground(String... command)
Metode helper untuk menjalankan perintah sistem secara asinkron. |
Process
|
runCmdInBackground(Redirect redirect, String... command)
Metode helper untuk menjalankan perintah sistem secara asinkron. |
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil. |
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil. |
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil. |
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Memblokir dan menjalankan operasi, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metode helper untuk menjalankan perintah sistem, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan, dan mengalihkan output ke file jika ditentukan. |
CommandResult
|
runTimedCmd(long timeout, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metode helper untuk menjalankan perintah sistem, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan, dan mengalihkan output ke file jika ditentukan. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Metode helper untuk menjalankan perintah sistem yang memerlukan input stdin, dan membatalkan jika membutuhkan waktu lebih lama dari waktu yang ditentukan. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
Metode helper untuk menjalankan perintah sistem yang memerlukan input stdin, dan membatalkan jika membutuhkan waktu lebih lama dari waktu yang ditentukan. |
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Metode helper untuk menjalankan perintah sistem yang memerlukan pengalihan Stdin dari file, dan membatalkan jika memerlukan waktu lebih lama dari yang ditentukan. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Metode helper untuk menjalankan perintah sistem, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan, dan mengalihkan output ke file jika ditentukan. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil. |
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil. |
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Memblokir dan menjalankan operasi, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
void
|
setEnvVariable(String name, String value)
Menetapkan variabel lingkungan yang akan digunakan saat menjalankan perintah sistem. |
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Tentukan apakah saat membuat proses, menghapus setelan variabel lingkungan memiliki prioritas yang lebih tinggi daripada menyetelnya. |
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Ditetapkan sebagai dapat diinterupsi setelah beberapa waktu menunggu. |
void
|
setLinuxInterruptProcess(boolean interrupt)
Izinkan penggunaan interupsi 'kill' linux pada proses yang berjalan melalui metode #runTimed saat mencapai waktu tunggu. |
void
|
setRedirectStderrToStdout(boolean redirect)
Menetapkan aliran error standar untuk dialihkan ke aliran output standar saat menjalankan perintah sistem. |
void
|
setWorkingDir(File dir)
Menetapkan direktori kerja untuk perintah sistem. |
void
|
sleep(long time)
Metode helper untuk tidur selama waktu tertentu, mengabaikan pengecualian apa pun. |
void
|
unsetEnvVariable(String key)
Membatalkan setelan variabel lingkungan, sehingga perintah sistem berjalan tanpa variabel lingkungan ini.
Variabel lingkungan dapat diwarisi dari proses induk, jadi kita perlu menghapus
variabel lingkungan dari |
Konstanta
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
Nilai Konstanta: "inheritio-"
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
Nilai Konstanta: "RunnableNotifier"
Konstruktor publik
RunUtil
public RunUtil (boolean inheritEnvVars)
| Parameter | |
|---|---|
inheritEnvVars |
boolean |
Metode publik
allowInterrupt
public void allowInterrupt (boolean allow)
Mengizinkan/tidak mengizinkan interupsi eksekusi pada thread saat ini. Jika diizinkan, operasi
thread saat ini dapat terganggu dari thread lain melalui metode interrupt(Thread, String).
| Parameter | |
|---|---|
allow |
boolean: apakah akan mengizinkan interupsi run pada thread saat ini. |
createProcessBuilder
public ProcessBuilder createProcessBuilder (Redirect redirect,
commandList,
boolean enableCache) | Parameter | |
|---|---|
redirect |
Redirect |
commandList |
|
enableCache |
boolean |
| Hasil | |
|---|---|
ProcessBuilder |
|
getDefault
public static IRunUtil getDefault ()
Dapatkan referensi ke objek RunUtil default.
Hal ini berguna bagi pemanggil yang ingin menggunakan IRunUtil tanpa penyesuaian.
Sebaiknya pemanggil yang memerlukan instance IRunUtil kustom
(yaitu perlu memanggil setEnvVariable(String, String) atau
setWorkingDir(File)) membuat salinannya sendiri.
| Hasil | |
|---|---|
IRunUtil |
|
mengganggu
public void interrupt (Thread thread,
String message,
ErrorIdentifier errorId)Menginterupsi operasi run yang sedang/akan berlangsung pada thread tertentu. Operasi yang dijalankan pada thread tertentu akan memunculkan RunInterruptedException.
| Parameter | |
|---|---|
message |
String: pesan untuk RunInterruptedException. |
errorId |
ErrorIdentifier: Mewakili penyebab gangguan jika diketahui. |
mengganggu
public void interrupt (Thread thread,
String message)Menginterupsi operasi run yang sedang/akan berlangsung pada thread tertentu. Operasi yang dijalankan pada thread tertentu akan memunculkan RunInterruptedException.
| Parameter | |
|---|---|
message |
String: pesan untuk RunInterruptedException. |
isInterruptAllowed
public boolean isInterruptAllowed ()
Memberikan status interupsi RunUtil.
| Hasil | |
|---|---|
boolean |
benar jika Run dapat diinterupsi, salah jika tidak. |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect,
command) Metode runCmdInBackground(String) alternatif yang menerima argumen perintah
dalam bentuk ERROR(/List).
| Parameter | |
|---|---|
redirect |
Redirect: ERROR(/Redirect) yang akan diterapkan ke ProcessBuilder. |
command |
: ERROR(/List) yang berisi perintah sistem yang ditentukan dan argumen opsional
untuk dieksekusi |
| Hasil | |
|---|---|
Process |
Process perintah yang dijalankan |
runCmdInBackground
public Process runCmdInBackground (command)
Metode runCmdInBackground(String) alternatif yang menerima argumen perintah
dalam bentuk ERROR(/List).
| Parameter | |
|---|---|
command |
: ERROR(/List) yang berisi perintah sistem yang ditentukan dan argumen opsional
untuk exec |
| Hasil | |
|---|---|
Process |
Process perintah yang dijalankan |
runCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Menjalankan perintah dengan ERROR(/OutputStream) akan mencatat output perintah.
Stdout dan stderr digabungkan.
| Parameter | |
|---|---|
command |
: perintah yang akan dijalankan |
output |
OutputStream: OutputStream untuk menyimpan output |
| Hasil | |
|---|---|
Process |
Process menjalankan perintah |
runCmdInBackground
public Process runCmdInBackground (String... command)
Metode helper untuk menjalankan perintah sistem secara asinkron.
Akan segera ditampilkan setelah meluncurkan perintah.
| Parameter | |
|---|---|
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
Process |
Process perintah yang dijalankan |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect,
String... command)Metode helper untuk menjalankan perintah sistem secara asinkron.
Akan segera ditampilkan setelah meluncurkan perintah.
| Parameter | |
|---|---|
redirect |
Redirect: ERROR(/Redirect) yang akan diterapkan ke ProcessBuilder. |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
Process |
Process perintah yang dijalankan |
runEscalatingTimedRetry
public boolean runEscalatingTimedRetry (long opTimeout,
long initialPollInterval,
long maxPollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil.
Tingkatkan waktu tunggu antara upaya operasi secara eksponensial. Hal ini dimaksudkan untuk digunakan saat melakukan operasi seperti polling server, untuk memberikan waktu pemulihan jika server tidak berfungsi sementara.
| Parameter | |
|---|---|
opTimeout |
long: waktu maksimum untuk menunggu dalam ms untuk satu upaya operasi |
initialPollInterval |
long: waktu awal untuk menunggu di antara upaya operasi |
maxPollInterval |
long: waktu tunggu maksimum antara upaya operasi |
maxTime |
long: total perkiraan waktu maksimum untuk terus mencoba operasi |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult untuk dieksekusi |
| Hasil | |
|---|---|
boolean |
true jika operasi berhasil diselesaikan sebelum maxTime berakhir |
runFixedTimedRetry
public boolean runFixedTimedRetry (long opTimeout,
long pollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil.
| Parameter | |
|---|---|
opTimeout |
long: waktu maksimum untuk menunggu dalam ms untuk satu upaya operasi |
pollInterval |
long: waktu awal untuk menunggu di antara upaya operasi |
maxTime |
long: total perkiraan waktu maksimum untuk terus mencoba operasi |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult untuk dieksekusi |
| Hasil | |
|---|---|
boolean |
true jika operasi berhasil diselesaikan sebelum maxTime berakhir |
runFixedTimedRetryWithOutputMonitor
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout,
long idleOutputTimeout,
long pollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil. Juga memantau aliran output untuk aktivitas, membatalkan jika tidak ada aktivitas streaming yang diamati selama waktu tertentu. Jika idleOutputTimeout disetel ke nol, tidak ada pemantauan streaming yang akan terjadi.
| Parameter | |
|---|---|
opTimeout |
long: waktu maksimum untuk menunggu dalam ms untuk satu upaya operasi |
idleOutputTimeout |
long: waktu maksimum untuk menunggu output dalam ms pada aliran output |
pollInterval |
long: waktu awal untuk menunggu di antara upaya operasi |
maxTime |
long: total perkiraan waktu maksimum untuk terus mencoba operasi |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult untuk dieksekusi |
| Hasil | |
|---|---|
boolean |
true jika operasi berhasil diselesaikan sebelum maxTime berakhir |
runTimed
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Memblokir dan menjalankan operasi, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult untuk dieksekusi |
logErrors |
boolean: mencatat error pada pengecualian atau tidak. |
| Hasil | |
|---|---|
CommandStatus |
hasil operasi CommandStatus. |
runTimedCmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metode helper untuk menjalankan perintah sistem, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan,
dan mengalihkan output ke file jika ditentukan. Jika ERROR(/OutputStream) diberikan dengan cara ini, ERROR(/OutputStream) akan tetap terbuka di akhir fungsi.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md. 0 berarti tidak ada waktu tunggu. |
stdout |
OutputStream: ERROR(/OutputStream) tempat output std akan dialihkan. Dapat ditetapkan ke null. |
stderr |
OutputStream: ERROR(/OutputStream) tempat output error akan dialihkan. Dapat ditetapkan ke null. |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmd
public CommandResult runTimedCmd (long timeout, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md. 0 berarti tidak ada waktu tunggu. |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdRetry
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam ms untuk setiap percobaan |
retryInterval |
long: waktu tunggu di antara percobaan ulang perintah |
attempts |
int: jumlah maksimum percobaan yang akan dicoba |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdRetryWithOutputMonitor
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. Juga memantau aktivitas aliran output, membatalkan jika tidak ada aktivitas aliran yang diamati selama waktu yang ditentukan. Jika idleOutputTimeout disetel ke nol, tidak ada pemantauan streaming yang akan terjadi.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam ms untuk setiap percobaan |
idleOutputTimeout |
long: waktu maksimum untuk menunggu output dalam ms pada aliran output |
retryInterval |
long: waktu tunggu di antara percobaan ulang perintah |
attempts |
int: jumlah maksimum percobaan yang akan dicoba |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdSilently
public CommandResult runTimedCmdSilently (long timeout, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. Serupa dengan runTimedCmd(long, String), tetapi tidak mencatat error apa pun pada
pengecualian.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdSilentlyRetry
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. Serupa dengan runTimedCmdRetry(long, long, int, String[]),
tetapi tidak mencatat error apa pun pada pengecualian.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md |
retryInterval |
long: waktu tunggu di antara percobaan ulang perintah |
attempts |
int: jumlah maksimum percobaan yang akan dicoba |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metode helper untuk menjalankan perintah sistem, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan, dan mengalihkan output ke file jika ditentukan.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md. 0 berarti tidak ada waktu tunggu. |
input |
String: input stdin yang akan diteruskan ke proses |
stdoutFile |
File: ERROR(/File) tempat output std akan dialihkan. Dapat ditetapkan ke null. |
stderrFile |
File: ERROR(/File) tempat output error akan dialihkan. Dapat ditetapkan ke null. |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Metode helper untuk menjalankan perintah sistem yang memerlukan input stdin, dan membatalkan jika membutuhkan waktu lebih lama dari waktu yang ditentukan.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md |
input |
String: input stdin yang akan diteruskan ke proses |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
Metode helper untuk menjalankan perintah sistem yang memerlukan input stdin, dan membatalkan jika membutuhkan waktu lebih lama dari waktu yang ditentukan.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md |
input |
String: input stdin yang akan diteruskan ke proses |
command |
: ERROR(/List) yang berisi perintah sistem dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Metode helper untuk menjalankan perintah sistem yang memerlukan pengalihan Stdin dari file, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md |
inputRedirect |
File: ERROR(/File) yang akan dialihkan sebagai input standar menggunakan ProcessBuilder.redirectInput(). Jika null, stdin tidak akan dialihkan. |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Metode helper untuk menjalankan perintah sistem, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan,
dan mengalihkan output ke file jika ditentukan. Jika ERROR(/OutputStream) diberikan dengan cara ini, ERROR(/OutputStream) akan tetap terbuka di akhir fungsi.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md. 0 berarti tidak ada waktu tunggu. |
idleOutputTimeout |
long: waktu maksimum untuk menunggu output dalam ms pada aliran output |
stdout |
OutputStream: ERROR(/OutputStream) tempat output std akan dialihkan. Dapat ditetapkan ke null. |
stderr |
OutputStream: ERROR(/OutputStream) tempat output error akan dialihkan. Dapat ditetapkan ke null. |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Metode helper untuk menjalankan perintah sistem, dan membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. Juga memantau aktivitas aliran output, membatalkan jika tidak ada aktivitas aliran yang diamati selama waktu yang ditentukan. Jika idleOutputTimeout disetel ke nol, tidak ada pemantauan streaming yang akan terjadi.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md. 0 berarti tidak ada waktu tunggu. |
idleOutputTimeout |
long: waktu maksimum untuk menunggu output dalam ms pada aliran output |
command |
String: perintah sistem yang ditentukan dan argumen opsional untuk exec |
| Hasil | |
|---|---|
CommandResult |
CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedRetry
public boolean runTimedRetry (long opTimeout,
long pollInterval,
int attempts,
IRunUtil.IRunnableResult runnable)Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil.
| Parameter | |
|---|---|
opTimeout |
long: waktu maksimum untuk menunggu dalam ms untuk satu upaya operasi |
pollInterval |
long: waktu tunggu di antara percobaan ulang perintah |
attempts |
int: jumlah maksimum percobaan yang akan dicoba |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult untuk dieksekusi |
| Hasil | |
|---|---|
boolean |
true jika operasi berhasil diselesaikan sebelum upaya mencapai batas. |
runTimedRetryWithOutputMonitor
public boolean runTimedRetryWithOutputMonitor (long opTimeout,
long idleOutputTimeout,
long pollInterval,
int attempts,
IRunUtil.IRunnableResult runnable)Memblokir dan mengeksekusi operasi beberapa kali hingga berhasil. Juga memantau aliran output untuk aktivitas, membatalkan jika tidak ada aktivitas streaming yang diamati selama waktu tertentu. Jika idleOutputTimeout disetel ke nol, tidak ada pemantauan streaming yang akan terjadi.
| Parameter | |
|---|---|
opTimeout |
long: waktu maksimum untuk menunggu dalam ms untuk satu upaya operasi |
idleOutputTimeout |
long: waktu maksimum untuk menunggu output dalam ms pada aliran output |
pollInterval |
long: waktu tunggu di antara percobaan ulang perintah |
attempts |
int: jumlah maksimum percobaan yang akan dicoba |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult untuk dieksekusi |
| Hasil | |
|---|---|
boolean |
true jika operasi berhasil diselesaikan sebelum upaya mencapai batas. |
runTimedWithOutputMonitor
public CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Memblokir dan menjalankan operasi, membatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. Selain itu, memantau aliran output untuk aktivitas, membatalkan jika tidak ada aktivitas streaming yang diamati selama waktu yang ditentukan. Jika idleOutputTimeout disetel ke nol, tidak ada pemantauan streaming yang akan terjadi.
| Parameter | |
|---|---|
timeout |
long: waktu tunggu maksimum dalam md |
idleOutputTimeout |
long: waktu maksimum untuk menunggu output dalam ms pada aliran output |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult untuk dieksekusi |
logErrors |
boolean: mencatat error pada pengecualian atau tidak. |
| Hasil | |
|---|---|
CommandStatus |
hasil operasi CommandStatus. |
setEnvVariable
public void setEnvVariable (String name,
String value)Menetapkan variabel lingkungan yang akan digunakan saat menjalankan perintah sistem.
| Parameter | |
|---|---|
name |
String: nama variabel |
value |
String: nilai variabel |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Tentukan apakah saat membuat proses, menghapus setelan variabel lingkungan memiliki prioritas yang lebih tinggi daripada menyetelnya.
Secara Default, penghapusan setelan memiliki prioritas yang lebih tinggi: artinya jika upaya untuk menyetel variabel dengan
nama yang sama dilakukan, hal itu tidak akan terjadi karena variabel akan dihapus setelannya.
Tidak dapat digunakan pada instance IRunUtil default.
| Parameter | |
|---|---|
priority |
IRunUtil.EnvPriority |
setInterruptibleInFuture
public void setInterruptibleInFuture (Thread thread,
long timeMs)Ditetapkan sebagai dapat diinterupsi setelah beberapa waktu menunggu.
ERROR(/CommandScheduler#shutdownHard()) untuk memastikan kita akhirnya mengakhiri.
| Parameter | |
|---|---|
thread |
Thread: thread yang akan dapat diinterupsi. |
timeMs |
long: waktu untuk menunggu sebelum dapat diinterupsi. |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
Izinkan penggunaan interupsi 'kill' linux pada proses yang berjalan melalui metode #runTimed saat mencapai waktu tunggu.
Tidak dapat digunakan pada instance IRunUtil default.
| Parameter | |
|---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
Menetapkan aliran error standar untuk dialihkan ke aliran output standar saat menjalankan perintah sistem. Nilai awal adalah salah (false).
| Parameter | |
|---|---|
redirect |
boolean: nilai baru untuk menentukan apakah akan mengalihkan atau tidak |
setWorkingDir
public void setWorkingDir (File dir)
Menetapkan direktori kerja untuk perintah sistem.
| Parameter | |
|---|---|
dir |
File: direktori kerja |
sleep
public void sleep (long time)
Metode helper untuk tidur selama waktu tertentu, mengabaikan pengecualian apa pun.
| Parameter | |
|---|---|
time |
long: ms untuk tidur. Nilai yang kurang dari atau sama dengan 0 akan diabaikan |
unsetEnvVariable
public void unsetEnvVariable (String key)
Membatalkan setelan variabel lingkungan, sehingga perintah sistem berjalan tanpa variabel lingkungan ini.
Variabel lingkungan dapat diwarisi dari proses induk, jadi kita perlu menghapus
variabel lingkungan dari ProcessBuilder.environment()
| Parameter | |
|---|---|
key |
String: nama variabel |
Lihat juga: