ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

TradeFederation komutlarını çalıştırmak için bir planlayıcı.

Özet

İç içe yerleştirilmiş sınıflar

interface ICommandScheduler.IScheduledInvocationListener

Çağırma tamamlandığında çağırma etkinlikleri için işleyici. 

Herkese açık yöntemler

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

Planlayıcıya bir komut ekler.

abstract void addCommandFile(String cmdFile, extraArgs)

Belirtilen dosyadaki tüm komutları planlayıcıya ekler.

abstract void await()

Planlayıcının çalışmaya başlamasını bekler. Gerekirse eski TF'den devretme işleminin tamamlanmasını da bekler.

abstract void displayCommandQueue(PrintWriter printWriter)

Komut yürütme sırasının durumu hakkında ayrıntılı hata ayıklama bilgileri verir.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

Mevcut komutların listesini gösterir.

abstract void displayInvocationsInfo(PrintWriter printWriter)

Mevcut çağrıların listesini gösterir.

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

Tüm geçerli komutlar için belirtilen tüm Option değerleriyle komutun genişletilmiş XML dosyasının dökümünü alır.

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

Mevcut bir IInvocationContext kullanarak cihazı doğrudan ayırır ve komut kuyruğuna eklemeden komutu yürütür.

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

Cihazı doğrudan ayırır ve komut kuyruğuna eklemeden komut yürütür.

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

Komutu, halihazırda ayrılmış cihazda doğrudan yürütür.

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

Komutu, halihazırda ayrılmış cihazlarda doğrudan yürütür.

abstract CommandFileWatcher getCommandFileWatcher()

Bu planlayıcı için uygun CommandFileWatcher'ı alır.

abstract int getExecutingCommandCount()

Yürütülüyor durumundaki komut sayısını döndürür.

abstract String getInvocationInfo(int invocationId)

Çağrı kimliğini belirterek bir çağrı hakkındaki bilgileri döndürür.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

Çalıştırılan son çağırmanın hata kodunu döndürür.

abstract Throwable getLastInvocationThrowable()

Çalıştırılan son çağırmadan Throwable değerini döndürür.

abstract int getReadyCommandCount()

Kuyrukta hazır durumda olan komut sayısını döndürür.

abstract boolean isDeviceInInvocationThread(ITestDevice device)

Cihaz etkin bir çağırma iş parçacığı tarafından kullanılıyorsa true değerini döndürür.

abstract void join()

Planlayıcının tamamlanmasını bekler.

abstract void join(long millis)

Planlayıcının tamamlanmasını bekler veya milisaniye cinsinden belirtilen süre sonunda zaman aşımına uğrar.

abstract void removeAllCommands()

Tüm komutları planlayıcıdan kaldırır.

abstract void setClearcutClient(ClearcutClient client)

İstemciyi koşum verilerini raporlayacak şekilde ayarlar.

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

Komut hatalarında planlayıcıyı kapatmamız gerekiyorsa true değerini döndürür.

default void shutdown()

Komut planlayıcıyı düzgün bir şekilde kapatmaya çalışır.

abstract void shutdown(boolean notifyStop)

Komut planlayıcıyı düzgün bir şekilde kapatmaya çalışır.

abstract void shutdownHard(boolean killAdb)

Komut planlayıcıyı zorla kapatmaya çalışır.

abstract void shutdownHard()

Komut planlayıcıyı zorla kapatmaya çalışır.

abstract void shutdownOnEmpty()

shutdown() parametresine benzer ancak çıkmadan önce tüm komutların yürütülmesini bekler.

abstract void start()

ICommandScheduler başlatır.

abstract boolean stopInvocation(int invocationId, String cause)

Kimliğini belirterek çalışan bir çağırmayı durdurur.

default boolean stopInvocation(int invocationId)

Kimliğini belirterek çalışan bir çağırmayı durdurur.

abstract boolean stopInvocation(ITestInvocation invocation)

Çalışan bir çağırmayı durdurur.

default void stopScheduling()

Yeni testlerin planlanmasını ve kabul edilmesini durdurur ancak Tradefed'i durdurmaz.

Herkese açık yöntemler

addCommand

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

Planlayıcıya bir komut ekler.

Komut, temelde çalıştırılacak bir yapılandırmanın örneği ve ilişkili bağımsız değişkenleridir.

"--help" bağımsız değişkeni belirtilirse yapılandırmayla ilgili yardım metni stdout'a gönderilir. Aksi takdirde yapılandırma, çalıştırılmak üzere sıraya eklenir.

