Fabryka konfiguracji

public class ConfigurationFactory
extends Object implements IConfigurationFactory

Obiekt Java.lang.Object
com.android.tradefed.config.ConfigurationFactory


Fabryka do tworzenia IConfiguration .

Streszczenie

Zagnieżdżone klasy

class ConfigurationFactory.ConfigLoader

Implementacja IConfigDefLoader, która śledzi dołączone konfiguracje z jednej konfiguracji głównej i zgłasza wyjątek w przypadku dołączań cyklicznych.

class ConfigurationFactory.ExceptionLoader

Konstruktorzy chronieni

ConfigurationFactory ()

Metody publiczne

void clearMapConfig ()

W pewnym konkretnym przypadku musimy wyczyścić mapę.

IConfiguration createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs) createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs)

Utwórz IConfiguration na podstawie argumentów wiersza poleceń.

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

Utwórz IConfiguration na podstawie argumentów wiersza poleceń z magazynem kluczy.

IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Wygodna metoda wywołująca ERROR(/#createConfigurationFromArgs(String[],List)) z drugim argumentem o null .

IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs) createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs)

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

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

Utwórz konfigurację zawierającą tylko zestaw wybranych obiektów.

void dumpConfig (String configName, PrintStream out)

Zrzuca zawartość konfiguracji do podanego ERROR(/PrintStream)

getConfigList (String subPath, boolean loadFromEnv)

Odmiana metody getConfigList() , w której można określić, czy chcemy również załadować konfigurację ze środowiska.

getConfigList ()

Zwróć listę nazw wszystkich konfiguracji znalezionych w plikach JAR w ścieżce klas.

static IConfigurationFactory getInstance ()

Pobierz instancję singletonu IConfigurationFactory .

void loadAllConfigs (boolean discardExceptions)

Ładuje wszystkie konfiguracje znalezione w katalogach ścieżek klas i przypadków testowych.

void loadAndPrintAllConfigs ()

Metoda narzędziowa sprawdzająca, czy wszystkie konfiguracje można załadować, przeanalizować i ustawić wszystkie wartości opcji.

void printHelp (PrintStream out)

Drukuje dane wyjściowe pomocy dla tej fabryki.

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

Drukuje pomoc dla IConfiguration określonej w argumentach wiersza poleceń,

Jeśli „args” odnosi się do znanej konfiguracji, obiekt IConfiguration zostanie utworzony z XML i zostanie wyświetlona pomoc dla tej IConfiguration .

Metody chronione

InputStream getBundledConfigStream (String name)
String getConfigPrefix ()

Zwróć prefiks ścieżki plików konfiguracyjnych xml w ścieżce klas

Ujawnione, aby testy jednostkowe mogły kpić.

BufferedInputStream getConfigStream (String name)

Ładuje strumień wejściowy dla podanej nazwy konfiguracji

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

Pobierz ConfigurationDef dla podanej nazwy

getMapConfig ()

Wystawiony do testów.

boolean isDirectConfiguration (String configName)
String[] reorderArgs (String[] args)

Zmień kolejność argumentów tak, aby wszystkie argumenty szablonu:mapy zostały przesunięte na przód.

IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, URI destDir)

Konstruktorzy chronieni

Fabryka konfiguracji

protected ConfigurationFactory ()

Metody publiczne

wyczyśćMapConfig

public void clearMapConfig ()

W pewnym konkretnym przypadku musimy wyczyścić mapę.

utwórz konfigurację z argumentów

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

Utwórz IConfiguration na podstawie argumentów wiersza poleceń.

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

Parametry
arrayArgs String : argumenty wiersza poleceń

unconsumedArgs : lista, która zostanie wypełniona argumentami, które nie zostały wykorzystane przez obiekty powiązane z określoną konfiguracją. Jeśli jest to null , implementacja zgłosi ConfigurationException , jeśli pozostaną nieprzetworzone argumenty.

Zwroty
IConfiguration załadowana IConfiguration . Pola Option obiektu delegowanego zostały wypełnione wartościami w argumentach.

Rzuca
ConfigurationException

utwórz konfigurację z argumentów

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

Utwórz IConfiguration na podstawie argumentów wiersza poleceń z magazynem kluczy.

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

Parametry
arrayArgs String : argumenty wiersza poleceń

unconsumedArgs : lista, która zostanie wypełniona argumentami, które nie zostały wykorzystane przez obiekty powiązane z określoną konfiguracją. Jeśli jest to null , implementacja zgłosi ConfigurationException , jeśli pozostaną nieprzetworzone argumenty.

keyStoreClient IKeyStoreClient : IKeyStoreClient , który służy do uzyskiwania poufnych informacji w argumentach.

Zwroty
IConfiguration załadowana IConfiguration . Pola Option obiektu delegowanego zostały wypełnione wartościami w argumentach.

Rzuca
ConfigurationException

