Penanganan opsi di Tradefed

Penanganan opsi adalah inti dari pendekatan modular Trade Federation. Secara khusus, opsi adalah mekanisme yang memungkinkan developer, Integrator, dan Runner Uji Coba bekerja sama tanpa harus menduplikasi pekerjaan satu sama lain. Sederhananya, penerapan penanganan opsi kami memungkinkan developer menandai anggota class Java sebagai dapat dikonfigurasi, yang kemudian nilai anggota tersebut dapat ditambah atau diganti oleh Integrator, dan selanjutnya dapat ditambah atau diganti oleh Runner Uji Coba. Mekanisme ini berfungsi untuk semua jenis intrinsik Java, serta untuk instance Map atau Collection dari jenis intrinsik.

Catatan: Mekanisme penanganan opsi hanya berfungsi untuk class yang menerapkan salah satu antarmuka yang disertakan dalam Siklus Proses Pengujian, dan hanya saat class tersebut di-instance oleh mesin siklus proses.

Developer

Untuk memulai, developer menandai anggota dengan anotasi @Option. Mereka menentukan (minimal) nilai name dan description, yang menentukan nama argumen yang terkait dengan Opsi tersebut, dan deskripsi yang ditampilkan di konsol TF saat perintah dijalankan dengan --help atau --help-all.

Sebagai contoh, misalkan kita ingin membuat pengujian telepon fungsional yang memanggil berbagai nomor telepon, dan berharap menerima urutan nada DTMF dari setiap nomor setelah terhubung.

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
    }

Hanya itu yang diperlukan developer untuk menyiapkan dua titik konfigurasi untuk pengujian tersebut. Kemudian, mereka dapat menggunakan mWaitTime dan mCalls seperti biasa, tanpa terlalu memperhatikan fakta bahwa keduanya dapat dikonfigurasi. Karena kolom @Option ditetapkan setelah class di-instance, tetapi sebelum metode run dipanggil, hal ini memberikan cara mudah bagi pelaksana untuk menyiapkan nilai default atau melakukan semacam pemfilteran pada kolom Map dan Collection, yang hanya dapat ditambahkan.

Integrator

Integrator bekerja dalam dunia konfigurasi, yang ditulis dalam XML. Format konfigurasi memungkinkan Integrator menetapkan (atau menambahkan) nilai untuk kolom @Option apa pun. Misalnya, anggaplah Integrator ingin menentukan pengujian latensi rendah yang memanggil nomor default, serta pengujian yang berjalan lama yang memanggil berbagai nomor. Mereka dapat membuat sepasang konfigurasi yang mungkin terlihat seperti berikut:

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

Runner Uji Coba

Runner Uji Coba juga memiliki akses ke titik konfigurasi ini melalui konsol Trade Federation. Pertama dan terutama, mereka menjalankan perintah (yaitu, konfigurasi dan semua argumennya) dengan instruksi run command <name> (atau run <name> untuk singkatnya). Selain itu, mereka dapat menentukan daftar argumen apa pun yang merupakan bagian dari perintah, yang dapat mengganti atau menambahkan ke kolom yang ditentukan oleh objek siklus proses dalam setiap konfigurasi.

Untuk menjalankan pengujian latensi rendah dengan nomor telepon many-numbers, Runner Uji Coba dapat menjalankan:

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

Atau, untuk mendapatkan efek serupa dari arah yang berlawanan, Runner Uji Coba dapat mengurangi waktu tunggu untuk pengujian many-numbers:

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

Pengurutan opsi

Anda mungkin melihat bahwa implementasi yang mendasari opsi call adalah Map sehingga saat --call diulang pada command line, semuanya akan disimpan.

Opsi timeout, yang memiliki implementasi dasar long, hanya dapat menyimpan satu nilai. Jadi, hanya nilai terakhir yang ditentukan yang disimpan. --timeout 5 --timeout 10 menghasilkan timeout yang berisi 10.

Jika List atau Collection adalah implementasi yang mendasarinya, semua nilai akan disimpan, dalam urutan yang ditentukan di command line.

Opsi boolean

Opsi jenis dasar boolean dapat ditetapkan ke true dengan meneruskan nama opsi secara langsung, misalnya, --[option-name] dan dapat ditetapkan ke false menggunakan sintaksis --no-[option-name].

Lihat juga