IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration.


Eine Klasse, die globale Konfigurationsinformationen für eine einzelne Trade Federation-Instanz umfasst (umfasst eine beliebige Anzahl von Aufrufen von tatsächlichen Konfigurationen).

Zusammenfassung

Öffentliche Methoden

abstract void cleanup()

Ordnungsgemäße Bereinigung beim Herunterfahren von Tradef

abstract File cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs)

Filtern Sie die GlobalConfiguration anhand einer weißen Liste und geben Sie sie in einer XML-Datei aus.

abstract File cloneConfigWithFilter( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)

Filtern Sie die GlobalConfiguration anhand einer weißen Liste und lassen Sie gleichzeitig und die Ausgabe in einer XML-Datei vornehmen.

abstract File cloneConfigWithFilter(String... allowlistConfigs)

Filtern Sie die GlobalConfiguration anhand einer zulässigen Liste und geben Sie sie in eine XML-Datei aus.

abstract ICommandScheduler getCommandScheduler()

Ruft die ICommandScheduler ab, die aus der Konfiguration verwendet werden soll.

abstract Object getConfigurationObject(String typeName)

Ruft das benutzerdefinierte Konfigurationsobjekt mit dem angegebenen Namen ab.

abstract ICredentialFactory getCredentialFactory()

Ruft den ICredentialFactory zum Erstellen von Anmeldedaten ab.

abstract DeviceManagementGrpcServer getDeviceManagementServer()

Gibt den DeviceManagementGrpcServer zurück oder null, wenn nicht definiert.

abstract IDeviceManager getDeviceManager()

Ruft die IDeviceManager ab, die aus der Konfiguration verwendet werden soll.

abstract getDeviceMonitors()

Ruft die Liste von IDeviceMonitor aus der globalen Konfiguration ab.

abstract IDeviceSelection getDeviceRequirements()

Ruft die IDeviceSelection ab, die aus der Konfiguration verwendet werden soll.

abstract TradefedFeatureServer getFeatureServer()

Gibt den TradefedFeatureServer zurück oder null, wenn nicht definiert.

abstract IConfigurationServer getGlobalConfigServer()

Ruft den globalen Konfigurationsserver ab.

abstract getHostMonitors()

Ruft die Liste von IHostMonitor aus der globalen Konfiguration ab.

abstract IHostOptions getHostOptions()

Ruft die IHostOptions ab, die aus der Konfiguration verwendet werden soll.

abstract IHostResourceManager getHostResourceManager()

Ruft den IHostResourceManager aus der globalen Konfiguration ab.

abstract IKeyStoreFactory getKeyStoreFactory()

Ruft die IKeyStoreFactory ab, die aus der Konfiguration verwendet werden soll.

abstract getMultiDeviceRecoveryHandlers()

Ruft die Liste der zu verwendenden IMultiDeviceRecovery aus der Konfiguration ab.

abstract getOptionValues(String optionName)

Rufen Sie eine Liste der Werte der Option ab.

abstract getResourceMetricCollectors()

Ruft die Liste von IResourceMetricCollector aus der globalen Konfiguration ab.

abstract ISandboxFactory getSandboxFactory()

Sandbox Factory abrufen, die zum Ausführen eines Aufrufs verwendet werden kann

abstract IShardHelper getShardingStrategy()

Gibt die IShardHelper zurück, die definiert, wie eine Konfiguration fragmentiert werden soll.

abstract TestInvocationManagementServer getTestInvocationManagementSever()

Gibt den TestInvocationManagementServer zurück oder null, wenn nicht definiert.

abstract ITerribleFailureHandler getWtfHandler()

Ruft die ITerribleFailureHandler ab, die aus der Konfiguration verwendet werden soll.

abstract void injectOptionValue(String optionName, String optionValue)

Fügen Sie einen Optionswert in die Gruppe von Konfigurationsobjekten ein.

abstract void injectOptionValue(String optionName, String optionKey, String optionValue)

Fügen Sie einen Optionswert in die Gruppe von Konfigurationsobjekten ein.

abstract void setCommandScheduler(ICommandScheduler scheduler)

Legen Sie ICommandScheduler fest und ersetzen Sie alle vorhandenen Werte.

abstract void setConfigurationFactory(IConfigurationFactory configFactory)

Legen Sie den IConfigurationFactory für diese Konfiguration fest.

abstract void setConfigurationObject(String name, Object configObject)

Generische Methode zum Festlegen des Konfigurationsobjekts mit dem angegebenen Namen, wobei ein vorhandener Wert ersetzt wird.

abstract void setConfigurationObjectList(String typeName, configList)

Generische Methode zum Festlegen der Konfigurationsobjektliste für den angegebenen Namen, wodurch alle vorhandenen ersetzt werden Wert.

