IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration

Bekannte indirekte Unterklassen GlobalConfiguration GlobalConfiguration Eine IGlobalConfiguration-Implementierung, die die geladenen Konfigurationsobjekte in einer Map speichert

---

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 nach dem Tradefed-Shutdown
abstract File	cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs) Filtern Sie die GlobalConfiguration anhand einer Zulassungsliste und geben Sie die Ausgabe in eine XML-Datei aus.
abstract File	cloneConfigWithFilter( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) Filtern Sie die GlobalConfiguration anhand einer Zulassungsliste, während Optionswerte manipuliert und in eine XML-Datei ausgegeben werden können.
abstract File	cloneConfigWithFilter(String... allowlistConfigs) Filtern Sie die GlobalConfiguration anhand einer Zulassungsliste und geben Sie die Ausgabe in eine XML-Datei aus.
abstract ICommandScheduler	getCommandScheduler() Ruft die zu verwendende ICommandScheduler aus der Konfiguration ab.
abstract Object	getConfigurationObject(String typeName) Ruft das benutzerdefinierte Konfigurationsobjekt mit dem angegebenen Namen ab.
abstract ICredentialFactory	getCredentialFactory() Ruft die ICredentialFactory zum Erstellen von Anmeldedaten ab.
abstract DeviceManagementGrpcServer	getDeviceManagementServer() Gibt 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 zu verwendende IDeviceSelection aus der Konfiguration ab.
abstract TradefedFeatureServer	getFeatureServer() Gibt 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 zu verwendende IHostOptions aus der Konfiguration ab.
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) Liste der Werte der Option abrufen
abstract	getResourceMetricCollectors() Ruft die Liste von IResourceMetricCollector aus der globalen Konfiguration ab.
abstract ISandboxFactory	getSandboxFactory() Sandbox-Factory abrufen, mit der eine Aufrufanfrage ausgeführt werden kann
abstract IShardHelper	getShardingStrategy() Gibt das IShardHelper zurück, das die Sharding-Methode für eine Konfiguration definiert.
abstract TestInvocationManagementServer	getTestInvocationManagementSever() Gibt TestInvocationManagementServer zurück oder null, wenn nicht definiert.
abstract ITerribleFailureHandler	getWtfHandler() Ruft die zu verwendende ITerribleFailureHandler aus der Konfiguration ab.
abstract void	injectOptionValue(String optionName, String optionValue) Einen Optionswert in die Konfigurationsobjekte einfügen
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 die IConfigurationFactory für diese Konfiguration fest.
abstract void	setConfigurationObject(String name, Object configObject) Generische Methode zum Festlegen des Konfigurationsobjekts mit dem angegebenen Namen, wobei alle vorhandenen Werte ersetzt werden.
abstract void	setConfigurationObjectList(String typeName, configList) Generische Methode zum Festlegen der Liste der Konfigurationsobjekte für den angegebenen Namen, wobei alle vorhandenen Werte ersetzt werden.
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 Liste IHostMonitor 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 TestInvocationManagementServer fest.
abstract void	setKeyStoreFactory(IKeyStoreFactory factory) Legen Sie IKeyStoreFactory fest und ersetzen Sie alle vorhandenen Werte.
abstract	setOptionsFromCommandLineArgs( listArgs) Globale Option-Konfigurationsfelder mit bestimmten Befehlszeilenargumenten festlegen Informationen zum erwarteten Format finden Sie 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 den IShardHelper fest, der beim Sharding einer Konfiguration verwendet werden soll.
abstract void	setTradefedFeatureServer(TradefedFeatureServer server) Legt TradefedFeatureServer fest.
abstract void	setWtfHandler(ITerribleFailureHandler wtfHandler) Legen Sie ITerribleFailureHandler fest.
abstract void	setup() Korrekte Einrichtung zu Beginn von tradefed.
abstract void	validateOptions() Optionswerte prüfen

Öffentliche Methoden

cleanup

public abstract void cleanup ()

Ordnungsgemäße Bereinigung beim Herunterfahren von Tradef

cloneConfigWithFilter

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

Filtern Sie die GlobalConfiguration anhand einer Zulassungsliste und geben Sie die Ausgabe in eine 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. festgelegt ist

Returns
File	Die Datei mit der neuen gefilterten globalen Konfiguration.

Ausgabe
	IOException

Weitere Informationen

• cloneConfigWithFilter(String)

KlonConfigWithFilter

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

Filtern Sie die GlobalConfiguration anhand einer Zulassungsliste, während Optionswerte manipuliert und in eine XML-Datei ausgegeben werden können.

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. Wenn es auf null, a default list should be used. gesetzt ist

Returns
File	Die Datei mit der neuen gefilterten globalen Konfiguration.

Weitere Informationen

• cloneConfigWithFilter(String)

cloneConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

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

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 Konfigurationselemente mit Ausnahme von „key_store“ werden herausgefiltert. Die resultierende Konfigurationsdatei enthält dann den 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. festgelegt ist

Returns
File	Die Datei mit der neuen gefilterten globalen Konfiguration.

Ausgabe
	IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Ruft die zu verwendende ICommandScheduler aus der Konfiguration ab.

