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 Option yang ditentukan untuk semua perintah saat ini.

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.

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 Throwable dari pemanggilan terakhir yang dijalankan.

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 shutdown() , tetapi akan menunggu semua perintah dijalankan sebelum keluar.

abstract void start ()

Mulai ICommandScheduler .

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 ()

Menunggu penjadwal selesai.

Lihat juga:

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.

Perhatikan bahwa jika ada perintah dalam mode loop, penjadwal tidak akan pernah keluar.

awal

public abstract void start ()

Mulai ICommandScheduler .

Harus dipanggil sebelum memanggil metode lain.

Akan berjalan sampai 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.