ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

Penjadwal untuk menjalankan perintah TradeFederation.

Ringkasan

Class bertingkat

interface ICommandScheduler.IScheduledInvocationListener

Pemroses untuk peristiwa pemanggilan saat pemanggilan selesai. 

Metode publik

abstract Pair<Boolean, Integer> addCommand(String[] args)

Menambahkan perintah ke penjadwal.

abstract void addCommandFile(String cmdFile, extraArgs)

Menambahkan semua perintah dari file tertentu ke penjadwal

abstract void await()

Menunggu penjadwal mulai berjalan, termasuk menunggu penyerahan dari TF lama selesai jika berlaku.

abstract void displayCommandQueue(PrintWriter printWriter)

Menampilkan info debug mendetail tentang status antrean eksekusi perintah.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

Menampilkan daftar perintah saat ini.

abstract void displayInvocationsInfo(PrintWriter printWriter)

Menampilkan daftar pemanggilan saat ini.

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

Buat 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, ITestDevice device, String[] args)

Menjalankan perintah secara langsung di perangkat yang sudah dialokasikan.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args)

Menjalankan perintah secara langsung di perangkat yang sudah dialokasikan.

abstract CommandFileWatcher getCommandFileWatcher()

Dapatkan CommandFileWatcher yang sesuai untuk penjadwal ini

abstract int getExecutingCommandCount()

Menampilkan jumlah Perintah dalam status yang sedang dieksekusi.

abstract String getInvocationInfo(int invocationId)

Menampilkan informasi tentang pemanggilan dengan menentukan ID pemanggilan.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

Menampilkan kode error dari pemanggilan terakhir yang dijalankan.

abstract Throwable getLastInvocationThrowable()

Menampilkan Throwable dari pemanggilan terakhir yang dijalankan.

abstract int getReadyCommandCount()

Menampilkan jumlah Perintah dalam status siap di antrean.

abstract boolean isDeviceInInvocationThread(ITestDevice device)

Menampilkan nilai benar jika perangkat digunakan oleh thread pemanggilan aktif.

abstract void join()

Menunggu penjadwal selesai.

abstract void join(long millis)

Menunggu penjadwal selesai atau waktu tunggu berakhir setelah durasi yang ditentukan dalam milidetik.

abstract void removeAllCommands()

Menghapus semua perintah dari penjadwal

abstract void setClearcutClient(ClearcutClient client)

Menetapkan klien untuk melaporkan data harness

default void setMaxPollTime(long polling)
default void setPrintSchedulingWarning(boolean print)
abstract boolean shouldShutdownOnCmdfileError()

Menampilkan benar jika kita perlu mematikan penjadwal saat terjadi error perintah

default void shutdown()

Mencoba mematikan penjadwal perintah dengan tuntas.

abstract void shutdown(boolean notifyStop)

Mencoba mematikan penjadwal perintah dengan tuntas.

abstract void shutdownHard(boolean killAdb)

Mencoba mematikan penjadwal perintah secara paksa.

abstract void shutdownHard()

Mencoba mematikan penjadwal perintah secara paksa.

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)

Menghentikan pemanggilan yang sedang berjalan.

default void stopScheduling()

Menghentikan penjadwalan dan penerimaan pengujian baru, tetapi tidak menghentikan Tradefed.

Metode publik

addCommand

public abstract Pair<Boolean, Integer> addCommand (String[] args)

Menambahkan perintah ke penjadwal.

Perintah pada dasarnya adalah instance 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 antrean untuk dijalankan.

Parameter
args String: argumen konfigurasi.
Hasil
Pair<Boolean, Integer> Pasangan 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, menampilkan 0 jika perintah ditambahkan untuk semua perangkat, atau -1.
Menampilkan
ConfigurationException jika perintah tidak dapat diuraikan

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Menambahkan semua perintah dari file tertentu ke penjadwal

Parameter
cmdFile String: jalur sistem file file perintah
extraArgs : ERROR(/List) argumen String yang akan ditambahkan ke setiap perintah yang diuraikan dari file. Boleh kosong, tetapi tidak boleh null.
Menampilkan
ConfigurationException jika file perintah tidak dapat diurai

Lihat juga:

menunggu

public abstract void await ()

Menunggu penjadwal mulai berjalan, termasuk menunggu penyerahan dari TF lama selesai jika berlaku.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

Menampilkan info debug mendetail tentang status antrean eksekusi perintah.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Menampilkan daftar perintah saat ini.

Parameter
printWriter PrintWriter: ERROR(/PrintWriter) yang akan ditampilkan.
regex String: ekspresi reguler yang harus dicocokkan dengan perintah agar dapat dicetak. Jika null, semua perintah akan dicetak.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Menampilkan daftar pemanggilan saat ini.

Parameter
printWriter PrintWriter: ERROR(/PrintWriter) yang akan ditampilkan.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Buat 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 harus dicocokkan dengan perintah agar file XML dapat di-dump. Jika null, semua perintah akan di-dump.

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 ada.
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener yang akan diberi tahu
args String: argumen perintah
Hasil
long

Menampilkan
ConfigurationException jika perintah tidak valid
NoDeviceException jika tidak ada perangkat yang dapat 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 yang akan diberi tahu
args String: argumen perintah
Hasil
long ID pemanggilan perintah terjadwal.
Menampilkan
ConfigurationException jika perintah tidak valid
NoDeviceException jika tidak ada perangkat yang dapat digunakan

