本頁面由 Cloud Translation API 翻譯而成。

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]

另請參閱

將選項傳遞至套件和模組