Penjadwal Perintah I
public interface ICommandScheduler
com.android.tradefed.command.ICommandScheduler |
Penjadwal untuk menjalankan perintah TradeFederation.
Ringkasan
Kelas bersarang | |
---|---|
interface | ICommandScheduler.IScheduledInvocationListener Pendengar peristiwa 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 penjadwal mulai berjalan, termasuk menunggu serah terima dari TF lama selesai jika berlaku. |
abstract void | displayCommandQueue (PrintWriter printWriter) Keluarkan info debug terperinci tentang status antrian eksekusi perintah. |
abstract void | displayCommandsInfo (PrintWriter printWriter, String regex) Keluarkan daftar perintah saat ini. |
abstract void | displayInvocationsInfo (PrintWriter printWriter) Menampilkan daftar pemanggilan 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 antrian perintah menggunakan |
abstract long | execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args) Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrian perintah. |
abstract long | execCommand ( ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args) execCommand ( ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args) Langsung jalankan perintah pada perangkat yang sudah dialokasikan. |
abstract CommandFileWatcher | getCommandFileWatcher () Dapatkan CommandFileWatcher yang sesuai untuk penjadwal ini |
abstract int | getExecutingCommandCount () Mengembalikan jumlah Perintah dalam status eksekusi. |
abstract String | getInvocationInfo (int invocationId) Mengembalikan informasi tentang pemanggilan tetapi menentukan id pemanggilan. |
abstract CommandRunner.ExitCode | getLastInvocationExitCode () Kembalikan kode kesalahan dari pemanggilan terakhir yang dijalankan. |
abstract Throwable | getLastInvocationThrowable () Mengembalikan |
abstract int | getReadyCommandCount () Mengembalikan jumlah Perintah dalam keadaan siap dalam antrian. |
abstract boolean | isDeviceInInvocationThread ( ITestDevice device) Mengembalikan nilai benar jika perangkat digunakan oleh thread pemanggilan aktif. |
abstract void | join () Menunggu penjadwal selesai. |
abstract void | join (long millis) Menunggu penjadwal selesai atau habis waktu 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 () Mengembalikan nilai true jika kita perlu mematikan penjadwal karena kesalahan perintah |
default void | shutdown () Cobalah untuk mematikan penjadwal perintah dengan baik. |
abstract void | shutdown (boolean notifyStop) Cobalah untuk mematikan penjadwal perintah dengan baik. |
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 idnya. |
default boolean | stopInvocation (int invocationId) Hentikan pemanggilan yang sedang berjalan dengan menentukan idnya. |
abstract boolean | stopInvocation ( ITestInvocation invocation) Hentikan pemanggilan yang sedang berjalan. |
default void | stopScheduling () Menghentikan penjadwalan dan menerima tes baru tetapi tidak menghentikan Tradefed. |
Metode publik
tambahkanPerintah
public abstract Pair<Boolean, Integer> addCommand (String[] args)
Menambahkan perintah ke penjadwal.
Perintah pada dasarnya adalah turunan dari konfigurasi yang akan 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. |
Kembali | |
---|---|
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 ketika 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 file dari file perintah |
extraArgs | ERROR(/List) argumen String untuk ditambahkan ke setiap perintah yang diurai dari file. Boleh kosong tetapi tidak boleh nol. |
Melempar | |
---|---|
ConfigurationException | jika file perintah tidak dapat diuraikan |
Lihat juga:
menunggu
public abstract void await ()
Menunggu penjadwal mulai berjalan, termasuk menunggu serah terima dari TF lama selesai jika berlaku.
tampilanCommandQueue
public abstract void displayCommandQueue (PrintWriter printWriter)
Keluarkan info debug terperinci tentang status antrian eksekusi perintah.
tampilanCommandsInfo
public abstract void displayCommandsInfo (PrintWriter printWriter, String regex)
Keluarkan daftar perintah saat ini.
Parameter | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) yang akan dijadikan 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 pemanggilan saat ini.
Parameter | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) yang akan dijadikan 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 dapat dibuang. Jika null, maka semua perintah akan dibuang. |
perintah eksekutif
public abstract long execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrian perintah menggunakan IInvocationContext
yang sudah ada.
Parameter | |
---|---|
context | IInvocationContext : IInvocationContext yang sudah ada. |
listener | ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener yang akan diberitahukan |
args | String : argumen perintah |
Kembali | |
---|---|
long |
Melempar | |
---|---|
ConfigurationException | jika perintah tidak valid |
NoDeviceException | jika tidak ada perangkat untuk digunakan |
perintah eksekutif
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Mengalokasikan perangkat secara langsung dan menjalankan perintah tanpa menambahkannya ke antrian perintah.
Parameter | |
---|---|
listener | ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener yang akan diberitahukan |
args | String : argumen perintah |
Kembali | |
---|---|
long | Id pemanggilan perintah terjadwal. |
Melempar | |
---|---|
ConfigurationException | jika perintah tidak valid |
NoDeviceException | jika tidak ada perangkat untuk digunakan |
perintah eksekutif
public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener,devices, String[] args)
Langsung jalankan perintah pada perangkat yang sudah dialokasikan.
Parameter | |
---|---|
listener | ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener yang akan diberitahukan |
devices | ERROR(/List ) ERROR(/List ) menggunakan |
args | String : argumen perintah |
Kembali | |
---|---|
long | Id pemanggilan perintah terjadwal. |
Melempar | |
---|---|
ConfigurationException | jika perintah tidak valid |
dapatkanCommandFileWatcher
public abstract CommandFileWatcher getCommandFileWatcher ()
Dapatkan CommandFileWatcher yang sesuai untuk penjadwal ini
Kembali | |
---|---|
CommandFileWatcher |
dapatkanExecutingCommandCount
public abstract int getExecutingCommandCount ()
Mengembalikan jumlah Perintah dalam status eksekusi.
Kembali | |
---|---|
int |
dapatkanInvokasiInfo
public abstract String getInvocationInfo (int invocationId)
Mengembalikan informasi tentang pemanggilan tetapi menentukan id pemanggilan.
Parameter | |
---|---|
invocationId | int : id pelacakan pemanggilan. |
Kembali | |
---|---|
String | Sebuah String yang berisi informasi tentang pemanggilan. |
dapatkanLastInvocationExitCode
public abstract CommandRunner.ExitCode getLastInvocationExitCode ()
Kembalikan kode kesalahan dari pemanggilan terakhir yang dijalankan. Kembalikan 0 (tidak ada kesalahan), jika belum ada pemanggilan yang dijalankan.
Kembali | |
---|---|
CommandRunner.ExitCode |
getLastInvocationThrowable
public abstract Throwable getLastInvocationThrowable ()
Mengembalikan Throwable
dari pemanggilan terakhir yang dijalankan. Kembalikan null, jika tidak ada barang yang dapat dibuang.
Kembali | |
---|---|
Throwable |
dapatkanReadyCommandCount
public abstract int getReadyCommandCount ()
Mengembalikan jumlah Perintah dalam keadaan siap dalam antrian.
Kembali | |
---|---|
int |
isDeviceInInvocationThread
public abstract boolean isDeviceInInvocationThread (ITestDevice device)
Mengembalikan nilai benar jika perangkat digunakan oleh thread pemanggilan aktif.
Parameter | |
---|---|
device | ITestDevice |
Kembali | |
---|---|
boolean |
bergabung
public abstract void join (long millis)
Menunggu penjadwal selesai atau habis waktu setelah durasi yang ditentukan dalam milidetik.
Parameter | |
---|---|
millis | long |
Lihat juga:
hapusSemua Perintah
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 |
harusShutdownOnCmdfileError
public abstract boolean shouldShutdownOnCmdfileError ()
Mengembalikan nilai true jika kita perlu mematikan penjadwal karena kesalahan perintah
Kembali | |
---|---|
boolean |
matikan
public void shutdown ()
Cobalah untuk mematikan penjadwal perintah dengan baik.
Menghapus perintah yang menunggu untuk diuji, dan meminta agar semua pemanggilan yang sedang berlangsung ditutup dengan baik.
Setelah shutdown dipanggil, loop utama penjadwal akan menunggu hingga semua pemanggilan yang sedang berlangsung selesai sebelum keluar sepenuhnya.
matikan
public abstract void shutdown (boolean notifyStop)
Cobalah untuk mematikan penjadwal perintah dengan baik.
Parameter | |
---|---|
notifyStop | boolean : jika benar, memberitahukan pemanggilan penutupan TF. |
penutupan Keras
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 |
penutupan Keras
public abstract void shutdownHard ()
Mencoba mematikan paksa penjadwal perintah. Sama seperti shutdownHard(benar).
shutdownOnEmpty
public abstract void shutdownOnEmpty ()
Mirip dengan shutdown()
, tetapi akan menunggu semua perintah dijalankan sebelum keluar.
awal
public abstract void start ()
Mulai ICommandScheduler
.
shutdown()
dipanggil. lihat Thread.start()
. stopInvokasi
public abstract boolean stopInvocation (int invocationId, String cause)
Hentikan pemanggilan yang sedang berjalan dengan menentukan idnya.
Parameter | |
---|---|
invocationId | int : id pelacakan pemanggilan. |
cause | String : penyebab penghentian pemanggilan. |
Kembali | |
---|---|
boolean | benar jika pemanggilan dihentikan, salah jika sebaliknya |
Melempar | |
---|---|
UnsupportedOperationException | jika implementasinya tidak mendukung hal ini |
stopInvokasi
public boolean stopInvocation (int invocationId)
Hentikan pemanggilan yang sedang berjalan dengan menentukan idnya.
Parameter | |
---|---|
invocationId | int |
Kembali | |
---|---|
boolean | benar jika pemanggilan dihentikan, salah jika sebaliknya |
Melempar | |
---|---|
UnsupportedOperationException | jika implementasinya tidak mendukung hal ini |
stopInvokasi
public abstract boolean stopInvocation (ITestInvocation invocation)
Hentikan pemanggilan yang sedang berjalan.
Parameter | |
---|---|
invocation | ITestInvocation |
Kembali | |
---|---|
boolean | benar jika pemanggilan dihentikan, salah jika sebaliknya |
Melempar | |
---|---|
UnsupportedOperationException | jika implementasinya tidak mendukung hal ini |
berhenti Penjadwalan
public void stopScheduling ()
Menghentikan penjadwalan dan menerima tes baru tetapi tidak menghentikan Tradefed. Hal ini dimaksudkan untuk mengaktifkan penghentian dua langkah di mana pertama-tama kita menguras semua pengujian yang sedang berjalan, kemudian menghentikan proses Tradefed.
Konten dan contoh kode di halaman ini tunduk kepada 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.