Parametreler
args String: Yapılandırma bağımsız değişkenleri.
Döndürülenler
Pair<Boolean, Integer> Bir değer çifti. İlk değer, komut başarıyla eklendiyse Boole true değeridir. İkinci değer, komut başarıyla eklendiyse bilinen komut izleyici kimliğidir (negatif olmayan değer). Komut tüm cihazlar için eklendiğinde 0, aksi takdirde -1 döndürülür.
Verdiği hatalar
ConfigurationException Komut ayrıştırılamadıysa

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Belirtilen dosyadaki tüm komutları planlayıcıya ekler.

Parametreler
cmdFile String: Komut dosyasının dosya sistemi yolu
extraArgs : Dosyadan ayrıştırılan her komuta eklenecek String bağımsız değişkenlerinin ERROR(/List). Boş olabilir ancak null olmamalıdır.
Verdiği hatalar
ConfigurationException Komut dosyası ayrıştırılamadıysa

Ayrıca bkz.:

await

public abstract void await ()

Planlayıcının çalışmaya başlamasını bekler. Gerekirse eski TF'den devretme işleminin tamamlanmasını da bekler.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

Komut yürütme sırasının durumu hakkında ayrıntılı hata ayıklama bilgileri verir.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Mevcut komutların listesini gösterir.

Parametreler
printWriter PrintWriter: Çıkışın yapılacağı ERROR(/PrintWriter).
regex String: Komutların yazdırılabilmesi için eşleştirilmesi gereken normal ifade. Boşsa tüm komutlar yazdırılır.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Mevcut çağrıların listesini gösterir.

Parametreler
printWriter PrintWriter: Çıkışın yapılacağı ERROR(/PrintWriter).

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Tüm geçerli komutlar için belirtilen tüm Option değerleriyle komutun genişletilmiş XML dosyasını dökümünü alır.

Parametreler
printWriter PrintWriter: Durumun çıkışını almak için ERROR(/PrintWriter).
regex String: XML dosyasının dökümünün alınması için komutların eşleştirilmesi gereken normal ifade. Boşsa tüm komutların dökümü alınır.

execCommand

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

Mevcut bir IInvocationContext kullanarak cihazı doğrudan ayırır ve komut kuyruğuna eklemeden komutu yürütür.

Parametreler
context IInvocationContext: mevcut bir IInvocationContext.
listener ICommandScheduler.IScheduledInvocationListener: bilgilendirilecek ICommandScheduler.IScheduledInvocationListener
args String: komut bağımsız değişkenleri
Döndürülenler
long

Verdiği hatalar
ConfigurationException Komut geçersizse
NoDeviceException kullanılacak cihaz yoksa

execCommand

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

Cihazı doğrudan ayırır ve komut kuyruğuna eklemeden komut yürütür.

Parametreler
listener ICommandScheduler.IScheduledInvocationListener: bilgilendirilecek ICommandScheduler.IScheduledInvocationListener
args String: komut bağımsız değişkenleri
Döndürülenler
long Planlanmış komutun çağırma kimliği.
Verdiği hatalar
ConfigurationException Komut geçersizse
NoDeviceException kullanılacak cihaz yoksa

execCommand

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

Komutu, halihazırda ayrılmış cihazda doğrudan yürütür.

Parametreler
listener ICommandScheduler.IScheduledInvocationListener: bilgilendirilecek ICommandScheduler.IScheduledInvocationListener
device ITestDevice: Kullanılacak ITestDevice
args String: komut bağımsız değişkenleri
Döndürülenler
long Planlanmış komutun çağırma kimliği.
Verdiği hatalar
ConfigurationException Komut geçersizse

execCommand

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

Komutu, halihazırda ayrılmış cihazlarda doğrudan yürütür.

Parametreler
listener ICommandScheduler.IScheduledInvocationListener: bilgilendirilecek ICommandScheduler.IScheduledInvocationListener
devices : Kullanılacak ERROR(/List)
args String: komut bağımsız değişkenleri
Döndürülenler
long Planlanmış komutun çağırma kimliği.
Verdiği hatalar
ConfigurationException Komut geçersizse

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Bu planlayıcı için uygun CommandFileWatcher'ı alır.

Döndürülenler
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Yürütülüyor durumundaki komut sayısını döndürür.

Döndürülenler
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Çağrı kimliğini belirterek bir çağrı hakkındaki bilgileri döndürür.

Parametreler
invocationId int: Çağırmanın izleme kimliği.
Döndürülenler
String Çağırma hakkında bilgi içeren bir String.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Çalıştırılan son çağırmanın hata kodunu döndürür. Henüz hiçbir çağırma çalıştırılmadıysa 0 (hata yok) değerini döndürür.