Returns
ICommandScheduler	die ICommandScheduler. Gibt niemals 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 die ICredentialFactory zum Erstellen von Anmeldedaten ab.

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

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

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

Returns
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

Ruft die zu verwendende IDeviceManager aus der Konfiguration ab. Verwaltet die verfügbaren Geräte für Tests

Returns
IDeviceManager	der in der Konfiguration angegebene IDeviceManager.

getDeviceMonitors

public abstract  getDeviceMonitors ()

Ruft die Liste von IDeviceMonitor aus der globalen Konfiguration ab.

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

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

Ruft die zu verwendende IDeviceSelection aus der Konfiguration ab. Stellt einen globalen Filter dar, der festlegt, auf welchen Geräten die DeviceManager angezeigt werden kann.

Returns
IDeviceSelection	der in der Konfiguration angegebene IDeviceSelection.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

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

Returns
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

Ruft den globalen Konfigurationsserver ab. Über den globalen Konfigurationsserver werden Hostkonfigurationen von einem Server abgerufen, anstatt von lokalen Dateien.

Returns
IConfigurationServer

getHostMonitors

public abstract  getHostMonitors ()

Ruft die Liste der IHostMonitor aus der globalen Konfiguration ab.

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

getHostOptions

public abstract IHostOptions getHostOptions ()

Ruft die zu verwendende IHostOptions aus der Konfiguration ab.

Returns
IHostOptions	Das in der Konfiguration angegebene IDeviceManager.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Ruft den IHostResourceManager aus der globalen Konfiguration ab.

Returns
IHostResourceManager	IHostResourceManager aus der globalen Konfiguration oder die Standardimplementierung LocalHostResourceManager, falls in der Hostkonfiguration keine angegeben ist.

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

Ruft die zu verwendende IKeyStoreFactory aus der Konfiguration ab.

Returns
IKeyStoreFactory	die IKeyStoreFactory oder „null“, wenn keine Schlüsselspeicher-Fabrik festgelegt ist.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

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

Returns
	die Liste von IMultiDeviceRecovery oder null, wenn sie nicht festgelegt ist.

getOptionValues

public abstract  getOptionValues (String optionName)

Rufen Sie eine Liste mit den Werten der Option ab.

Parameter
optionName	String: der Name der Kartenoption

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

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

Ruft die Liste der IResourceMetricCollector aus der globalen Konfiguration ab.

Returns
	die Liste der IResourceMetricCollector aus der globalen Konfiguration oder null , falls keine angegeben wurde.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

Sandbox-Factory abrufen, mit der eine Aufrufanfrage ausgeführt werden kann

Returns
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

Gibt das IShardHelper zurück, das die Fragmentierung der Konfiguration definiert.

Returns
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

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

Returns
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

Ruft die zu verwendende ITerribleFailureHandler aus der Konfiguration ab. Gibt an, was zu tun ist, wenn eine WTF-Datei (What a Terrible Failure) auftritt.

Returns
ITerribleFailureHandler	der in der Konfiguration angegebene ITerribleFailureHandler oder „null“, wenn kein Handler festgelegt ist

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

Einen Optionswert in die Konfigurationsobjekte einfügen

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

Parameter
optionName	String: der Name der Option
optionValue	String: die Optionswerte

Ausgabe
ConfigurationException	if failed to set the option's value

injectOptionValue

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

Einen Optionswert in die Konfigurationsobjekte einfügen

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

Parameter
optionName	String: der Name der Kartenoption
optionKey	String: der Schlüssel für die Kartenoption
optionValue	String: der Wert der Zuordnungsoption

Ausgabe
ConfigurationException	if failed to set the option's value

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 die 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 alle vorhandenen Werte ersetzt werden.

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 Liste der Konfigurationsobjekte für den angegebenen Namen, wobei alle vorhandenen Werte ersetzt werden.

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 DeviceManagementGrpcServer fest.

Parameter
server	DeviceManagementGrpcServer

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

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

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Legen Sie IDeviceMonitor fest.

Parameter
deviceMonitor	IDeviceMonitor: Der Monitor

Ausgabe
ConfigurationException	wenn bereits eine IDeviceMonitor festgelegt wurde.

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Legen Sie IDeviceSelection fest und ersetzen Sie alle vorhandenen Werte. Dadurch wird ein globaler Gerätefilter festgelegt, der festlegt, auf welchen Geräten die DeviceManager angezeigt werden kann.

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

Legen Sie die Liste IHostMonitor fest.

Parameter
hostMonitors	: Die 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 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	: 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 den IShardHelper fest, der beim Sharding einer Konfiguration verwendet werden soll.

Parameter
sharding	IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

Legt 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 bereits eine ITerribleFailureHandler festgelegt wurde.

einrichten

public abstract void setup ()

Korrekte Einrichtung zu Beginn von tradefed.

Ausgabe
	com.android.tradefed.config.ConfigurationException
ConfigurationException

validateOptions

public abstract void validateOptions ()

Validiert Optionswerte.

Derzeit wird nur geprüft, ob alle Pflichtoptionen festgelegt wurden.

Ausgabe
ConfigurationException	ob in der Konfiguration Pflichtfelder fehlen