ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

TradeFederation komutlarını çalıştırmak için bir zamanlayı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)

Zamanlayı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öster.

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ı dökün.

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ün.

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

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

abstract CommandFileWatcher getCommandFileWatcher()

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

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ün.

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

Zamanlayıcının tamamlanmasını bekler.

abstract void join(long millis)

Zamanlayı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ırma

abstract void setClearcutClient(ClearcutClient client)

İstemciyi koşum verilerini raporlayacak şekilde ayarlama

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()'ya benzer ancak çıkmadan önce tüm komutların yürütülmesini bekler.

abstract void start()

ICommandScheduler başlatın.

abstract boolean stopInvocation(int invocationId, String cause)

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

default boolean stopInvocation(int invocationId)

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

abstract boolean stopInvocation(ITestInvocation invocation)

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

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)

Zamanlayı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.
İlerlemeler
Pair<Boolean, Integer> Bir değer çifti. İlk değer, komut başarıyla eklendiyse Boole değeridir true. İ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.
Dekoratif yastıklar
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.
Dekoratif yastıklar
ConfigurationException Komut dosyası ayrıştırılamadıysa

bekle

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öster.

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ün.

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 dökülü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
İlerlemeler
long

Dekoratif yastıklar
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
İlerlemeler
long Planlanmış komutun çağırma kimliği.
Dekoratif yastıklar
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ün.

Parametreler
listener ICommandScheduler.IScheduledInvocationListener: bilgilendirilecek ICommandScheduler.IScheduledInvocationListener
device ITestDevice: Kullanılacak ITestDevice
args String: komut bağımsız değişkenleri
İlerlemeler
long Planlanmış komutun çağırma kimliği.
Dekoratif yastıklar
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ün.

Parametreler
listener ICommandScheduler.IScheduledInvocationListener: bilgilendirilecek ICommandScheduler.IScheduledInvocationListener
devices : Kullanılacak ERROR(/List)
args String: komut bağımsız değişkenleri
İlerlemeler
long Planlanmış komutun çağırma kimliği.
Dekoratif yastıklar
ConfigurationException Komut geçersizse

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

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

İlerlemeler
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

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

İlerlemeler
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

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

Parametreler
invocationId int: Çağırmanın izleme kimliği.
İlerlemeler
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.

İlerlemeler
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.

İlerlemeler
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

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

İlerlemeler
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

İlerlemeler
boolean

katıl

public abstract void join ()

Zamanlayıcının tamamlanmasını bekler.

Ayrıca:

katıl

public abstract void join (long millis)

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

Parametreler
millis long

removeAllCommands

public abstract void removeAllCommands ()

Tüm komutları planlayıcıdan kaldırma

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

İstemciyi koşum verilerini raporlayacak şekilde ayarlama

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.

İlerlemeler
boolean

kapatma

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.

kapatma

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 zamanlayıcının asla çıkmayacağını unutmayın.

start

public abstract void start ()

ICommandScheduler başlatın.

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ı durdurun.

Parametreler
invocationId int: Çağırmanın izleme kimliği.
cause String: Çağırmanın durdurulma nedeni.
İlerlemeler
boolean Çağırma durdurulduysa doğru, aksi takdirde yanlış
Dekoratif yastıklar
UnsupportedOperationException Uygulama bunu desteklemiyorsa

stopInvocation

public boolean stopInvocation (int invocationId)

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

Parametreler
invocationId int

İlerlemeler
boolean Çağırma durdurulduysa doğru, aksi takdirde yanlış
Dekoratif yastıklar
UnsupportedOperationException Uygulama bunu desteklemiyorsa

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

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

Parametreler
invocation ITestInvocation

İlerlemeler
boolean Çağırma durdurulduysa doğru, aksi takdirde yanlış
Dekoratif yastıklar
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.