iCommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

Ein Planer zum Ausführen von TradeFederation-Befehlen.

Zusammenfassung

Verschachtelte Klassen

interface ICommandScheduler.IScheduledInvocationListener

Listener für Aufrufereignisse bei Abschluss des Aufrufs. 

Öffentliche Methoden

abstract boolean addCommand(String[] args)

Fügt dem Planer einen Befehl hinzu.

abstract void addCommandFile(String cmdFile, extraArgs)

Fügt dem Planer alle Befehle aus der angegebenen Datei hinzu

abstract void await()

Wartet, bis der Planer ausgeführt wird, einschließlich Warten auf den Abschluss der Übergabe der alten TF falls zutreffend.

abstract void completeHandover()

Informiert den Befehlsplaner, dass eine initiierte Handover-Sequenz vollständig abgeschlossen ist, und sollte seinen Remote Manager am Standardport neu initialisieren.

abstract void displayCommandQueue(PrintWriter printWriter)

Gibt detaillierte Debug-Informationen zum Status der Warteschlange für die Befehlsausführung aus.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

Gibt eine Liste der aktuellen Befehle aus.

abstract void displayInvocationsInfo(PrintWriter printWriter)

Zeigt eine Liste der aktuellen Aufrufe an.

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

Speichern Sie die erweiterte XML-Datei für den Befehl mit allen Option-Werte, die für alle aktuellen Befehle angegeben wurden.

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

Ordnet ein Gerät direkt zu und führt einen Befehl aus, ohne es der Befehlswarteschlange hinzuzufügen mit einer bereits vorhandenen IInvocationContext.

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

Ordnet ein Gerät direkt zu und führt einen Befehl aus, ohne es der Befehlswarteschlange hinzuzufügen.

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

Befehl direkt auf einem bereits zugewiesenen Gerät ausführen.

abstract CommandFileWatcher getCommandFileWatcher()

Entsprechenden CommandFileWatcher für diesen Planer abrufen

abstract int getExecutingCommandCount()

Gibt die Anzahl der Befehle im Ausführungsstatus zurück.

abstract String getInvocationInfo(int invocationId)

Gibt die Informationen zu einem Aufruf zurück, indem die Aufruf-ID angegeben wird.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

Gibt den Fehlercode des letzten ausgeführten Aufrufs zurück.

abstract Throwable getLastInvocationThrowable()

Gibt das Throwable des letzten ausgeführten Aufrufs zurück.

abstract int getReadyCommandCount()

Gibt die Anzahl der Befehle im Status „Bereit“ in der Warteschlange zurück.

abstract void handoverInitiationComplete()

Informiert den Befehlsplaner über den ersten Handover-Austausch der verwendeten Geräte und Befehle abgeschlossen ist und mit der Planung beginnen kann.

abstract boolean handoverShutdown(int handoverPort)

Initiiert ein shutdown() und eine Übergabe an einen anderen Tradef-Prozess auf demselben Host.

abstract void join()

Wartet auf den Abschluss des Planers.

abstract void join(long millis)

Wartet auf den Abschluss des Planers oder auf das Zeitlimit nach dem angegebenen Zeitraum in Millisekunden.

abstract void removeAllCommands()

Alle Befehle aus dem Planer entfernen

abstract void setClearcutClient(ClearcutClient client)

Den Kunden für die Berichterstellung über die Nutzungsdaten einrichten

abstract boolean shouldShutdownOnCmdfileError()

Gibt „true“ zurück, wenn der Planer bei einem Befehlsfehler heruntergefahren werden muss

abstract void shutdown()

Versuchen Sie, den Befehlsplaner ordnungsgemäß herunterzufahren.

abstract void shutdownHard(boolean killAdb)

Versuchen Sie, das Herunterfahren des Befehlsplaners zu erzwingen.

abstract void shutdownHard()

Versuchen Sie, das Herunterfahren des Befehlsplaners zu erzwingen.

abstract void shutdownOnEmpty()

Ähnlich wie „shutdown()“, wird aber darauf gewartet, dass alle Befehle ausgeführt wurden bevor Sie die Seite verlassen.

abstract void start()

Starten Sie ICommandScheduler.

abstract boolean stopInvocation(int invocationId, String cause)

Beenden Sie einen laufenden Aufruf, indem Sie seine ID angeben.

default boolean stopInvocation(int invocationId)

Beenden Sie einen laufenden Aufruf, indem Sie seine ID angeben.

abstract boolean stopInvocation(ITestInvocation invocation)

Beenden Sie einen laufenden Aufruf.

Öffentliche Methoden

Befehl hinzufügen

