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ğrının tamamlandığı çağrı etkinlikleri için dinleyici. 

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

Gerektiğinde eski TF'den devir işleminin tamamlanmasını beklemek de dahil olmak üzere planlayıcının çalışmaya başlamasını bekler.

abstract void displayCommandQueue(PrintWriter printWriter)

Komut yürütme kuyruğunun durumuyla ilgili ayrıntılı hata ayıklama bilgilerini görüntüleyin.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

Mevcut komutların listesini gösterir.

abstract void displayInvocationsInfo(PrintWriter printWriter)

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

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

Mevcut tüm komutlar için belirtilen tüm Option değerleriyle birlikte komutun genişletilmiş XML dosyasını dökümü.

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

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

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

Bir cihazı doğrudan ayırır ve komutu komut kuyruğuna eklemeden yürütür.

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

Zaten tahsis edilmiş olan cihazda doğrudan komutu yürüt.

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

Halihazırda atanmış cihazlarda doğrudan komutu yürütün.

abstract CommandFileWatcher getCommandFileWatcher()

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

abstract int getExecutingCommandCount()

Yürütme durumundaki komutların sayısını döndürür.

abstract String getInvocationInfo(int invocationId)

Çağırma kimliğini belirterek bir çağrıyla ilgili bilgileri döndürme.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

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

abstract Throwable getLastInvocationThrowable()

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

abstract int getReadyCommandCount()

Sırada hazır durumdaki komutların sayısını döndürür.

abstract boolean isDeviceInInvocationThread(ITestDevice device)

Cihaz etkin bir çağrı mesajı dizisi tarafından kullanılıyorsa doğru 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ı veya milisaniye cinsinden belirtilen süre dolduktan sonra zaman aşımına uğramasını bekler.

abstract void removeAllCommands()

Planlayıcıdan tüm komutları kaldırma

abstract void setClearcutClient(ClearcutClient client)

İstemciyi, koşum takımı verilerini raporlayacak şekilde ayarlama

abstract boolean shouldShutdownOnCmdfileError()

Komut hataları nedeniyle planlayıcıyı kapatmamız gerekiyorsa doğru değerini döndürür.

default void shutdown()

Komut planlayıcıyı sorunsuz bir şekilde kapatmayı deneyin.

abstract void shutdown(boolean notifyStop)

Komut planlayıcıyı sorunsuz bir şekilde kapatmayı deneyin.

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

Çalışan bir çağrıyı kimliğini belirterek durdurun.

default boolean stopInvocation(int invocationId)

Çalışan bir çağrıyı kimliğini belirterek durdurun.

abstract boolean stopInvocation(ITestInvocation invocation)

Çalışan bir çağrıyı durdurma.

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, temel olarak çalıştırılacak bir yapılandırma ö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. Komut başarıyla eklendiyse ilk değer Boole true değerini alır. İ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 döndürülür, aksi takdirde -1 döndürülür.

Atışlar
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şkenden oluşan bir ERROR(/List). Boş olabilir ancak null olmamalıdır.

Fırlatma
ConfigurationException Komut dosyası ayrıştırılamadıysa

Şu kaynakları da inceleyin:

await

public abstract void await ()

Gerekirse eski TF'den devir teslim işleminin tamamlanmasını beklemek de dahil olmak üzere planlayıcının çalışmaya başlamasını bekler.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

Komut yürütme kuyruğunun durumuyla ilgili ayrıntılı hata ayıklama bilgilerini görüntüleyin.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Mevcut komutların listesini gösterir.

Parametreler
printWriter PrintWriter: Çıktısı alınacak ERROR(/PrintWriter).

regex String: Yazdırılabilmesi için komutların eşleştirilmesi gereken normal ifade. Null ise tüm komutlar yazdırılır.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Geçerli çağrıların listesini görüntüler.

Parametreler
printWriter PrintWriter: Çıktı alınacak ERROR(/PrintWriter).

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Mevcut tüm komutlar için belirtilen tüm Option değerleriyle birlikte komutun genişletilmiş XML dosyasını dökümü.

Parametreler
printWriter PrintWriter: Durum çıktısının alınacağı ERROR(/PrintWriter).

regex String: XML dosyasının dökülmesi 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 bir cihazı doğrudan tahsis eder ve komutu komut kuyruğuna eklemeden 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