abstract void setDeviceManagementServer(DeviceManagementGrpcServer server)

Legt die DeviceManagementGrpcServer fest.

abstract void setDeviceManager(IDeviceManager deviceManager)

Legen Sie IDeviceManager fest und ersetzen Sie alle vorhandenen Werte.

abstract void setDeviceMonitor(IDeviceMonitor deviceMonitor)

Legen Sie IDeviceMonitor fest.

abstract void setDeviceRequirements(IDeviceSelection deviceSelection)

Legen Sie IDeviceSelection fest und ersetzen Sie alle vorhandenen Werte.

abstract void setHostMonitors( hostMonitors)

Legen Sie die IHostMonitor-Liste fest.

abstract void setHostOptions(IHostOptions hostOptions)

Legen Sie IHostOptions fest und ersetzen Sie alle vorhandenen Werte.

abstract void setHostResourceManager(IHostResourceManager hostResourceManager)

Legen Sie IHostResourceManager fest und ersetzen Sie alle vorhandenen Werte.

abstract void setInvocationServer(TestInvocationManagementServer server)

Legt die TestInvocationManagementServer fest.

abstract void setKeyStoreFactory(IKeyStoreFactory factory)

Legen Sie IKeyStoreFactory fest und ersetzen Sie alle vorhandenen Werte.

abstract setOptionsFromCommandLineArgs( listArgs)

Legen Sie die globalen Option-Konfigurationsfelder mit dem angegebenen Satz von Befehlszeilenargumenten fest

Das erwartete Format findest du unter ArgsOptionParser

abstract void setOriginalConfig(String config)

Legt die ursprüngliche Konfiguration fest, die zum Erstellen der globalen Konfiguration verwendet wurde.

abstract void setResourceMetricCollector(IResourceMetricCollector collector)

Legt die IResourceMetricCollector fest.

abstract void setSandboxFactory(ISandboxFactory factory)

Legen Sie ISandboxFactory fest und ersetzen Sie alle vorhandenen Werte.

abstract void setShardingStrategy(IShardHelper sharding)

Legt die IShardHelper fest, die beim Fragmentieren einer Konfiguration verwendet werden soll.

abstract void setTradefedFeatureServer(TradefedFeatureServer server)

Legt die TradefedFeatureServer fest.

abstract void setWtfHandler(ITerribleFailureHandler wtfHandler)

Legen Sie ITerribleFailureHandler fest.

abstract void setup()

Korrekte Einrichtung zu Beginn des Trade-Fs

abstract void validateOptions()

Validiert Optionswerte.

Öffentliche Methoden

Bereinigung

public abstract void cleanup ()

Ordnungsgemäße Bereinigung beim Herunterfahren von Tradef

KlonConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                String... allowlistConfigs)

Filtern Sie die GlobalConfiguration anhand einer weißen Liste und geben Sie sie in einer XML-Datei aus.

Parameter
exclusionPatterns : Das Muster des Klassennamens, der aus dem Dump ausgeschlossen werden soll.

allowlistConfigs String: Ein String-Array von Konfigurationen, die in die neue XML-Datei aufgenommen werden sollen. Wenn es auf null, a default list should be used.

gesetzt ist
Returns
File Die Datei mit der neuen gefilterten globalen Konfiguration.

Ausgabe
IOException

Weitere Informationen:

KlonConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

Filtern Sie die GlobalConfiguration anhand einer weißen Liste und lassen Sie gleichzeitig und die Ausgabe in einer XML-Datei vornehmen.

Parameter
exclusionPatterns : Das Muster des Klassennamens, der aus dem Dump ausgeschlossen werden soll.

transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String: ein String-Array von Konfigurationen, die in die neue XML-Datei aufgenommen werden sollen -Datei. Wenn es auf null, a default list should be used.

gesetzt ist
Returns
File Die Datei mit der neuen gefilterten globalen Konfiguration.

Weitere Informationen:

KlonConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

Filtern Sie die GlobalConfiguration anhand einer zulässigen Liste und geben Sie sie in eine XML-Datei aus.

Zum Beispiel für die folgende Konfiguration: <xml> <configuration> <device_monitor class="com.android.tradefed.device.DeviceMonitorMultiplexer" /> <wtf_handler class="com.android.tradefed.log.TerribleFailureEmailHandler" /> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

alle Konfigurationen außer „key_store“ wird herausgefiltert und es entsteht eine Konfigurationsdatei mit folgenden Inhalt: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Parameter
allowlistConfigs String: Ein String-Array von Konfigurationen, die in die neue XML-Datei aufgenommen werden sollen. Wenn es auf null, a default list should be used.

gesetzt ist
Returns
File Die Datei mit der neuen gefilterten globalen Konfiguration.

