ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

java.lang.Object
↳	com.android.tradefed.config.ConfigurationFactory

Znane bezpośrednie podklasy GCSConfigurationFactory, RetryConfigurationFactory, SandboxConfigurationFactory GCSConfigurationFactory ConfigurationFactory wczytuje konfiguracje z Google Cloud Storage.  RetryConfigurationFactory Fabryka obsługująca ponowne próby wykonania polecenia.  SandboxConfigurationFactory Specjalna fabryka konfiguracji do obsługi tworzenia konfiguracji na potrzeby piaskownicy.

---

Fabryka do tworzenia IConfiguration.

Podsumowanie

Zagnieżdżone klasy
class	ConfigurationFactory.ConfigLoader Implementacja interfejsu IConfigDefLoader, który śledzi uwzględnione konfiguracje z jednego pliku konfiguracji głównej i wyrzuca wyjątek w przypadku pętli uwzględnień.
class	ConfigurationFactory.ExceptionLoader

Chronione konstruktory
ConfigurationFactory()

Metody publiczne
void	clearMapConfig() W niektórych szczególnych przypadkach musimy wyczyścić mapę.
IConfiguration	createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs) Utwórz IConfiguration z argumentów wiersza poleceń.
IConfiguration	createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient) Utwórz IConfiguration z argumentów wiersza poleceń za pomocą repozytorium kluczy.
IConfiguration	createConfigurationFromArgs(String[] arrayArgs) Metoda ułatwiająca, która wywołuje ERROR(/#createConfigurationFromArgs(String[],List)) z drugim argumentem null.
IGlobalConfiguration	createGlobalConfigurationFromArgs(String[] arrayArgs, remainingArgs) Utwórz IGlobalConfiguration z argumentów wiersza poleceń.
IConfiguration	createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) Utwórz konfigurację zawierającą tylko wybrane obiekty.
void	dumpConfig(String configName, PrintStream out) Wyświetla zawartość konfiguracji w danym pliku ERROR(/PrintStream).
	getConfigList(String subPath, boolean loadFromEnv) Wariant getConfigList(), w którym można określić, czy chcemy wczytać konfigurację ze środowiska.
	getConfigList() Zwraca listę nazw wszystkich konfiguracji znalezionych w plikach JAR na ścieżce klas.
static IConfigurationFactory	getInstance() Pobierz instancję klasy typu singleton IConfigurationFactory.
void	loadAllConfigs(boolean discardExceptions) Ładuje wszystkie konfiguracje znalezione w katalogach classpath i test cases.
void	loadAndPrintAllConfigs() Metoda pomocnicza, która sprawdza, czy można wczytać i analizować wszystkie konfiguracje oraz czy są ustawione wszystkie wartości opcji.
void	printHelp(PrintStream out) Wypisuje informacje pomocy dla tej fabryki.
void	printHelpForConfig(String[] args, boolean importantOnly, PrintStream out) Wyświetla dane pomocy dotyczące IConfiguration określonego w argumentach wiersza poleceń. Jeśli argument „args” odwołuje się do znanej konfiguracji, zostanie utworzony obiekt IConfiguration na podstawie pliku XML i wyświetlona pomoc dotycząca tego obiektu.IConfiguration

Chronione metody
InputStream	getBundledConfigStream(String name)
String	getConfigPrefix() Zwraca prefiks ścieżki plików konfiguracji XML w ścieżce klas. Wyeksponowane, aby można było je zasymulować w testach jednostkowych.
BufferedInputStream	getConfigStream(String name) Ładuje InputStream dla podanej nazwy konfiguracji.
ConfigurationDef	getConfigurationDef(String name, boolean isGlobal, templateMap) Pobierz ConfigurationDef dla podanej nazwy.
	getMapConfig() Wyeksponowane do testowania.
boolean	isDirectConfiguration(String configName)
String[]	reorderArgs(String[] args) Zmień kolejność argumentów, tak aby argumenty mapy zostały przeniesione na początek.
IRemoteFileResolver.ResolvedFile	resolveRemoteFile(URI configURI, URI destDir)

Chronione konstruktory

ConfigurationFactory

