Obsługa opcji w Tradefed

Obsługa opcji jest podstawą podejścia modułowego Trade Federation. W szczególności opcje to mechanizm, dzięki któremu programista, Integrator i Test Runner mogą współpracować bez konieczności dublowania pracy. Krótko mówiąc, nasza implementacja obsługi opcji umożliwia , aby oznaczyć członka klasy Java jako konfigurowalnego, co oznacza, że wartość tego elementu mogą zostać rozszerzone lub zastąpione przez integratora, a następnie mogą zostać rozszerzone lub zastąpione przez biegacza testowego. Mechanizm ten działa w przypadku wszystkich typów wbudowanych w Javie oraz Map lub Collection wystąpień typów wrodzonych.

Uwaga: mechanizm obsługi opcji działa tylko w przypadku klas. wdrożenia jednej z interfejsów uwzględnionych w cyklu życia testów i tylko wtedy, gdy ta klasa jest zainicjowane przez maszyny cyklu życia.

Programista

Na początek deweloper oznacza członka @Option adnotacja. Określają one (co najmniej) wartości name i description, które określają nazwę argumentu powiązanego z opcją, oraz opis wyświetlany w konsoli TF, gdy polecenie jest wykonywane za pomocą opcji --help lub --help-all.

Załóżmy, że chcemy utworzyć funkcjonalny test telefonu, który wybiera różne numery telefonów i po połączeniu oczekuje sekwencji DTMF z każdego z nich.

public class PhoneCallFuncTest extends IRemoteTest {
    @Option(name = "timeout", description = "How long to wait for connection, in millis")
    private long mWaitTime = 30 * 1000;  // 30 seconds

    @Option(name = "call", description = "Key: Phone number to attempt. " +
            "Value: DTMF to expect. May be repeated.")
    private Map<String, String> mCalls = new HashMap<String, String>;

    public PhoneCallFuncTest() {
        mCalls.add("123-456-7890", "01134");  // default
    }

To wszystko, co deweloper potrzebuje, aby skonfigurować 2 punkty konfiguracji test. Następnie mogą normalnie korzystać z usług mWaitTime i mCalls, Nie zwracając uwagi na to, że można je skonfigurować. Ponieważ Pola @Option są ustawiane po utworzeniu klasy, ale przed klasą Wywoływana jest metoda run, która umożliwia implementatorom łatwego konfigurowania ustawień domyślnych lub filtrowanie pól Map i Collection, które są w przeciwnym razie tylko dołączanie.

Producent

Integrator działa w świecie konfiguracji, które są zapisane w języku XML. Format konfiguracji umożliwia integratorowi ustawianie (lub dołączanie) wartości do dowolnego pola @Option. Przykład: Załóżmy, że integrator chciał zdefiniować test z krótszym czasem oczekiwania, który wywołuje numer domyślny, a także w ramach długotrwałego testu, który wywołuje różne numery. Mogą utworzyć parę konfiguracji, które mogą wyglądać tak:

<?xml version="1.0" encoding="utf-8"?>
<configuration description="low-latency default test; low-latency.xml">
    <test class="com.example.PhoneCallFuncTest">
        <option name="timeout" value="5000" />
    </test>
</configuration>

<?xml version="1.0" encoding="utf-8"?>
<configuration description="call a bunch of numbers; many-numbers.xml">
    <test class="com.example.PhoneCallFuncTest">
        <option name="call" key="111-111-1111" value="#*#*TEST1*#*#" />
        <option name="call" key="222-222-2222" value="#*#*TEST2*#*#" />
        <!-- ... -->
    </test>
</configuration>

Uruchamiający testy

Test Runner ma też dostęp do tych punktów konfiguracji w konsoli Trade Federation. Przede wszystkim wykonują polecenie (konfigurację i wszystkie jej argumenty) z poleceniem Instrukcja run command <name> (w skrócie run <name>). Mogą też podać dowolną listę argumentów jako część polecenia, które może zastąpić lub dodać do pól określonych przez obiekty cyklu życia w każdej konfiguracji.

Aby przeprowadzić test niskiego opóźnienia z numerami telefonów many-numbers, może wykonać:

tf> run low-latency.xml --call 111-111-1111 #*#*TEST1*#*# --call 222-222-2222 #*#*TEST2*#*#

Aby uzyskać podobny efekt w odwrotnym kierunku, można skrócić czas oczekiwania, czas testu many-numbers:

tf> run many-numbers.xml --timeout 5000

Kolejność opcji

Możesz zauważyć, że bazowa implementacja call to Map więc po powtórzeniu --call w wierszu poleceń zostaną one zapisane.

Opcja timeout, która ma implementację podrzędną long, może przechowywać tylko jedną wartość. Zachowywana jest więc tylko ostatnia określona wartość. Wynikiem --timeout 5 --timeout 10 jest timeout, które zawierają 10.

Jeśli podstawową implementacją jest List lub Collection, wszystkie wartości są przechowywane w kolejności określonej w wierszu poleceń.

Opcje wartości logicznej

Opcje typu logicznego można ustawić jako true, podając bezpośrednio nazwę opcji, np. --[option-name], i można je ustawić jako false, używając składni --no-[option-name].

Zobacz również