ICommandScheduler
public interface ICommandScheduler
com.android.tradefed.command.ICommandScheduler |
Penjadwal untuk menjalankan perintah TradeFederation.
Ringkasan
Kelas bersarang | |
---|---|
interface | ICommandScheduler.IScheduledInvocationListener Pendengar untuk acara pemanggilan saat pemanggilan selesai. |
Metode publik | |
---|---|
abstract Pair <Boolean, Integer> | addCommand (String[] args) Menambahkan perintah ke penjadwal. |
abstract void | addCommandFile (String cmdFile, extraArgs) addCommandFile (String cmdFile, extraArgs) Menambahkan semua perintah dari file yang diberikan ke penjadwal |
abstract void | await () Menunggu scheduler mulai berjalan, termasuk menunggu handover dari TF lama hingga selesai jika ada. |
abstract void | displayCommandQueue (PrintWriter printWriter) Keluarkan info debug terperinci tentang keadaan antrian eksekusi perintah. |
abstract void | displayCommandsInfo (PrintWriter printWriter, String regex) Keluarkan daftar perintah saat ini. |
abstract void | displayInvocationsInfo (PrintWriter printWriter) Menampilkan daftar doa saat ini. |
abstract void | dumpCommandsXml (PrintWriter printWriter, String regex) Buang file xml yang diperluas untuk perintah dengan semua nilai |
abstract long | execCommand ( IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args) Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrean perintah menggunakan |
abstract long | execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args) Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrean perintah. |
abstract long | execCommand ( ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args) execCommand ( ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args) Jalankan perintah secara langsung pada perangkat yang sudah dialokasikan. |
abstract CommandFileWatcher | getCommandFileWatcher () Dapatkan |
abstract int | getExecutingCommandCount () Mengembalikan jumlah Perintah dalam status eksekusi. |
abstract String | getInvocationInfo (int invocationId) Kembalikan informasi pada pemanggilan bu yang menentukan id pemanggilan. |
abstract CommandRunner.ExitCode | getLastInvocationExitCode () Kembalikan kode kesalahan dari pemanggilan terakhir yang berjalan. |
abstract Throwable | getLastInvocationThrowable () Kembalikan |
abstract int | getReadyCommandCount () Mengembalikan jumlah Perintah dalam status siap dalam antrean. |
abstract boolean | isDeviceInInvocationThread ( ITestDevice device) Mengembalikan nilai true jika perangkat digunakan oleh utas pemanggilan aktif. |
abstract void | join () Menunggu penjadwal selesai. |
abstract void | join (long millis) Menunggu penjadwal selesai atau waktu habis setelah durasi yang ditentukan dalam milidetik. |
abstract void | removeAllCommands () Hapus semua perintah dari penjadwal |
abstract void | setClearcutClient (ClearcutClient client) Atur klien untuk melaporkan data harness |
abstract boolean | shouldShutdownOnCmdfileError () Kembalikan true jika kita perlu mematikan penjadwal pada kesalahan perintah |
default void | shutdown () Cobalah untuk mematikan penjadwal perintah dengan anggun. |
abstract void | shutdown (boolean notifyStop) Cobalah untuk mematikan penjadwal perintah dengan anggun. |
abstract void | shutdownHard (boolean killAdb) Mencoba mematikan paksa penjadwal perintah. |
abstract void | shutdownHard () Mencoba mematikan paksa penjadwal perintah. |
abstract void | shutdownOnEmpty () Mirip dengan |
abstract void | start () Mulai |
abstract boolean | stopInvocation (int invocationId, String cause) Hentikan pemanggilan yang sedang berjalan dengan menentukan id-nya. |
default boolean | stopInvocation (int invocationId) Hentikan pemanggilan yang sedang berjalan dengan menentukan id-nya. |
abstract boolean | stopInvocation ( ITestInvocation invocation) Hentikan doa yang sedang berjalan. |
Metode publik
addCommand
public abstract Pair<Boolean, Integer> addCommand (String[] args)
Menambahkan perintah ke penjadwal.
Perintah pada dasarnya adalah turunan dari konfigurasi untuk dijalankan dan argumen terkaitnya.
Jika argumen "--help" ditentukan, teks bantuan untuk konfigurasi akan ditampilkan ke stdout. Jika tidak, konfigurasi akan ditambahkan ke antrian untuk dijalankan.
Parameter | |
---|---|
args | String : argumen konfigurasi. |
Pengembalian | |
---|---|
Pair <Boolean, Integer> | Sepasang nilai, nilai pertama adalah Boolean true jika perintah berhasil ditambahkan. Nilai kedua adalah id pelacak perintah yang diketahui (nilai non-negatif) jika perintah berhasil ditambahkan, kembalikan 0 saat perintah ditambahkan untuk semua perangkat, jika tidak -1. |
Melempar | |
---|---|
ConfigurationException | jika perintah tidak dapat diuraikan |
tambahkanCommandFile
public abstract void addCommandFile (String cmdFile,extraArgs)
Menambahkan semua perintah dari file yang diberikan ke penjadwal
Parameter | |
---|---|
cmdFile | String : jalur sistem berkas dari berkas perintah |
extraArgs | ERROR(/List) dari ERROR(/String) untuk ditambahkan ke setiap perintah yang diurai dari file. Boleh kosong tapi tidak boleh null. |
Melempar | |
---|---|
ConfigurationException | jika file perintah tidak dapat diuraikan |
Lihat juga:
menunggu
public abstract void await ()
Menunggu scheduler mulai berjalan, termasuk menunggu handover dari TF lama hingga selesai jika ada.
displayCommandQueue
public abstract void displayCommandQueue (PrintWriter printWriter)
Keluarkan info debug terperinci tentang keadaan antrian eksekusi perintah.
displayCommandsInfo
public abstract void displayCommandsInfo (PrintWriter printWriter, String regex)
Keluarkan daftar perintah saat ini.
Parameter | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) untuk di-output. |
regex | String : ekspresi reguler yang perintahnya harus dicocokkan agar dapat dicetak. Jika null, maka semua perintah akan dicetak. |
displayInvocationsInfo
public abstract void displayInvocationsInfo (PrintWriter printWriter)
Menampilkan daftar doa saat ini.
Parameter | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) untuk di-output. |
dumpCommandsXml
public abstract void dumpCommandsXml (PrintWriter printWriter, String regex)
Buang file xml yang diperluas untuk perintah dengan semua nilai Option
yang ditentukan untuk semua perintah saat ini.
Parameter | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) untuk menampilkan status. |
regex | String : ekspresi reguler yang perintahnya harus dicocokkan agar file xml dibuang. Jika null, maka semua perintah akan dibuang. |
execCommand
public abstract long execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrean perintah menggunakan IInvocationContext
yang sudah ada.
Parameter | |
---|---|
context | IInvocationContext : IInvocationContext yang sudah ada. |
listener | ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener untuk diinformasikan |
args | String : argumen perintah |
Pengembalian | |
---|---|
long |
Melempar | |
---|---|
ConfigurationException | jika perintah tidak valid |
NoDeviceException | jika tidak ada perangkat untuk digunakan |
execCommand
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrean perintah.
Parameter | |
---|---|
listener | ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener untuk diinformasikan |
args | String : argumen perintah |
Pengembalian | |
---|---|
long | Id pemanggilan dari perintah terjadwal. |
Melempar | |
---|---|
ConfigurationException | jika perintah tidak valid |
NoDeviceException | jika tidak ada perangkat untuk digunakan |
execCommand
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener,devices, String[] args)
Jalankan perintah secara langsung pada perangkat yang sudah dialokasikan.
Parameter | |
---|---|
listener | ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener untuk diinformasikan |
devices | ERROR(/List ) ERROR(/List ) untuk digunakan |
args | String : argumen perintah |
Pengembalian | |
---|---|
long | Id pemanggilan dari perintah terjadwal. |
Melempar | |
---|---|
ConfigurationException | jika perintah tidak valid |
getCommandFileWatcher
public abstract CommandFileWatcher getCommandFileWatcher ()
Dapatkan CommandFileWatcher
yang sesuai untuk penjadwal ini
Pengembalian | |
---|---|
CommandFileWatcher |
getExecutingCommandCount
public abstract int getExecutingCommandCount ()
Mengembalikan jumlah Perintah dalam status eksekusi.
Pengembalian | |
---|---|
int |
getInvocationInfo
public abstract String getInvocationInfo (int invocationId)
Kembalikan informasi pada pemanggilan bu yang menentukan id pemanggilan.
Parameter | |
---|---|
invocationId | int : id pelacakan dari doa. |
Pengembalian | |
---|---|
String | ERROR(/String) yang berisi informasi tentang pemanggilan. |
getLastInvocationExitCode
public abstract CommandRunner.ExitCode getLastInvocationExitCode ()
Kembalikan kode kesalahan dari pemanggilan terakhir yang dijalankan. Kembalikan 0 (tidak ada kesalahan), jika belum ada pemanggilan yang dijalankan.
Pengembalian | |
---|---|
CommandRunner.ExitCode |
getLastInvocationThrowable
public abstract Throwable getLastInvocationThrowable ()
Kembalikan ERROR(/Throwable)
dari pemanggilan terakhir yang dijalankan. Kembalikan nol, jika tidak tersedia lemparan.
Pengembalian | |
---|---|
Throwable |
getReadyCommandCount
public abstract int getReadyCommandCount ()
Mengembalikan jumlah Perintah dalam status siap dalam antrean.
Pengembalian | |
---|---|
int |
isDeviceInvocationThread
public abstract boolean isDeviceInInvocationThread (ITestDevice device)
Mengembalikan nilai true jika perangkat digunakan oleh utas pemanggilan aktif.
Parameter | |
---|---|
device | ITestDevice |
Pengembalian | |
---|---|
boolean |
bergabung
public abstract void join ()
Menunggu penjadwal selesai.
Lihat juga:
bergabung
public abstract void join (long millis)
Menunggu penjadwal selesai atau waktu habis setelah durasi yang ditentukan dalam milidetik.
Parameter | |
---|---|
millis | long |
Lihat juga:
hapusSemuaPerintah
public abstract void removeAllCommands ()
Hapus semua perintah dari penjadwal
setClearcutClient
public abstract void setClearcutClient (ClearcutClient client)
Atur klien untuk melaporkan data harness
Parameter | |
---|---|
client | ClearcutClient |
shouldShutdownOnCmdfileError
public abstract boolean shouldShutdownOnCmdfileError ()
Kembalikan true jika kita perlu mematikan penjadwal pada kesalahan perintah
Pengembalian | |
---|---|
boolean |
matikan
public void shutdown ()
Cobalah untuk mematikan penjadwal perintah dengan anggun.
Menghapus perintah yang menunggu untuk diuji, dan meminta agar semua pemanggilan yang sedang berlangsung ditutup dengan anggun.
Setelah shutdown dipanggil, loop utama penjadwal akan menunggu semua pemanggilan yang sedang berlangsung selesai sebelum keluar sepenuhnya.
matikan
public abstract void shutdown (boolean notifyStop)
Cobalah untuk mematikan penjadwal perintah dengan anggun.
Parameter | |
---|---|
notifyStop | boolean : jika benar, beri tahu pemanggilan penutupan TF. |
shutdownHard
public abstract void shutdownHard (boolean killAdb)
Mencoba mematikan paksa penjadwal perintah.
Mirip dengan shutdown()
, tetapi juga secara opsional akan mematikan koneksi adb, dalam upaya untuk 'menginspirasi' pemanggilan yang sedang berlangsung agar selesai lebih cepat.
Parameter | |
---|---|
killAdb | boolean |
shutdownHard
public abstract void shutdownHard ()
Mencoba mematikan paksa penjadwal perintah. Sama seperti shutdownHard(true).
shutdownOnEmpty
public abstract void shutdownOnEmpty ()
Mirip dengan shutdown()
, tetapi akan menunggu semua perintah dieksekusi sebelum keluar.
awal
public abstract void start ()
Mulai ICommandScheduler
.
shutdown()
dipanggil. lihat ERROR(/Thread#start())
. stopInvokasi
public abstract boolean stopInvocation (int invocationId, String cause)
Hentikan pemanggilan yang sedang berjalan dengan menentukan id-nya.
Parameter | |
---|---|
invocationId | int : id pelacakan dari doa. |
cause | String : penyebab untuk menghentikan doa. |
Pengembalian | |
---|---|
boolean | benar jika pemanggilan dihentikan, salah jika sebaliknya |
Melempar | |
---|---|
| jika implementasi tidak mendukung ini |
stopInvokasi
public boolean stopInvocation (int invocationId)
Hentikan pemanggilan yang sedang berjalan dengan menentukan id-nya.
Parameter | |
---|---|
invocationId | int |
Pengembalian | |
---|---|
boolean | benar jika pemanggilan dihentikan, salah jika sebaliknya |
Melempar | |
---|---|
| jika implementasi tidak mendukung ini |
stopInvokasi
public abstract boolean stopInvocation (ITestInvocation invocation)
Hentikan doa yang sedang berjalan.
Parameter | |
---|---|
invocation | ITestInvocation |
Pengembalian | |
---|---|
boolean | benar jika pemanggilan dihentikan, salah jika sebaliknya |
Melempar | |
---|---|
| jika implementasi tidak mendukung ini |
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-03-30 UTC.