Fabryka konfiguracji

public class ConfigurationFactory
extends Object implements IConfigurationFactory

java.lang.Obiekt
com.android.tradefed.config.ConfigurationFactory


Fabryka do tworzenia IConfiguration .

Streszczenie

Klasy zagnieżdżone

class ConfigurationFactory.ConfigLoader

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

class ConfigurationFactory.ExceptionLoader

Chronieni konstruktorzy

ConfigurationFactory ()

Metody publiczne

void clearMapConfig ()

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

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

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

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

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

IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Wygodna metoda, która wywołuje ERROR(/#createConfigurationFromArgs(String[],List)) z null drugim argumentem.

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 getConfigList() gdzie 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 pojedynczą instancję IConfigurationFactory .

void loadAllConfigs (boolean discardExceptions)

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

void loadAndPrintAllConfigs ()

Metoda narzędziowa, która sprawdza, 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 dane wyjściowe pomocy dla IConfiguration określonej w argumentach wiersza poleceń,

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

Metody chronione

InputStream getBundledConfigStream (String name)
String getConfigPrefix ()

Zwróć prefiks ścieżki plików config xml na ścieżce klasy

Odsłonięte, aby testy jednostkowe mogły kpić.

BufferedInputStream getConfigStream (String name)

Ładuje InputStream 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, aby wszystkie argumenty template:map zostały przesunięte na początek.

IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, URI destDir)

Chronieni konstruktorzy

Fabryka konfiguracji

protected ConfigurationFactory ()

Metody publiczne

wyczyśćMapConfig

public void clearMapConfig ()

W niektórych 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óre nie zostały wykorzystane przez obiekty powiązane z określoną konfiguracją. Jeśli to jest null , implementacja zgłosi ConfigurationException , jeśli pozostaną nieprzetworzone argumenty.

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

Rzuty
ConfigurationException

createConfigurationFromArgs

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

Utwórz IConfiguration z argumentów wiersza poleceń z magazynem 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óre nie zostały wykorzystane przez obiekty powiązane z określoną konfiguracją. Jeśli to jest null , implementacja zgłosi ConfigurationException , jeśli pozostaną nieprzetworzone argumenty.

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

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

Rzuty
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Wygodna metoda, która wywołuje ERROR(/#createConfigurationFromArgs(String[],List)) z null drugim argumentem. W ten sposób zgłosi ConfigurationException , 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 załadowany IGlobalConfiguration . Pola Option obiektu delegata zostały wypełnione wartościami w argumentach.

Rzuty
ConfigurationException

createPartialConfigurationFromArgs

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 : Zestaw dozwolonych obiektów do utworzenia

delegator TradefedDelegator

Zwroty
IConfiguration Załadowany IConfiguration .

Rzuty
ConfigurationException

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

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

Parametry
configName String : nazwa konfiguracji

out PrintStream : ERROR(/PrintStream) do zrzutu danych wyjściowych

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

Odmiana getConfigList() gdzie 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 null, będzie miał takie samo zachowanie jak getConfigList() .

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

Zwroty

getConfigList

public  getConfigList ()

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

Zwroty

uzyskac instancje

public static IConfigurationFactory getInstance ()

Pobierz pojedynczą instancję IConfigurationFactory .

Zwroty
IConfigurationFactory

ładuj wszystkie konfiguracje

public void loadAllConfigs (boolean discardExceptions)

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

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

Rzuty
com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

Metoda narzędziowa, która sprawdza, czy wszystkie konfiguracje można załadować, przeanalizować i ustawić wszystkie wartości opcji. Ujawnione tylko po to, aby zależne projekty mogły zweryfikować swoje konfiguracje. Nie powinien być widoczny w konsoli.

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

drukujPomoc

public void printHelp (PrintStream out)

Drukuje dane wyjściowe pomocy dla tej fabryki.

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

Parametry
out PrintStream : ERROR(/PrintStream) do zrzutu danych wyjściowych

printHelpForConfig

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

Drukuje dane wyjściowe pomocy dla IConfiguration określonej w argumentach wiersza poleceń,

Jeśli „args” odnosi się do znanej konfiguracji, obiekt IConfiguration zostanie utworzony na podstawie XML i zostanie wyświetlona pomoc dla tego IConfiguration . Zauważ, ż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 , wypisuje skróconą pomoc zawierającą tylko ważne szczegóły

out PrintStream : ERROR(/PrintStream) do zrzutu danych wyjściowych

Metody chronione

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Parametry
name String

Zwroty
InputStream

getConfigPrefix

protected String getConfigPrefix ()

Zwróć prefiks ścieżki plików config xml na ścieżce klasy

Odsłonięte, aby testy jednostkowe mogły kpić.

Zwroty
String ERROR(/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 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

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

getMapConfig

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, aby wszystkie argumenty template:map zostały przesunięte na początek.

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

Rzuty
BuildRetrievalError