execCommand

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

Menjalankan perintah secara langsung di perangkat yang sudah dialokasikan.

Parameter
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener yang akan diberi tahu
device ITestDevice: ITestDevice yang akan digunakan
args String: argumen perintah
Hasil
long ID pemanggilan perintah terjadwal.
Menampilkan
ConfigurationException jika perintah tidak valid

execCommand

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                 devices, 
                String[] args)

Menjalankan perintah secara langsung di perangkat yang sudah dialokasikan.

Parameter
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener yang akan diberi tahu
devices : ERROR(/List) yang akan digunakan
args String: argumen perintah
Hasil
long ID pemanggilan perintah terjadwal.
Menampilkan
ConfigurationException jika perintah tidak valid

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Dapatkan CommandFileWatcher yang sesuai untuk penjadwal ini

Hasil
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Menampilkan jumlah Perintah dalam status yang sedang dieksekusi.

Hasil
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Menampilkan informasi tentang pemanggilan dengan menentukan ID pemanggilan.

Parameter
invocationId int: ID pelacakan pemanggilan.
Hasil
String String yang berisi informasi tentang pemanggilan.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Menampilkan kode error dari pemanggilan terakhir yang dijalankan. Menampilkan 0 (tanpa error), jika belum ada pemanggilan yang dijalankan.

Hasil
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Menampilkan Throwable dari pemanggilan terakhir yang dijalankan. Menampilkan null, jika tidak ada throwable yang tersedia.

Hasil
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Menampilkan jumlah Perintah dalam status siap di antrean.

Hasil
int

isDeviceInInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

Menampilkan nilai benar jika perangkat digunakan oleh thread pemanggilan aktif.

Parameter
device ITestDevice

Hasil
boolean

gabung

public abstract void join ()

Menunggu penjadwal selesai.

Lihat juga:

gabung

public abstract void join (long millis)

Menunggu penjadwal selesai atau waktu tunggu berakhir setelah durasi yang ditentukan dalam milidetik.

Parameter
millis long

Lihat juga:

removeAllCommands

public abstract void removeAllCommands ()

Menghapus semua perintah dari penjadwal

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Menetapkan klien untuk melaporkan data harness

Parameter
client ClearcutClient

setMaxPollTime

public void setMaxPollTime (long polling)

Parameter
polling long

setPrintSchedulingWarning

public void setPrintSchedulingWarning (boolean print)

Parameter
print boolean

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Menampilkan benar jika kita perlu mematikan penjadwal saat terjadi error perintah

Hasil
boolean

shutdown

public void shutdown ()

Mencoba mematikan penjadwal perintah dengan tuntas.

Menghapus perintah yang menunggu untuk diuji, dan meminta agar semua pemanggilan yang sedang berlangsung dihentikan dengan benar.

Setelah shutdown dipanggil, loop utama penjadwal akan menunggu semua pemanggilan yang sedang berlangsung selesai sebelum keluar sepenuhnya.

shutdown

public abstract void shutdown (boolean notifyStop)

Mencoba mematikan penjadwal perintah dengan tuntas.

Parameter
notifyStop boolean: jika benar, akan memberi tahu pemanggilan penonaktifan TF.

shutdownHard

public abstract void shutdownHard (boolean killAdb)

Mencoba mematikan penjadwal perintah secara paksa.

Mirip dengan shutdown(), tetapi juga akan menghentikan koneksi adb secara opsional, dalam upaya untuk 'mendorong' pemanggilan yang sedang berlangsung agar selesai lebih cepat.

Parameter
killAdb boolean

shutdownHard

public abstract void shutdownHard ()

Mencoba mematikan penjadwal perintah secara paksa. 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.

start

public abstract void start ()

Mulai ICommandScheduler.

Harus dipanggil sebelum memanggil metode lain.

Akan berjalan hingga shutdown() dipanggil. lihat Thread.start().

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Hentikan pemanggilan yang sedang berjalan dengan menentukan ID-nya.

Parameter
invocationId int: ID pelacakan pemanggilan.
cause String: penyebab penghentian pemanggilan.
Hasil
boolean benar jika pemanggilan dihentikan, salah jika tidak
Menampilkan
UnsupportedOperationException jika penerapan tidak mendukung hal ini

stopInvocation

public boolean stopInvocation (int invocationId)

Hentikan pemanggilan yang sedang berjalan dengan menentukan ID-nya.

Parameter
invocationId int

Hasil
boolean benar jika pemanggilan dihentikan, salah jika tidak
Menampilkan
UnsupportedOperationException jika penerapan tidak mendukung hal ini

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

Menghentikan pemanggilan yang sedang berjalan.

Parameter
invocation ITestInvocation

Hasil
boolean benar jika pemanggilan dihentikan, salah jika tidak
Menampilkan
UnsupportedOperationException jika penerapan tidak mendukung hal ini

stopScheduling

public void stopScheduling ()

Menghentikan penjadwalan dan penerimaan pengujian baru, tetapi tidak menghentikan Tradefed. Tindakan ini dimaksudkan untuk mengaktifkan penonaktifan dua langkah, yang pertama menghentikan semua pengujian yang sedang berjalan, lalu menghentikan proses Tradefed.