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 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 antrean perintah menggunakan IInvocationContext yang sudah ada.

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 CommandFileWatcher yang sesuai untuk penjadwal ini

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 dijalankan.

abstract Throwable getLastInvocationThrowable ()

Kembalikan Throwable dari doa terakhir yang dijalankan.

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

abstract void start ()

Mulai ICommandScheduler .

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 : sebuah ERROR(/List) dari argumen 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 Sebuah String yang berisi informasi tentang doa.

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 Throwable dari doa 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.

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 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
UnsupportedOperationException 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
UnsupportedOperationException 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
UnsupportedOperationException jika implementasi tidak mendukung ini