ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

Subclass tidak langsung yang umum ClusterCommandScheduler, CommandScheduler ClusterCommandScheduler ICommandScheduler untuk mendukung TFC (Cluster Tradefed).  Penjadwal Perintah Penjadwal untuk menjalankan perintah TradeFederation di semua perangkat yang tersedia.

---

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) Menghasilkan 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) Membuang file xml yang diperluas untuk perintah tersebut dengan semua nilai Option yang ditetapkan 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) Secara langsung mengalokasikan perangkat dan menjalankan perintah tanpa menambahkannya ke antrean perintah.
abstract long	execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args) Langsung jalankan perintah di perangkat yang telah dialokasikan.
abstract long	execCommand(ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args) Jalankan perintah secara langsung di perangkat yang telah dialokasikan.
abstract CommandFileWatcher	getCommandFileWatcher() Mendapatkan CommandFileWatcher yang sesuai untuk penjadwal ini
abstract int	getExecutingCommandCount() Menampilkan jumlah Perintah dalam status eksekusi.
abstract String	getInvocationInfo(int invocationId) Menampilkan informasi tentangbu pemanggilan yang menentukan ID pemanggilan.
abstract CommandRunner.ExitCode	getLastInvocationExitCode() Menampilkan kode error dari panggilan terakhir yang berjalan.
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 true (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 habis setelah durasi yang ditentukan dalam milidetik.
abstract void	removeAllCommands() Menghapus semua perintah dari penjadwal
abstract void	setClearcutClient(ClearcutClient client) Menetapkan klien untuk melaporkan data memanfaatkan
abstract boolean	shouldShutdownOnCmdfileError() Menampilkan true jika kita perlu menonaktifkan penjadwal saat terjadi error perintah
default void	shutdown() Mencoba menonaktifkan penjadwal perintah dengan tuntas.
abstract void	shutdown(boolean notifyStop) Mencoba menonaktifkan penjadwal perintah dengan tuntas.
abstract void	shutdownHard(boolean killAdb) Mencoba menonaktifkan penjadwal perintah secara paksa.
abstract void	shutdownHard() Mencoba menonaktifkan 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() Berhenti menjadwalkan dan menerima 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 terkait.

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>	Sepasang nilai, nilai pertama adalah true Boolean jika perintah berhasil ditambahkan. Nilai kedua adalah ID pelacak perintah yang diketahui(nilai non-negatif) jika perintah berhasil ditambahkan, tampilkan 0 saat perintah ditambahkan untuk semua perangkat, jika tidak, -1.

Menampilkan
ConfigurationException	jika perintah tidak dapat diuraikan

Lihat juga:

• IConfigurationFactory.createConfigurationFromArgs(String[])

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. Dapat kosong, tetapi tidak boleh null.

Menampilkan
ConfigurationException	jika file perintah tidak dapat diuraikan

Lihat juga:

• CommandFileParser

await

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 menghasilkan output.
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 menjadi target 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 harus dicocokkan dengan perintah agar file XML 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	if perintah tidak valid
NoDeviceException	jika tidak ada perangkat untuk digunakan

execCommand

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

Secara langsung mengalokasikan perangkat 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 panggilan perintah terjadwal.

Menampilkan
ConfigurationException	if perintah tidak valid
NoDeviceException	jika tidak ada perangkat untuk digunakan

{i>execCommand<i}

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

Langsung jalankan perintah di perangkat yang telah dialokasikan.

Parameter
listener	ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener yang akan diberi tahu
device	ITestDevice: ITestDevice yang akan digunakan
args	String: argumen perintah

Hasil
long	ID panggilan perintah terjadwal.

Menampilkan
ConfigurationException	jika perintah tidak valid

execCommand

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

Jalankan 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 panggilan perintah terjadwal.

Menampilkan
ConfigurationException	jika perintah tidak valid

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Mendapatkan CommandFileWatcher yang sesuai untuk penjadwal ini

Hasil
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Menampilkan jumlah Perintah dalam status eksekusi.

Hasil
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Menampilkan informasi tentangbu pemanggilan yang 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 (tidak ada 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:

• Thread.join()

gabung

public abstract void join (long millis)

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

Parameter
millis	long

Lihat juga:

• Thread.join(long)

removeAllCommands

public abstract void removeAllCommands ()

Hapus semua perintah dari penjadwal

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Menetapkan klien untuk melaporkan data harness

Parameter
client	ClearcutClient

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Menampilkan true jika kita perlu menonaktifkan penjadwal saat terjadi error perintah

Hasil
boolean

shutdown

public void shutdown ()

Mencoba mematikan penjadwal perintah dengan baik.

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

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

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

shutdownHard

public abstract void shutdownHard (boolean killAdb)

Mencoba menonaktifkan penjadwal perintah secara paksa.

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

Parameter
killAdb	boolean

shutdownHard

public abstract void shutdownHard ()

Mencoba menonaktifkan 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	true jika pemanggilan dihentikan, false jika tidak

Menampilkan
UnsupportedOperationException	jika penerapan tidak mendukungnya

stopInvocation

public boolean stopInvocation (int invocationId)

Hentikan pemanggilan yang sedang berjalan dengan menentukan ID-nya.

Parameter
invocationId	int

Hasil
boolean	true jika pemanggilan dihentikan, false jika tidak

Menampilkan
UnsupportedOperationException	jika penerapan tidak mendukungnya

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

Menghentikan pemanggilan yang sedang berjalan.

Parameter
invocation	ITestInvocation

Hasil
boolean	true jika pemanggilan dihentikan, false jika tidak

Menampilkan
UnsupportedOperationException	jika implementasinya tidak mendukung

stopScheduling

public void stopScheduling ()

Berhenti menjadwalkan dan menerima pengujian baru, tetapi tidak menghentikan Tradefed. Hal ini dimaksudkan untuk mengaktifkan penonaktifan dua langkah, yaitu pertama-tama kita menghabiskan semua pengujian yang sedang berjalan, lalu menghentikan proses Tradefed.