Penanganan opsi merupakan inti dari pendekatan modular Federasi Perdagangan. Secara khusus, opsi adalah mekanisme yang dengannya Pengembang, Integrator, dan Pelari Uji dapat bekerja sama tanpa harus menduplikasi pekerjaan satu sama lain. Sederhananya, penerapan penanganan opsi kami memungkinkan Pengembang untuk menandai anggota kelas Java sebagai dapat dikonfigurasi, yang pada titik mana nilai anggota tersebut dapat ditambah atau diganti oleh Integrator, dan selanjutnya dapat ditambah atau diganti oleh Test Runner. Mekanisme ini berfungsi untuk semua tipe intrinsik Java, serta untuk semua tipe intrinsik Map
s atau Collection
s.
Catatan: Mekanisme penanganan opsi hanya berfungsi untuk kelas yang mengimplementasikan salah satu antarmuka yang disertakan dalam Test Lifecycle , dan hanya jika kelas tersebut dibuat instance-nya oleh mesin siklus hidup.
Pengembang
Untuk memulai, pengembang menandai anggota dengan anotasi @Option
. Mereka menentukan (minimal) nilai name
dan description
, yang menentukan nama argumen yang terkait dengan Opsi tersebut, dan deskripsi yang akan ditampilkan di konsol TF ketika perintah dijalankan dengan --help
atau --help-all
.
Sebagai contoh, katakanlah kita ingin membuat pengujian telepon fungsional yang akan memanggil berbagai nomor telepon, dan mengharapkan untuk menerima rangkaian 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 Pengembang untuk menyiapkan dua titik konfigurasi untuk pengujian tersebut. Mereka kemudian dapat keluar dan menggunakan mWaitTime
dan mCalls
seperti biasa, tanpa terlalu memperhatikan fakta bahwa keduanya dapat dikonfigurasi. Karena bidang @Option
disetel setelah kelas dibuat instance-nya, namun sebelum metode run
dipanggil, hal ini memberikan cara mudah bagi pelaksana untuk menyiapkan default atau melakukan semacam pemfilteran pada bidang Map
dan Collection
, yang jika tidak ditambahkan akan ditambahkan. hanya.
Integrator
Integrator bekerja di dunia Konfigurasi, yang ditulis dalam XML. Format konfigurasi memungkinkan Integrator untuk menetapkan (atau menambahkan) nilai untuk bidang @Option
apa pun. Misalnya, Integrator ingin menentukan pengujian latensi rendah yang memanggil nomor default, serta pengujian jangka panjang 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>
Pelari Tes
Test Runner juga memiliki akses ke titik konfigurasi ini melalui konsol Federasi Perdagangan. Pertama dan terpenting, mereka akan menjalankan Perintah (yaitu, konfigurasi dan semua argumennya) dengan instruksi run command <name>
(atau disingkat run <name>
). Selain itu, mereka dapat menentukan daftar argumen apa pun yang merupakan bagian dari perintah, yang dapat menggantikan atau menambahkan bidang yang ditentukan oleh Objek Siklus Hidup dalam setiap konfigurasi.
Untuk menjalankan pengujian latensi rendah dengan many-numbers
nomor telepon, Test Runner dapat menjalankan:
tf> run low-latency.xml --call 111-111-1111 #*#*TEST1*#*# --call 222-222-2222 #*#*TEST2*#*#
Atau, untuk mendapatkan efek serupa dari arah berlawanan, Test Runner dapat mengurangi waktu tunggu untuk tes many-numbers
:
tf> run many-numbers.xml --timeout 5000
Pemesanan Opsi
Anda mungkin memperhatikan bahwa implementasi opsi call
yang mendasarinya adalah Map
sehingga setelah diulang --call
pada baris perintah, semuanya akan disimpan.
Opsi timeout
, yang memiliki implementasi dasar long
, hanya dapat menyimpan satu nilai. Jadi hanya nilai terakhir yang ditentukan yang akan disimpan. --timeout 5 --timeout 10
akan menghasilkan timeout
yang berisi 10.
Jika List
atau Collection
sebagai implementasi yang mendasarinya, semua nilai akan disimpan, dalam urutan yang ditentukan pada baris perintah.
Opsi Boolean
Opsi tipe dasar boolean dapat disetel ke true
dengan meneruskan nama opsi secara langsung, misalnya, --[option-name]
dan dapat disetel ke false
menggunakan sintaksis --no-[option-name]
.