protected ConfigurationFactory ()

Metody publiczne

clearMapConfig

public void clearMapConfig ()

W niektórych szczególnych przypadkach musimy wyczyścić mapę.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

Utwórz IConfiguration z argumentów wiersza poleceń.

Oczekiwany format to „CONFIG [opcje]”, gdzie CONFIG to wbudowana nazwa konfiguracji lub ścieżka do pliku XML konfiguracji.

Parametry
arrayArgs	String: argumenty wiersza poleceń
unconsumedArgs	: lista, która zostanie wypełniona argumentami, których nie wykorzystały Obiekty powiązane ze wskazaną konfiguracją. Jeśli to null, implementacja wyrzuci ConfigurationException, jeśli pozostaną jakieś nieprzetworzone argumenty.

Zwroty
IConfiguration	wczytany IConfiguration. Pola obiektu delegowana Option zostały wypełnione wartościami z argów.

Rzuty
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

Utwórz IConfiguration z argumentów wiersza poleceń za pomocą repozytorium kluczy.

Oczekiwany format to „CONFIG [opcje]”, gdzie CONFIG to wbudowana nazwa konfiguracji lub ścieżka do pliku XML konfiguracji.

Parametry
arrayArgs	String: argumenty wiersza poleceń
unconsumedArgs	: lista, która zostanie wypełniona argumentami, których nie wykorzystały Obiekty powiązane ze wskazaną konfiguracją. Jeśli to null, implementacja wyrzuci ConfigurationException, jeśli pozostaną jakieś nieprzetworzone argumenty.
keyStoreClient	IKeyStoreClient: IKeyStoreClient, który służy do uzyskiwania informacji poufnych w argumencie.

Zwroty
IConfiguration	wczytany IConfiguration. Pola obiektu delegowana Option zostały wypełnione wartościami z argów.

Rzuty
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Metoda ułatwiająca, która wywołuje ERROR(/#createConfigurationFromArgs(String[],List)) z drugim argumentem null. W związku z tym ConfigurationException zostanie wyrzucone, jeśli pozostaną niewykorzystane argumenty.

Parametry
arrayArgs	String

Zwroty
IConfiguration

Rzuty
ConfigurationException

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

Utwórz IGlobalConfiguration z argumentów wiersza poleceń.

Oczekiwany format to „CONFIG [opcje]”, gdzie CONFIG to wbudowana nazwa konfiguracji lub ścieżka do pliku XML konfiguracji.

Parametry
arrayArgs	String: argumenty wiersza poleceń
remainingArgs	: lista, która zostanie wypełniona argumentami, które nie zostały przetworzone jako argumenty globalne

Zwroty
IGlobalConfiguration	wczytany IGlobalConfiguration. Pola obiektu delegowana Option zostały wypełnione wartościami z argów.

Rzuty
ConfigurationException

createPartialConfigurationFromArgs

public IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                 allowedObjects, 
                TradefedDelegator delegator)

Utwórz konfigurację zawierającą tylko wybrane obiekty.

Parametry
arrayArgs	String: argumenty wiersza poleceń
keyStoreClient	IKeyStoreClient: IKeyStoreClient, który służy do uzyskiwania informacji poufnych w argumencie args.
allowedObjects	: zbiór dozwolonych obiektów do utworzenia.
delegator	TradefedDelegator

Zwroty
IConfiguration	Wczytany IConfiguration.

Rzuty
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

Wyświetla zawartość konfiguracji w danym pliku ERROR(/PrintStream).

Parametry
configName	String: nazwa konfiguracji
out	PrintStream: ERROR(/PrintStream), do którego mają być zapisywane dane wyjściowe

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

Wariant getConfigList(), w którym można określić, czy chcemy wczytać konfigurację ze środowiska.

Parametry
subPath	String: nazwa katalogów podrzędnych, w których należy szukać konfiguracji. Jeśli jest ustawiony na wartość null, będzie działać tak samo jak parametr getConfigList().
loadFromEnv	boolean: wartość PRAWDA, jeśli konfigurację należy załadować ze zmiennej środowiskowej.

Zwroty

getConfigList

public  getConfigList ()