Fırlatma
ConfigurationException komut geçersizse
NoDeviceException Kullanılacak cihaz yoksa

execCommand

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

Bir cihazı doğrudan ayırır ve komutu komut sırasına eklemeden 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ğrı kimliği.

Fırlatma
ConfigurationException komut geçersizse
NoDeviceException Kullanılacak cihaz yoksa

execCommand

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

Komutu, önceden 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ğrı kimliği.

Fırlatma
ConfigurationException if command was invalid

execCommand

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

Halihazırda atanmış cihazlarda doğrudan komutu 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ğrı kimliği.

Fırlatma
ConfigurationException if command was invalid

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Bu planlayıcı için uygun CommandFileWatcher öğesini alın

İlerlemeler
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Yürütme durumundaki komutların sayısını döndürür.

İlerlemeler
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Çağrı kimliğini belirten bilgileri bir çağrı üzerinde döndürür.

Parametreler
invocationId int: Çağrının izleme kimliği.

İlerlemeler
String Çağrıyla ilgili bilgileri içeren bir String.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Çalıştırılan son çağrının hata kodunu döndürür. Henüz çağrı çalıştırılmamışsa 0 (hata yok) değerini döndürür.

İlerlemeler
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Çalıştırılan son çağrıdan Throwable değerini döndürür. Atılabilir öğe yoksa null döndürülür.

İlerlemeler
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Sırada hazır durumdaki komutların sayısını döndürür.

İlerlemeler
int

isDeviceInInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

Cihaz etkin bir çağrı mesajı dizisi tarafından kullanılıyorsa doğru değerini döndürür.

Parametreler
device ITestDevice

İlerlemeler
boolean

katıl

public abstract void join ()

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

katıl

public abstract void join (long millis)

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

Parametreler
millis long

removeAllCommands

public abstract void removeAllCommands ()

Planlayıcıdan tüm komutları kaldırma

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

İstemciyi, koşum takımı verilerini raporlayacak şekilde ayarlama

Parametreler
client ClearcutClient

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Bir komut hatalarında zamanlayıcıyı kapatmamız gerekirse true değerini döndürür

İlerlemeler
boolean

kapatma

public void shutdown ()

Komut planlayıcıyı sorunsuz bir şekilde kapatmayı deneyin.

Test edilmeyi bekleyen komutları temizler ve devam eden tüm çağrıların sorunsuz şekilde kapatılmasını ister.

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

kapatmak

public abstract void shutdown (boolean notifyStop)

Komut planlayıcıyı düzgün şekilde kapatmayı deneyin.

Parametreler
notifyStop boolean: Doğru ise 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ğrıların daha hızlı tamamlanması 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ı.

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

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

Döngü modunda olan komutlar varsa planlayıcının hiçbir zaman çı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ışacak. Thread.start() inceleyin.

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Çalışan bir çağrının kimliğini belirterek çağrıyı durdurun.

Parametreler
invocationId int: Çağrının izleme kimliği.

cause String: Çağrının durdurulma nedeni.

İlerlemeler
boolean Çağırma durdurulduysa true, aksi takdirde false değerini alır.

Atışlar
UnsupportedOperationException uygulama bunu desteklemiyorsa

stopInvocation

public boolean stopInvocation (int invocationId)

Çalışan bir çağrının kimliğini belirterek çağrıyı durdurun.

Parametreler
invocationId int

İlerlemeler
boolean Çağırma durdurulduysa true, aksi takdirde false değerini alır.

Atışlar
UnsupportedOperationException uygulama bunu desteklemiyorsa

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

Çalışan bir çağrıyı durdurma.

Parametreler
invocation ITestInvocation

İlerlemeler
boolean Çağırma durdurulduysa true, aksi takdirde false değerini alır.

Atışlar
UnsupportedOperationException Uygulama bunu desteklemiyorsa

stopScheduling

public void stopScheduling ()

Yeni testlerin planlanmasını ve kabul edilmesini durdurur ancak Tradefed'i durdurmaz. Bu, önce tüm çalışan testlerin sonlandırıldığı ve ardından Tradefed sürecinin sonlandırıldığı iki adımlı bir kapatma işlemini etkinleştirmeyi amaçlar.