Döndürülenler
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Çalıştırılan son çağırmadan Throwable değerini döndürür. Atılabilir bir hata yoksa boş değer döndürür.

Döndürülenler
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Kuyrukta hazır durumda olan komut sayısını döndürür.

Döndürülenler
int

isDeviceInInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

Cihaz etkin bir çağırma iş parçacığı tarafından kullanılıyorsa true değerini döndürür.

Parametreler
device ITestDevice

Döndürülenler
boolean

join

public abstract void join ()

Planlayıcının tamamlanmasını bekler.

Ayrıca bkz.:

join

public abstract void join (long millis)

Planlayıcının tamamlanmasını bekler veya milisaniye cinsinden belirtilen süre sonunda zaman aşımına uğrar.

Parametreler
millis long

Ayrıca bkz.:

removeAllCommands

public abstract void removeAllCommands ()

Tüm komutları planlayıcıdan kaldırır.

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

İstemciyi koşum verilerini raporlayacak şekilde ayarlar.

Parametreler
client ClearcutClient

setMaxPollTime

public void setMaxPollTime (long polling)

Parametreler
polling long

setPrintSchedulingWarning

public void setPrintSchedulingWarning (boolean print)

Parametreler
print boolean

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Komut hatalarında planlayıcıyı kapatmamız gerekiyorsa true değerini döndürür.

Döndürülenler
boolean

shutdown

public void shutdown ()

Komut planlayıcıyı düzgün bir şekilde kapatmaya çalışır.

Test edilmeyi bekleyen komutları temizler ve devam eden tüm çağırma işlemlerinin düzgün bir şekilde kapatılmasını ister.

Kapatma işlemi çağrıldıktan sonra, planlayıcı ana döngüsü tamamen çıkmadan önce devam eden tüm çağrıların tamamlanmasını bekler.

shutdown

public abstract void shutdown (boolean notifyStop)

Komut planlayıcıyı düzgün bir şekilde kapatmaya çalışır.

Parametreler
notifyStop boolean: Doğruysa TF kapatma çağrılarını bildirir.

shutdownHard

public abstract void shutdownHard (boolean killAdb)

Komut planlayıcıyı zorla kapatmaya çalışır.

shutdown() özelliğine benzer ancak devam eden çağırmaların daha hızlı tamamlanmasını "sağlamak" için isteğe bağlı olarak adb bağlantısını da sonlandırır.

Parametreler
killAdb boolean

shutdownHard

public abstract void shutdownHard ()

Komut planlayıcıyı zorla kapatmaya çalışır. shutdownHard(true) ile aynıdır.

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

shutdown()'ya benzer ancak çıkmadan önce tüm komutların yürütülmesini bekler.

Komutlardan herhangi biri döngü modundaysa planlayıcının asla çıkmayacağını unutmayın.

start

public abstract void start ()

ICommandScheduler'ı başlatır.

Diğer yöntemler çağrılmadan önce çağrılmalıdır.

shutdown() çağrılana kadar çalışır. Thread.start() sayfasına göz atın.

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Kimliğini belirterek çalışan bir çağırmayı durdurur.

Parametreler
invocationId int: Çağırmanın izleme kimliği.
cause String: Çağırmanın durdurulma nedeni.
Döndürülenler
boolean Çağırma durdurulduysa doğru, aksi takdirde yanlış
Verdiği hatalar
UnsupportedOperationException Uygulama bunu desteklemiyorsa

stopInvocation

public boolean stopInvocation (int invocationId)

Kimliğini belirterek çalışan bir çağırmayı durdurur.

Parametreler
invocationId int

Döndürülenler
boolean Çağırma durdurulduysa doğru, aksi takdirde yanlış
Verdiği hatalar
UnsupportedOperationException Uygulama bunu desteklemiyorsa

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

Çalışan bir çağırmayı durdurur.

Parametreler
invocation ITestInvocation

Döndürülenler
boolean Çağırma durdurulduysa doğru, aksi takdirde yanlış
Verdiği hatalar
UnsupportedOperationException Uygulama bunu desteklemiyorsa

stopScheduling

public void stopScheduling ()

Yeni testlerin planlanmasını ve kabul edilmesini durdurur ancak Tradefed'i durdurmaz. Bu, iki adımlı bir kapatma işlemi sağlamak için tasarlanmıştır. İlk adımda, çalışan tüm testler boşaltılır, ardından Tradefed işlemi sonlandırılır.