Ausgabe
IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Ruft die ICommandScheduler ab, die aus der Konfiguration verwendet werden soll.

Returns
ICommandScheduler ICommandScheduler. Gibt nie null zurück.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

Ruft das benutzerdefinierte Konfigurationsobjekt mit dem angegebenen Namen ab.

Parameter
typeName String: der eindeutige Typ des Konfigurationsobjekts

Returns
Object Das Objekt oder null, wenn das Objekt mit diesem Namen nicht gefunden wird

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

Ruft den ICredentialFactory zum Erstellen von Anmeldedaten ab.

Returns
ICredentialFactory ICredentialFactory oder null, wenn kein Wert angegeben wurde.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Gibt den DeviceManagementGrpcServer zurück oder null, wenn nicht definiert.

Returns
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

Ruft die IDeviceManager ab, die aus der Konfiguration verwendet werden soll. Verwaltet die Menge der verfügbaren Geräte zum Testen

Returns
IDeviceManager Das in der Konfiguration angegebene IDeviceManager.

getDeviceMonitors

public abstract  getDeviceMonitors ()

Ruft die Liste von IDeviceMonitor aus der globalen Konfiguration ab.

Returns
die Liste von IDeviceMonitor aus der globalen Konfiguration oder null, wenn Es wurde keine angegeben.

getDevicerequirements

public abstract IDeviceSelection getDeviceRequirements ()

Ruft die IDeviceSelection ab, die aus der Konfiguration verwendet werden soll. Stellt einen globalen Filter dar auf welchen Geräten DeviceManager sehen kann.

Returns
IDeviceSelection Das in der Konfiguration angegebene IDeviceSelection.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

Gibt den TradefedFeatureServer zurück oder null, wenn nicht definiert.

Returns
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

Ruft den globalen Konfigurationsserver ab. Mit dem globalen Konfigurationsserver werden Hostkonfigurationen von einem Server abgerufen anstatt aus lokalen Dateien zu erhalten.

Returns
IConfigurationServer

getHostMonitors

public abstract  getHostMonitors ()

Ruft die Liste von IHostMonitor aus der globalen Konfiguration ab.

Returns
die Liste von IHostMonitor aus der globalen Konfiguration oder null, wenn keine angegeben wurde.

getHostOptions

public abstract IHostOptions getHostOptions ()

Ruft die IHostOptions ab, die aus der Konfiguration verwendet werden soll.

Returns
IHostOptions Das in der Konfiguration angegebene IDeviceManager.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Ruft den IHostResourceManager aus der globalen Konfiguration ab.

Returns
IHostResourceManager den IHostResourceManager aus der globalen Konfiguration oder der Standardimplementierung LocalHostResourceManager, wenn in der Hostkonfiguration keiner angegeben ist.

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

Ruft die IKeyStoreFactory ab, die aus der Konfiguration verwendet werden soll.

Returns
IKeyStoreFactory IKeyStoreFactory oder null, wenn keine Schlüsselspeicher-Factory festgelegt ist.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

Ruft die Liste der zu verwendenden IMultiDeviceRecovery aus der Konfiguration ab.

Returns
die Liste von IMultiDeviceRecovery oder null, falls nicht festgelegt.

getOptionValues

public abstract  getOptionValues (String optionName)

Rufen Sie eine Liste der Werte der Option ab.

Parameter
optionName String: der Name der Kartenoption

Returns
eine Liste der Werte der angegebenen Option. null, wenn der Optionsname nicht existieren.

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

Ruft die Liste von IResourceMetricCollector aus der globalen Konfiguration ab.

Returns
Die Liste von IResourceMetricCollector aus der globalen Konfiguration oder null , wenn kein Wert angegeben wurde.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

Sandbox Factory abrufen, die zum Ausführen eines Aufrufs verwendet werden kann

Returns
ISandboxFactory

GetShardingStrategie

public abstract IShardHelper getShardingStrategy ()

Gibt die IShardHelper zurück, die definiert, wie eine Konfiguration fragmentiert werden soll.

Returns
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Gibt den TestInvocationManagementServer zurück oder null, wenn nicht definiert.

Returns
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

Ruft die ITerribleFailureHandler ab, die aus der Konfiguration verwendet werden soll. wickelt die Vorgehensweise für den Fall ab, dass eine WTF (What a Terrible Failure) erfolgt.

Returns
ITerribleFailureHandler die ITerribleFailureHandler im Konfiguration oder null, wenn kein Handler festgelegt ist.

InjectionOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

Fügen Sie einen Optionswert in die Gruppe von Konfigurationsobjekten ein.

Nützlich, um Werte für Optionen bereitzustellen, die dynamisch generiert werden.

