IRunUtil
public interface IRunUtil
com.android.tradefed.util.IRunUtil |
Antarmuka untuk menjalankan operasi berwaktu dan perintah sistem.
Ringkasan
Kelas bersarang | |
---|---|
interface | IRunUtil.IRunnableResult Antarmuka untuk menjalankan operasi secara asinkron yang mengembalikan status boolean. |
Metode publik | |
---|---|
abstract void | allowInterrupt (boolean allow) Mengizinkan/melarang menjalankan interupsi pada thread saat ini. |
abstract void | interrupt (Thread thread, String message, ErrorIdentifier errorId) Mengganggu operasi yang sedang berjalan/akan datang pada thread tertentu. |
abstract void | interrupt (Thread thread, String message) Mengganggu operasi yang sedang berjalan/akan datang pada thread tertentu. |
abstract boolean | isInterruptAllowed () Berikan status interupsi pada RunUtil. |
abstract Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Metode |
abstract Process | runCmdInBackground ( command) runCmdInBackground ( command) Metode |
abstract Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) Menjalankan perintah dengan |
abstract Process | runCmdInBackground (String... command) Metode pembantu untuk menjalankan perintah sistem secara asinkron. |
abstract Process | runCmdInBackground (Redirect redirect, String... command) Metode pembantu untuk menjalankan perintah sistem secara asinkron. |
abstract boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokir dan jalankan operasi beberapa kali hingga berhasil. |
abstract boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokir dan jalankan operasi beberapa kali hingga berhasil. |
abstract CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Blokir dan jalankan operasi, batalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
abstract CommandResult | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) Metode pembantu untuk menjalankan perintah sistem, batalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan, dan arahkan output ke file jika ditentukan. |
abstract CommandResult | runTimedCmd (long timeout, String... command) Metode pembantu untuk menjalankan perintah sistem, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
abstract CommandResult | runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command) Metode pembantu untuk menjalankan perintah sistem, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
abstract CommandResult | runTimedCmdSilently (long timeout, String... command) Metode pembantu untuk menjalankan perintah sistem, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
abstract CommandResult | runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command) Metode pembantu untuk menjalankan perintah sistem, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) Metode pembantu untuk menjalankan perintah sistem, batalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan, dan arahkan output ke file jika ditentukan. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) Metode pembantu untuk menjalankan perintah sistem yang memerlukan input stdin, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) Metode pembantu untuk menjalankan perintah sistem yang memerlukan input stdin, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
abstract CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) Metode pembantu untuk menjalankan perintah sistem yang memerlukan pengalihan Stdin dari file, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. |
abstract boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blokir dan jalankan operasi beberapa kali hingga berhasil. |
abstract void | setEnvVariable (String key, String value) Menetapkan variabel lingkungan yang akan digunakan saat menjalankan perintah sistem. |
abstract void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Putuskan apakah saat membuat suatu proses, menghapus pengaturan variabel lingkungan adalah prioritas yang lebih tinggi daripada mengaturnya. |
abstract void | setInterruptibleInFuture (Thread thread, long timeMs) Tetapkan sebagai interupsi setelah beberapa waktu tunggu. |
abstract void | setLinuxInterruptProcess (boolean interrupt) Izinkan untuk menggunakan interupsi 'kill' linux pada proses yang berjalan melalui metode #runTimed ketika mencapai batas waktu. |
abstract void | setRedirectStderrToStdout (boolean redirect) Atur aliran kesalahan standar untuk mengalihkan ke aliran keluaran standar saat menjalankan perintah sistem. |
abstract void | setWorkingDir (File dir) Menetapkan direktori kerja untuk perintah sistem. |
abstract void | sleep (long time) Metode pembantu untuk tidur pada waktu tertentu, mengabaikan pengecualian apa pun. |
abstract void | unsetEnvVariable (String key) Membatalkan variabel lingkungan, sehingga perintah sistem berjalan tanpa variabel lingkungan ini. |
Metode publik
izinkan Interupsi
public abstract void allowInterrupt (boolean allow)
Mengizinkan/melarang menjalankan interupsi pada thread saat ini. Jika diperbolehkan, operasi yang dijalankan pada thread saat ini dapat diinterupsi dari thread lain melalui metode interrupt(Thread, String)
.
Parameter | |
---|---|
allow | boolean : apakah akan mengizinkan interupsi dijalankan pada thread saat ini. |
mengganggu
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Mengganggu operasi yang sedang berjalan/akan datang pada thread tertentu. Operasi yang dijalankan pada thread tertentu akan memunculkan RunInterruptedException
.
Parameter | |
---|---|
message | String : pesan untuk RunInterruptedException . |
errorId | ErrorIdentifier : Mewakili penyebab gangguan ketika diketahui. |
mengganggu
public abstract void interrupt (Thread thread, String message)
Mengganggu operasi yang sedang berjalan/akan datang pada thread tertentu. Operasi yang dijalankan pada thread tertentu akan memunculkan RunInterruptedException
.
Parameter | |
---|---|
message | String : pesan untuk RunInterruptedException . |
adalah InterruptAllowed
public abstract boolean isInterruptAllowed ()
Berikan status interupsi pada RunUtil.
Kembali | |
---|---|
boolean | benar jika Proses dapat dihentikan, salah jika sebaliknya. |
jalankanCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
Metode runCmdInBackground(String)
alternatif yang menerima argumen perintah dalam bentuk ERROR(/List)
.
Parameter | |
---|---|
redirect | Redirect : ERROR(/Redirect) yang diterapkan pada ProcessBuilder . |
command | ERROR(/List) yang berisi perintah sistem tertentu dan argumen opsional untuk exec |
Kembali | |
---|---|
Process | Process dari perintah yang dieksekusi |
Melempar | |
---|---|
| jika perintah gagal dijalankan |
jalankanCmdInBackground
public abstract Process runCmdInBackground (command)
Metode runCmdInBackground(String)
alternatif yang menerima argumen perintah dalam bentuk ERROR(/List)
.
Parameter | |
---|---|
command | ERROR(/List) yang berisi perintah sistem tertentu dan argumen opsional untuk exec |
Kembali | |
---|---|
Process | Process dari perintah yang dieksekusi |
Melempar | |
---|---|
| jika perintah gagal dijalankan |
jalankanCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
Menjalankan perintah dengan ERROR(/OutputStream)
mencatat output dari perintah. Stdout dan stderr digabungkan menjadi satu.
Parameter | |
---|---|
command | |
output | OutputStream : OutputStream untuk menyimpan output |
Kembali | |
---|---|
Process | Process menjalankan perintah |
Melempar | |
---|---|
| Pengecualian IO |
jalankanCmdInBackground
public abstract Process runCmdInBackground (String... command)
Metode pembantu untuk menjalankan perintah sistem secara asinkron.
Akan kembali segera setelah meluncurkan perintah.
Parameter | |
---|---|
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
Process | Process dari perintah yang dieksekusi |
Melempar | |
---|---|
| jika perintah gagal dijalankan |
jalankanCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
Metode pembantu untuk menjalankan perintah sistem secara asinkron.
Akan kembali segera setelah meluncurkan perintah.
Parameter | |
---|---|
redirect | Redirect : ERROR(/Redirect) yang diterapkan pada ProcessBuilder . |
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
Process | Process dari perintah yang dieksekusi |
Melempar | |
---|---|
| jika perintah gagal dijalankan |
jalankanEscalatingTimedCoba lagi
public abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokir dan jalankan operasi beberapa kali hingga berhasil.
Meningkatkan waktu tunggu antar upaya operasi secara eksponensial. Hal ini dimaksudkan untuk digunakan ketika melakukan operasi seperti polling server, untuk memberikan waktu pemulihan jika server sedang down untuk sementara.Parameter | |
---|---|
opTimeout | long : waktu tunggu maksimum dalam ms untuk satu upaya operasi |
initialPollInterval | long : waktu tunggu awal di antara upaya operasi |
maxPollInterval | long : waktu tunggu maksimum di antara upaya operasi |
maxTime | long : total perkiraan waktu maksimum untuk terus mencoba operasi |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult untuk dijalankan |
Kembali | |
---|---|
boolean | true jika operasi berhasil diselesaikan sebelum maxTime kedaluwarsa |
jalankanFixedTimedCoba lagi
public abstract boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokir dan jalankan operasi beberapa kali hingga berhasil.
Parameter | |
---|---|
opTimeout | long : waktu tunggu maksimum dalam ms untuk satu upaya operasi |
pollInterval | long : waktu tunggu awal di antara upaya operasi |
maxTime | long : total perkiraan waktu maksimum untuk terus mencoba operasi |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult untuk dijalankan |
Kembali | |
---|---|
boolean | true jika operasi berhasil diselesaikan sebelum maxTime kedaluwarsa |
waktu berjalan
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokir dan jalankan operasi, batalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
Parameter | |
---|---|
timeout | long : waktu maksimum untuk menunggu dalam ms |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult untuk dijalankan |
logErrors | boolean : mencatat kesalahan pada pengecualian atau tidak. |
Kembali | |
---|---|
CommandStatus | hasil operasi CommandStatus . |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metode pembantu untuk menjalankan perintah sistem, batalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan, dan arahkan output ke file jika ditentukan. Jika ERROR(/OutputStream)
diberikan dengan cara ini, maka ERROR(/OutputStream) akan dibiarkan terbuka di akhir fungsi.
Parameter | |
---|---|
timeout | long : batas waktu maksimum untuk menunggu dalam ms. 0 berarti tidak ada batas waktu. |
stdout | OutputStream : ERROR(/OutputStream) di mana keluaran std akan dialihkan. Bisa jadi nol. |
stderr | OutputStream : ERROR(/OutputStream) dimana keluaran kesalahan akan dialihkan. Bisa jadi nol. |
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Metode pembantu untuk menjalankan perintah sistem, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
Parameter | |
---|---|
timeout | long : waktu maksimum untuk menunggu dalam ms. 0 berarti tidak ada batas waktu. |
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdCoba lagi
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Metode pembantu untuk menjalankan perintah sistem, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
Parameter | |
---|---|
timeout | long : waktu tunggu maksimum dalam ms untuk setiap upaya |
retryInterval | long : waktu menunggu di antara percobaan ulang perintah |
attempts | int : jumlah maksimum percobaan yang dilakukan |
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdDiam-diam
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Metode pembantu untuk menjalankan perintah sistem, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. Mirip dengan runTimedCmd(long, String)
, tetapi tidak mencatat kesalahan apa pun pada pengecualian.
Parameter | |
---|---|
timeout | long : waktu maksimum untuk menunggu dalam ms |
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdSilentlyCoba lagi
public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Metode pembantu untuk menjalankan perintah sistem, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan. Mirip dengan runTimedCmdRetry(long, long, int, String[])
, tetapi tidak mencatat kesalahan apa pun pada pengecualian.
Parameter | |
---|---|
timeout | long : waktu maksimum untuk menunggu dalam ms |
retryInterval | long : waktu menunggu di antara percobaan ulang perintah |
attempts | int : jumlah maksimum percobaan yang dilakukan |
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metode pembantu untuk menjalankan perintah sistem, batalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan, dan arahkan output ke file jika ditentukan.
Parameter | |
---|---|
timeout | long : batas waktu maksimum untuk menunggu dalam ms. 0 berarti tidak ada batas waktu. |
input | String : input stdin yang akan diteruskan ke proses |
stdoutFile | File : ERROR(/File) dimana output std akan dialihkan. Bisa jadi nol. |
stderrFile | File : ERROR(/File) dimana keluaran kesalahan akan dialihkan. Bisa jadi nol. |
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Metode pembantu untuk menjalankan perintah sistem yang memerlukan input stdin, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
Parameter | |
---|---|
timeout | long : waktu maksimum untuk menunggu dalam ms |
input | String : input stdin yang akan diteruskan ke proses |
command | String : perintah sistem yang ditentukan dan argumen opsional untuk exec |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
Metode pembantu untuk menjalankan perintah sistem yang memerlukan input stdin, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
Parameter | |
---|---|
timeout | long : waktu maksimum untuk menunggu dalam ms |
input | String : input stdin yang akan diteruskan ke proses |
command | ERROR(/List) berisi perintah sistem dan argumen opsional untuk exec |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Metode pembantu untuk menjalankan perintah sistem yang memerlukan pengalihan Stdin dari file, dan dibatalkan jika memerlukan waktu lebih lama dari waktu yang ditentukan.
Parameter | |
---|---|
timeout | long : waktu maksimum untuk menunggu dalam ms |
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 |
Kembali | |
---|---|
CommandResult | sebuah CommandResult yang berisi hasil dari perintah yang dijalankan |
runTimedCoba lagi
public abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokir dan jalankan operasi beberapa kali hingga berhasil.
Parameter | |
---|---|
opTimeout | long : waktu tunggu maksimum dalam ms untuk satu upaya operasi |
pollInterval | long : waktu menunggu di antara percobaan ulang perintah |
attempts | int : jumlah maksimum percobaan yang dilakukan |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult untuk dijalankan |
Kembali | |
---|---|
boolean | true jika operasi berhasil diselesaikan sebelum upaya tercapai. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
Menetapkan variabel lingkungan yang akan digunakan saat menjalankan perintah sistem.
Parameter | |
---|---|
key | String : nama variabel |
value | String : nilai variabel |
Lihat juga:
setEnvVariablePrioritas
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Putuskan apakah saat membuat suatu proses, menghapus pengaturan variabel lingkungan adalah prioritas yang lebih tinggi daripada mengaturnya. Secara Default, penghapusan setelan adalah prioritas yang lebih tinggi: artinya jika dilakukan upaya untuk menyetel variabel dengan nama yang sama, hal ini tidak akan terjadi karena variabel tersebut tidak disetel. Tidak dapat digunakan pada instans IRunUtil
default.
Parameter | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
Tetapkan sebagai interupsi setelah beberapa waktu tunggu. ERROR(/CommandScheduler#shutdownHard())
yang akan kami terapkan pada akhirnya akan kami hentikan.
Parameter | |
---|---|
thread | Thread : thread yang akan menjadi interupsi. |
timeMs | long : waktu menunggu sebelum menyetel interupsi. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Izinkan untuk menggunakan interupsi 'kill' linux pada proses yang berjalan melalui metode #runTimed ketika mencapai batas waktu. Tidak dapat digunakan pada instans IRunUtil
default.
Parameter | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
Atur aliran kesalahan standar untuk mengalihkan ke aliran keluaran standar saat menjalankan perintah sistem. Nilai awal salah.
Parameter | |
---|---|
redirect | boolean : nilai baru untuk mengalihkan atau tidak |
Lihat juga:
setWorkingDir
public abstract void setWorkingDir (File dir)
Menetapkan direktori kerja untuk perintah sistem.
Parameter | |
---|---|
dir | File : direktori kerja |
Lihat juga:
tidur
public abstract void sleep (long time)
Metode pembantu untuk tidur pada waktu tertentu, mengabaikan pengecualian apa pun.
Parameter | |
---|---|
time | long : ms untuk tidur. nilai yang kurang dari atau sama dengan 0 akan diabaikan |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Membatalkan variabel lingkungan, sehingga perintah sistem berjalan tanpa variabel lingkungan ini.
Parameter | |
---|---|
key | String : nama variabel |
Lihat juga:
Konten dan contoh kode di halaman ini tunduk pada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2023-12-01 UTC.