utwórz konfigurację z argumentów

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Wygodna metoda wywołująca ERROR(/#createConfigurationFromArgs(String[],List)) z drugim argumentem o null . W związku z tym zgłosi wyjątek ConfigurationException , jeśli pozostaną jakieś niewykorzystane argumenty.

Parametry
arrayArgs String

Zwroty
IConfiguration

Rzuca
ConfigurationException

utwórzGlobalConfigurationFromArgs

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 konfiguracyjnego xml.

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 załadowany IGlobalConfiguration . Pola Option obiektu delegowanego zostały wypełnione wartościami w argumentach.

Rzuca
ConfigurationException

utwórzPartialConfigurationFromArgs

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

Utwórz konfigurację zawierającą tylko zestaw wybranych obiektów.

Parametry
arrayArgs String : Argumenty wiersza poleceń

keyStoreClient IKeyStoreClient : IKeyStoreClient , który jest używany do uzyskiwania poufnych informacji w argumentach.

allowedObjects : Zbiór dozwolonych obiektów, które mają zostać utworzone

delegator TradefedDelegator

Zwroty
IConfiguration Załadowany plik IConfiguration .

Rzuca
ConfigurationException

zrzut konfiguracji

public void dumpConfig (String configName, 
                PrintStream out)

Zrzuca zawartość konfiguracji do podanego ERROR(/PrintStream)

Parametry
configName String : nazwa konfiguracji

out PrintStream : ERROR(/PrintStream) do którego ma zostać zrzucony wynik

pobierz listę konfiguracji

public  getConfigList (String subPath, 
                boolean loadFromEnv)

Odmiana metody getConfigList() , w której można określić, czy chcemy również załadować konfigurację ze środowiska.

Parametry
subPath String : nazwa podkatalogów, w których należy szukać konfiguracji. Jeśli ma wartość null, będzie miało takie samo zachowanie jak getConfigList() .

loadFromEnv boolean : Prawda, jeśli powinniśmy załadować konfigurację do zmiennej środowiskowej.

Zwroty

pobierz listę konfiguracji

public  getConfigList ()

Zwróć listę nazw wszystkich konfiguracji znalezionych w plikach JAR w ścieżce klas. Nie próbuje załadować żadnej konfiguracji, więc możliwe jest, że na tej liście znajdują się niedziałające konfiguracje.

Zwroty

uzyskac instancje

public static IConfigurationFactory getInstance ()

Pobierz instancję singletonu IConfigurationFactory .

Zwroty
IConfigurationFactory

załaduj wszystkie konfiguracje

public void loadAllConfigs (boolean discardExceptions)

Ładuje wszystkie konfiguracje znalezione w katalogach ścieżek klas i przypadków testowych.

Parametry
discardExceptions boolean : true, jeśli jakikolwiek wyjątek ConfigurationException powinien zostać zignorowany.

Rzuca
com.android.tradefed.config.ConfigurationException
ConfigurationException

załadujAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

Metoda narzędziowa sprawdzająca, czy wszystkie konfiguracje można załadować, przeanalizować i ustawić wszystkie wartości opcji. Ujawnione tylko, aby zależny projekt mógł zweryfikować swoje konfiguracje. Nie powinno być widoczne w konsoli.

Rzuca
ConfigurationException jeśli nie udało się załadować jednej lub więcej konfiguracji

wydrukujPomoc

public void printHelp (PrintStream out)

Drukuje dane wyjściowe pomocy dla tej fabryki.

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

Parametry
out PrintStream : ERROR(/PrintStream) do którego ma zostać zrzucony wynik

printHelpForConfig

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

Drukuje pomoc dla IConfiguration określonej w argumentach wiersza poleceń,

Jeśli „args” odnosi się do znanej konfiguracji, obiekt IConfiguration zostanie utworzony z XML i zostanie wyświetlona pomoc dla tej IConfiguration . Należy zauważyć, że wszystkie inne wartości „args” zostaną zignorowane (tj. tekst pomocy będzie opisywał bieżące wartości Option s załadowane z XML i nie będzie odzwierciedlał wartości opcji ustawionych przez argumenty wiersza poleceń.

Jeśli „args” nie odwołuje się do znanej IConfiguration , zostanie wyświetlona ogólna pomoc printHelp(PrintStream) .

Parametry
args String : argumenty wiersza poleceń

importantOnly boolean : jeśli true , wypisz skróconą pomoc zawierającą tylko ważne szczegóły

out PrintStream : ERROR(/PrintStream) do którego ma zostać zrzucony wynik

Metody chronione

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Parametry
name String

Zwroty
InputStream

pobierzConfigPrefix

protected String getConfigPrefix ()

Zwróć prefiks ścieżki plików konfiguracyjnych xml w ścieżce klas

Ujawnione, aby testy jednostkowe mogły kpić.

Zwroty
String Ścieżka ciągu String z końcowym /

pobierz plik konfiguracyjny

protected BufferedInputStream getConfigStream (String name)

Ładuje strumień wejściowy dla podanej nazwy konfiguracji

Parametry
name String : nazwa konfiguracji do załadowania

Zwroty
BufferedInputStream ERROR(/BufferedInputStream) podczas odczytywania zawartości konfiguracji

Rzuca
ConfigurationException jeśli nie można znaleźć konfiguracji

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 konfiguracyjnego do załadowania

isGlobal boolean

templateMap

Zwroty
ConfigurationDef ConfigurationDef

Rzuca
ConfigurationException jeśli wystąpił błąd podczas ładowania pliku config

pobierzMapConfig

protected  getMapConfig ()

Wystawiony do testów. Zwróć kopię mapy.

Zwroty

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

Parametry
configName String

Zwroty
boolean

zmień kolejnośćArgs

protected String[] reorderArgs (String[] args)

Zmień kolejność argumentów tak, aby wszystkie argumenty szablonu:mapy zostały przesunięte na przód.

Parametry
args String

Zwroty
String[]

rozwiązać plik zdalny

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

Parametry
configURI URI

destDir URI

Zwroty
IRemoteFileResolver.ResolvedFile

Rzuca
BuildRetrievalError