Zwraca listę nazw wszystkich konfiguracji znalezionych w plikach JAR na ścieżce klas. Nie próbuje wczytać żadnej konfiguracji, więc na liście może się znaleźć niedziałająca konfiguracja.

Zwroty

getInstance

public static IConfigurationFactory getInstance ()

Pobierz instancję klasy typu singleton IConfigurationFactory.

Zwroty
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

Ładuje wszystkie konfiguracje znalezione w katalogach classpath i test cases.

Parametry
discardExceptions	boolean: wartość true, jeśli należy zignorować wszystkie wyjątki typu ConfigurationException.

Rzuty
	com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

Metoda pomocnicza, która sprawdza, czy można wczytać i analizować wszystkie konfiguracje oraz czy są ustawione wszystkie wartości opcji. Wyświetlane tylko po to, aby zależny projekt mógł zweryfikować konfigurację. Nie powinno być widoczne w konsoli.

Rzuty
ConfigurationException	jeśli nie udało się załadować co najmniej 1 konfiguracji

printHelp

public void printHelp (PrintStream out)

Wypisuje informacje pomocy dla tej fabryki.

Wypisuje ogólne informacje pomocy i wypisuje listę wszystkich dostępnych konfiguracji.

Parametry
out	PrintStream: ERROR(/PrintStream), do którego mają być zapisywane dane wyjściowe

printHelpForConfig

public void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

Wyświetla dane pomocy dotyczące IConfiguration określonego w argumentach wiersza poleceń.

Jeśli argument „args” odwołuje się do znanej konfiguracji, zostanie utworzony obiekt IConfiguration na podstawie pliku XML i wyświetlona pomoc dotycząca tego obiektu.IConfiguration Pamiętaj, że wszystkie inne wartości w argumencie „args” będą ignorowane (czyli tekst pomocy będzie opisywać bieżące wartości Options wczytane z pliku XML i nie będzie odzwierciedlać wartości opcji ustawionych w argumencie wiersza poleceń.

Jeśli argument „args” nie odwołuje się do znanego parametru IConfiguration, wyświetli się ogólna pomoc dotycząca parametru printHelp(PrintStream).

Parametry
args	String: argumenty wiersza poleceń
importantOnly	boolean: jeśli true, wydrukuj skróconą pomoc zawierającą tylko ważne informacje
out	PrintStream: ERROR(/PrintStream), do którego mają być zapisywane dane wyjściowe

Chronione metody

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Parametry
name	String

Zwroty
InputStream

getConfigPrefix

protected String getConfigPrefix ()

Zwraca prefiks ścieżki plików konfiguracji XML w ścieżce klas.

Wyeksponowane, aby można było je zasymulować w testach jednostkowych.

Zwroty
String	String ścieżka z końcowym /

getConfigStream

protected BufferedInputStream getConfigStream (String name)

Ładuje InputStream dla podanej nazwy konfiguracji.

Parametry
name	String: nazwa konfiguracji do załadowania

Zwroty
BufferedInputStream	ERROR(/BufferedInputStream) do odczytu zawartości konfiguracji.

Rzuty
ConfigurationException	if config could not be found

getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                 templateMap)

Pobierz ConfigurationDef dla podanej nazwy.

Parametry
name	String: nazwa wbudowanej konfiguracji do załadowania lub ścieżka do pliku konfiguracji do załadowania
isGlobal	boolean
templateMap

Zwroty
ConfigurationDef	ConfigurationDef

Rzuty
ConfigurationException	jeśli wystąpił błąd podczas wczytywania konfiguracji.

getMapConfig

protected  getMapConfig ()

Wyeksponowane do testowania. zwrócić kopię mapy;

Zwroty

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

Parametry
configName	String

Zwroty
boolean

reorderArgs

protected String[] reorderArgs (String[] args)

Zmień kolejność argumentów, tak aby argumenty mapy zostały przeniesione na początek.

Parametry
args	String

Zwroty
String[]

resolveRemoteFile

protected IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, 
                URI destDir)

Parametry
configURI	URI
destDir	URI

Zwroty
IRemoteFileResolver.ResolvedFile

Rzuty
BuildRetrievalError