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

abstract void displayInvocationsInfo(PrintWriter printWriter)

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

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)

Komutu, önceden ayrılmış cihazda doğrudan yürütün.

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

Komutu, önceden 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ütme durumundaki komutların sayısını döndürür.

abstract String getInvocationInfo(int invocationId)

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

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, harmanlama 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() işlevine benzer, ancak bunun yerine çıkıştan ö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)

Devam eden bir çağrıyı durdurun.

default void stopScheduling()

Yeni testleri planlamayı ve kabul etmeyi 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 true Boole olur). İ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 if 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 ERROR(/List)/String bağımsız değişken. Boş olabilir ancak null olmamalıdır.

Atışlar
ConfigurationException Komut dosyası ayrıştırılamadıysa

Şu kaynakları da inceleyin:

bekle

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: çıkış yapılacak ERROR(/PrintWriter).

regex String: Komutların yazdırılmak üzere eşleştirilmesi gereken normal ifade. Null ise tüm komutlar yazdırılır.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

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

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

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Komutun genişletilmiş xml dosyasını, tüm mevcut komutlar için belirtilen tüm Option değerlerini içerecek şekilde boşaltın.

Parametreler
printWriter PrintWriter: Durumu döndürmek için 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 if command was invalid
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 kuyruğuna 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.

Atışlar
ConfigurationException if command was invalid
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.

Atışlar
ConfigurationException komut geçersizse

execCommand

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

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

Atışlar
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ütme durumundaki komut sayısını döndürür.

İlerlemeler
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

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

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

isDeviceInvocationThread

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.

Şu kaynakları da inceleyin:

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

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

İlerlemeler
boolean

kapatmak

public void shutdown ()

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

Test edilmeyi bekleyen komutları temizler ve devam eden tüm çağrıların sorunsuz bir ş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ı sorunsuz bir şekilde kapatmayı deneyin.

Parametreler
notifyStop boolean: Doğru değerine ayarlanırsa TF kapatılmasıyla ilgili çağrıları bildirir.

shutdownHard

public abstract void shutdownHard (boolean killAdb)

Komut planlayıcıyı zorla kapatmayı deneyin.

shutdown() ile benzerdir 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ışır. Thread.start() inceleyin.

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Çalışan bir çağrıyı kimliğini belirterek 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ıyı kimliğini belirterek 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.