Parameter
optionName String: der Name der Option

optionValue String: die Optionswerte

Ausgabe
ConfigurationException Wert der Option konnte nicht festgelegt werden

InjectionOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionKey, 
                String optionValue)

Fügen Sie einen Optionswert in die Gruppe von Konfigurationsobjekten ein.

Nützlich, um Werte für Optionen bereitzustellen, die dynamisch generiert werden.

Parameter
optionName String: der Name der Kartenoption

optionKey String: der Kartenoptionsschlüssel

optionValue String: der Wert der Kartenoption

Ausgabe
ConfigurationException Wert der Option konnte nicht festgelegt werden

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

Legen Sie ICommandScheduler fest und ersetzen Sie alle vorhandenen Werte.

setConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

Legen Sie den IConfigurationFactory für diese Konfiguration fest.

Parameter
configFactory IConfigurationFactory

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

Generische Methode zum Festlegen des Konfigurationsobjekts mit dem angegebenen Namen, wobei ein vorhandener Wert ersetzt wird.

Parameter
name String: der eindeutige Name des Konfigurationsobjekttyps

configObject Object: das Konfigurationsobjekt

Ausgabe
ConfigurationException wenn das configObject nicht vom richtigen Typ war

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

Generische Methode zum Festlegen der Konfigurationsobjektliste für den angegebenen Namen, wodurch alle vorhandenen ersetzt werden Wert.

Parameter
typeName String: der eindeutige Name des Konfigurationsobjekttyps

configList : die Liste der Konfigurationsobjekte

Ausgabe
ConfigurationException Objekte in der Liste sind nicht vom richtigen Typ.

setDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

Legt die DeviceManagementGrpcServer fest.

Parameter
server DeviceManagementGrpcServer

Gerätemanager festlegen

public abstract void setDeviceManager (IDeviceManager deviceManager)

Legen Sie IDeviceManager fest und ersetzen Sie alle vorhandenen Werte. Dadurch wird der Manager für das Testgeräte

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Legen Sie IDeviceMonitor fest.

Parameter
deviceMonitor IDeviceMonitor: Der Monitor

Ausgabe
ConfigurationException wenn bereits ein IDeviceMonitor festgelegt wurde.

setDevicerequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Legen Sie IDeviceSelection fest und ersetzen Sie alle vorhandenen Werte. Dadurch wird ein globales Gerät festgelegt. Filter dazu, welche Geräte DeviceManager sehen kann.

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

Legen Sie die IHostMonitor-Liste fest.

Parameter
hostMonitors : Liste der Monitore

Ausgabe
ConfigurationException wenn bereits ein IHostMonitor festgelegt wurde.

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

Legen Sie IHostOptions fest und ersetzen Sie alle vorhandenen Werte.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

Legen Sie IHostResourceManager fest und ersetzen Sie alle vorhandenen Werte.

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

Legt die TestInvocationManagementServer fest.

Parameter
server TestInvocationManagementServer

SetKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Legen Sie IKeyStoreFactory fest und ersetzen Sie alle vorhandenen Werte.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

Legen Sie die globalen Option-Konfigurationsfelder mit dem angegebenen Satz von Befehlszeilenargumenten fest

Das erwartete Format findest du unter ArgsOptionParser

Parameter
listArgs : die Befehlszeilenargumente

Returns
nicht verbrauchten Argumenten

Ausgabe
ConfigurationException

SetOriginalConfig

public abstract void setOriginalConfig (String config)

Legt die ursprüngliche Konfiguration fest, die zum Erstellen der globalen Konfiguration verwendet wurde.

Parameter
config String

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

Legt die IResourceMetricCollector fest.

Parameter
collector IResourceMetricCollector

SetSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

Legen Sie ISandboxFactory fest und ersetzen Sie alle vorhandenen Werte.

SetShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

Legt die IShardHelper fest, die beim Fragmentieren einer Konfiguration verwendet werden soll.

Parameter
sharding IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

Legt die TradefedFeatureServer fest.

Parameter
server TradefedFeatureServer

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

Legen Sie ITerribleFailureHandler fest.

Parameter
wtfHandler ITerribleFailureHandler: der WTF-Handler

Ausgabe
ConfigurationException wenn ein ITerribleFailureHandler festgelegt ist.

einrichten

public abstract void setup ()

Korrekte Einrichtung zu Beginn des Trade-Fs

Ausgabe
com.android.tradefed.config.ConfigurationException
ConfigurationException

validOptions

public abstract void validateOptions ()

Validiert Optionswerte.

Derzeit wird nur überprüft, ob alle obligatorischen Optionen festgelegt wurden

Ausgabe
ConfigurationException Wenn in der Konfiguration Pflichtfelder fehlen