public abstract boolean addCommand (String[] args)

Fügt dem Planer einen Befehl hinzu.

Ein Befehl ist im Wesentlichen eine Instanz einer auszuführenden Konfiguration und der zugehörigen Argumente.

Wenn "--help" Argument ist der Hilfetext für wird die Konfiguration in stdout ausgegeben. Andernfalls wird die Konfiguration zur Warteschlange hinzugefügt, ausführen.

Parameter
args String: die Konfigurationsargumente
Returns
boolean true, wenn der Befehl hinzugefügt wurde
Ausgabe
ConfigurationException Befehl konnte nicht geparst werden

addCommandFile (Befehlsdatei)

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Fügt dem Planer alle Befehle aus der angegebenen Datei hinzu

Parameter
cmdFile String: der Dateisystempfad der comand-Datei
extraArgs : ERROR(/List) von String-Argumenten, die an jeden geparsten Befehl angehängt werden sollen aus Datei. Kann leer, aber nicht null sein.
Ausgabe
ConfigurationException Befehlsdatei konnte nicht geparst werden

Weitere Informationen:

warten

public abstract void await ()

Wartet, bis der Planer ausgeführt wird, einschließlich Warten auf den Abschluss der Übergabe der alten TF falls zutreffend.

vollständige Übergabe

public abstract void completeHandover ()

Informiert den Befehlsplaner, dass eine initiierte Handover-Sequenz vollständig abgeschlossen ist, und sollte seinen Remote Manager am Standardport neu initialisieren.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

Gibt detaillierte Debug-Informationen zum Status der Warteschlange für die Befehlsausführung aus.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Gibt eine Liste der aktuellen Befehle aus.

Parameter
printWriter PrintWriter: ERROR(/PrintWriter), in den die Ausgabe erfolgen soll.
regex String: der reguläre Ausdruck, mit dem Befehle abgeglichen werden sollen, um gedruckt. Bei null werden alle Befehle ausgegeben.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Zeigt eine Liste der aktuellen Aufrufe an.

Parameter
printWriter PrintWriter: ERROR(/PrintWriter), in den die Ausgabe erfolgen soll.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Speichern Sie die erweiterte XML-Datei für den Befehl mit allen Option-Werte, die für alle aktuellen Befehle angegeben wurden.

Parameter
printWriter PrintWriter: ERROR(/PrintWriter), an den der Status ausgegeben werden soll.
regex String: der reguläre Ausdruck, mit dem Befehle in der richtigen Reihenfolge für die zu speichern. Wenn null ist, werden alle Befehle ausgegeben.

Befehl ausführen

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

Ordnet ein Gerät direkt zu und führt einen Befehl aus, ohne es der Befehlswarteschlange hinzuzufügen mit einer bereits vorhandenen IInvocationContext.

Parameter
context IInvocationContext: eine vorhandene IInvocationContext.
listener ICommandScheduler.IScheduledInvocationListener: die zu informierenden ICommandScheduler.IScheduledInvocationListener
args String: die Befehlsargumente
Ausgabe
ConfigurationException Befehl war ungültig
NoDeviceException wenn kein Gerät zur Verfügung steht

Befehl ausführen

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

Ordnet ein Gerät direkt zu und führt einen Befehl aus, ohne es der Befehlswarteschlange hinzuzufügen.

Parameter
listener ICommandScheduler.IScheduledInvocationListener: die zu informierenden ICommandScheduler.IScheduledInvocationListener
args String: die Befehlsargumente
Ausgabe
ConfigurationException Befehl war ungültig
NoDeviceException wenn kein Gerät zur Verfügung steht

Befehl ausführen

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

Befehl direkt auf einem bereits zugewiesenen Gerät ausführen.

Parameter
listener ICommandScheduler.IScheduledInvocationListener: die zu informierenden ICommandScheduler.IScheduledInvocationListener
device ITestDevice: die zu verwendende ITestDevice
args String: die Befehlsargumente
Ausgabe
ConfigurationException Befehl war ungültig

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Entsprechenden CommandFileWatcher für diesen Planer abrufen

Returns
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Gibt die Anzahl der Befehle im Ausführungsstatus zurück.

Returns
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Gibt die Informationen zu einem Aufruf zurück, indem die Aufruf-ID angegeben wird.

Parameter
invocationId int: die Tracking-ID des Aufrufs.
Returns
String Ein String mit Informationen zum Aufruf.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Gibt den Fehlercode des letzten ausgeführten Aufrufs zurück. Gibt 0 (kein Fehler) zurück, wenn noch kein Aufruf ausgeführt wurde.

