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 runCmdInBackground(String) alternatif yang menerima argumen perintah dalam bentuk ERROR(/List) .

abstract Process runCmdInBackground ( command) runCmdInBackground ( command)

Metode runCmdInBackground(String) alternatif yang menerima argumen perintah dalam bentuk ERROR(/List) .

abstract Process runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output)

Menjalankan perintah dengan ERROR(/OutputStream) mencatat output dari perintah.

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 : perintah untuk dijalankan

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

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

setWorkingDir

public abstract void setWorkingDir (File dir)

Menetapkan direktori kerja untuk perintah sistem.

Parameter
dir File : direktori kerja

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