Tradefed 中的選項處理

選項處理方式是以貿易聯盟模組化的方式為核心。尤其是 是指開發人員、整合商和測試執行者在沒有必要的情況下共同運作的機制 因此不必複製彼此的工作簡單來說，我們實作的選項處理功能可讓開發人員將 Java 類別成員標示為可設定，這時整合器可以增強或覆寫該成員的值，之後再由測試執行程式增強或覆寫。此機制適用於所有 Java 內建函式型別，也適用於所有 內建函式類型的 Map 或 Collection 例項。

注意：選項處理機制只適用於實作 Test Lifecycle 中其中一個介面的類別，且只有在該類別由生命週期機制例項化時才有效。

開發人員

首先，開發人員會使用 @Option 註解標示成員。 它們至少指定 name 和 description 值， 指定與該選項相關聯的引數名稱，以及畫面上顯示的說明 透過 --help 或 --help-all 指令執行指令。

舉例來說，假設我們要建立一項功能正常的電話測試，讓不同的 電話號碼，並預期在之後能收到每個號碼的一系列 DTMF 音調 以獲得最佳效能和最安全的連線

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
    }

開發人員只需設定這兩個測試點，接著，他們可以照常使用 mWaitTime 和 mCalls，不必特別留意這兩者可設定的事實。由於 @Option 欄位是在類別例項化之後、但早於 系統會呼叫 run 方法，讓實作項目輕鬆設定 或對 Map 和 Collection 欄位執行某種篩選， 否則請設為「僅限附加」

整合服務商

整合器會處理以 XML 編寫的設定。設定格式 整合商可設定 (或附加) 任何 @Option 欄位的值。舉例來說，假設整合服務供應商想定義低延遲測試，以呼叫預設號碼，以及長時間執行的測試，以呼叫各種號碼。他們可以建立一組設定 可能如下所示：

<?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>

測試執行工具

測試執行工具也可以透過 Trade Federation 主控台存取這些設定點。首先，攻擊者會使用 run command <name> 指示 (簡稱 run <name>)。 此外，這些物件還可指定任何參數清單做為指令的一部分，以便取代或附加至各個設定內生命週期物件指定的欄位。

如要使用 many-numbers 電話號碼執行低延遲測試，測試執行者是 就可以執行：

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

或者，為了從相反方向取得類似效果，Test Runner 可以縮短 many-numbers 測試的等待時間：

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

選項排序

您可能會發現，基礎實作的 call 選項為 Map 因此，在指令列中重複 --call 時，所有資料都會儲存下來。

timeout 選項，具有 long 的基礎實作。 只能儲存一個值。因此，系統只會儲存指定的最後一個值。--timeout 5 --timeout 10 結果的 timeout 包含 10。

如果使用 List 或 Collection 做為基礎實作 系統會按照指令列中指定的順序儲存所有值。

布林選項

您可以直接將true 選項名稱 (例如 --[option-name]) 可設為 false 語法 --no-[option-name]

另請參閱