Returns
CommandRunner.ExitCode

getLastInvocationThrowable (GetLastInvocationThrowable)

public abstract Throwable getLastInvocationThrowable ()

Gibt das Throwable des letzten ausgeführten Aufrufs zurück. Gibt null zurück, wenn kein Wurfgerät verfügbar ist.

Returns
Throwable

getReadyCommandCount (Anzahl der Bereitschaftsbefehle)

public abstract int getReadyCommandCount ()

Gibt die Anzahl der Befehle im Status „Bereit“ in der Warteschlange zurück.

Returns
int

HandoverInitiationAbgeschlossen

public abstract void handoverInitiationComplete ()

Informiert den Befehlsplaner über den ersten Handover-Austausch der verwendeten Geräte und Befehle abgeschlossen ist und mit der Planung beginnen kann.

handoverHerunterfahren

public abstract boolean handoverShutdown (int handoverPort)

Initiiert ein shutdown() und eine Übergabe an einen anderen Tradef-Prozess auf demselben Host.

Der Planer informiert den Remote-Tradef-Prozess, der diesen Port der freigegebenen Geräte überwacht. sobald sie verfügbar sind.

Parameter
handoverPort int

Returns
boolean true, wenn die Handover-Initiierung erfolgreich war, false sonst

zu betreten

public abstract void join ()

Wartet auf den Abschluss des Planers.

Weitere Informationen:

zu betreten

public abstract void join (long millis)

Wartet auf den Abschluss des Planers oder auf das Zeitlimit nach dem angegebenen Zeitraum in Millisekunden.

Parameter
millis long

Weitere Informationen:

removeAllCommands

public abstract void removeAllCommands ()

Alle Befehle aus dem Planer entfernen

SetClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Den Kunden für die Berichterstellung über die Nutzungsdaten einrichten

Parameter
client ClearcutClient

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Gibt „true“ zurück, wenn der Planer bei einem Befehlsfehler heruntergefahren werden muss

Returns
boolean

herunterfahren

public abstract void shutdown ()

Versuchen Sie, den Befehlsplaner ordnungsgemäß herunterzufahren.

Löscht Befehle, die zum Testen warten, und fordert an, dass alle Aufrufe ausgeführt werden nicht ordnungsgemäß herunterfahren.

Nach dem Herunterfahren wartet die Planer-Hauptschleife auf alle laufenden Aufrufe. bevor Sie den Vorgang beenden.

Herunterfahren schwierig

public abstract void shutdownHard (boolean killAdb)

Versuchen Sie, das Herunterfahren des Befehlsplaners zu erzwingen.

Ähnlich wie „shutdown()“, beendet aber optional die ADB-Verbindung in einem „Inspirieren“ laufenden -Aufrufen schneller abgeschlossen.

Parameter
killAdb boolean

Herunterfahren schwierig

public abstract void shutdownHard ()

Versuchen Sie, das Herunterfahren des Befehlsplaners zu erzwingen. Entspricht ShutdownHard(true).

ShutdownOnEmpty

public abstract void shutdownOnEmpty ()

Ähnlich wie „shutdown()“, wird aber darauf gewartet, dass alle Befehle ausgeführt wurden bevor Sie die Seite verlassen.

Wenn sich Befehle im Schleifenmodus befinden, wird der Planer niemals beendet.

start

public abstract void start ()

Starten Sie ICommandScheduler.

Muss vor dem Aufruf anderer Methoden aufgerufen werden.

Wird ausgeführt, bis shutdown() aufgerufen wird. siehe Thread.start().

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Beenden Sie einen laufenden Aufruf, indem Sie seine ID angeben.

Parameter
invocationId int: die Tracking-ID des Aufrufs.
cause String: der Grund für das Beenden des Aufrufs.
Returns
boolean „true“, wenn der Aufruf beendet wurde, andernfalls „false“
Ausgabe
UnsupportedOperationException Wenn die Implementierung dies nicht unterstützt

stopInvocation

public boolean stopInvocation (int invocationId)

Beenden Sie einen laufenden Aufruf, indem Sie seine ID angeben.

Parameter
invocationId int

Returns
boolean „true“, wenn der Aufruf beendet wurde, andernfalls „false“
Ausgabe
UnsupportedOperationException Wenn die Implementierung dies nicht unterstützt

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

Beenden Sie einen laufenden Aufruf.

Parameter
invocation ITestInvocation

Returns
boolean „true“, wenn der Aufruf beendet wurde, andernfalls „false“
Ausgabe
UnsupportedOperationException Wenn die Implementierung dies nicht unterstützt