Penanganan opsi merupakan inti pendekatan modular Trade Federation. Secara khusus, opsi
mekanisme yang memungkinkan Developer, Integrator, dan Test Runner dapat bekerja sama tanpa
harus menduplikasi pekerjaan satu sama lain. Sederhananya, implementasi penanganan opsi memungkinkan
Developer menandai anggota class Java sebagai dapat dikonfigurasi, yang pada saat itu nilai anggota tersebut dapat dikonfigurasi
dapat ditambah atau diganti oleh Integrator, dan mungkin kemudian ditambahkan atau diganti oleh
yaitu Test Runner. Mekanisme ini berfungsi untuk semua jenis intrinsik Java, serta untuk semua
Map
atau Collection
jenis intrinsik.
Catatan: Mekanisme penanganan opsi hanya berfungsi untuk class yang menerapkan salah satu disertakan dalam Siklus Proses Pengujian, dan hanya jika class tersebut dibuat instance oleh mesin siklus proses.
Developer
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
konsol TF saat perintah dijalankan dengan --help
atau --help-all
.
Misalnya, kita ingin membuat pengujian telepon fungsional yang akan memanggil berbagai nomor telepon Anda, dan mengharapkan untuk menerima urutan nada DTMF dari setiap nomor setelahnya menghubungkan Anda.
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 }
Itu saja yang diperlukan Developer untuk menyiapkan dua titik konfigurasi untuk
uji coba. Kemudian mereka dapat keluar dan menggunakan mWaitTime
dan mCalls
seperti biasa,
tanpa memperhatikan banyak fakta bahwa
mereka dapat dikonfigurasi. Karena
Kolom @Option
ditetapkan setelah class dibuat instance-nya, tetapi sebelum
Metode run
dipanggil, yang memberikan cara mudah bagi pengimplementasi untuk menyiapkan default untuk
atau melakukan semacam pemfilteran pada kolom Map
dan Collection
, yang
jika tidak, {i>append-only<i}.
Integrator
Integrator bekerja di dunia Konfigurasi, yang ditulis dalam XML. Format konfigurasi
memungkinkan Integrator menetapkan (atau menambahkan) nilai untuk kolom @Option
mana pun. Contohnya,
anggaplah Integrator ingin mendefinisikan pengujian berlatensi lebih rendah yang memanggil jumlah default,
sebagai pengujian yang berjalan lama
yang memanggil berbagai angka. Mereka bisa 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 Pengujian
Test Runner juga memiliki akses ke titik konfigurasi ini melalui konsol Trade Federation.
Pertama dan terpenting, mereka akan menjalankan Perintah (yaitu, konfigurasi dan semua argumennya) dengan
Petunjuk run command <name>
(atau disingkat run <name>
).
Di luar itu, mereka dapat menentukan daftar argumen yang merupakan bagian dari perintah, yang dapat menggantikan atau
menambahkan kolom yang ditentukan oleh Objek Siklus Proses di dalam setiap konfigurasi.
Untuk menjalankan pengujian latensi rendah dengan nomor telepon many-numbers
, Test Runner
dapat mengeksekusi:
tf> run low-latency.xml --call 111-111-1111 #*#*TEST1*#*# --call 222-222-2222 #*#*TEST2*#*#
Atau, untuk mendapatkan efek serupa dari arah yang berlawanan, Test Runner dapat mengurangi waktu tunggu
untuk pengujian many-numbers
:
tf> run many-numbers.xml --timeout 5000
Pengurutan Opsi
Anda mungkin melihat bahwa opsi call
yang mendasari implementasi adalah Map
jadi setelah berulang --call
pada baris
perintah, semuanya akan disimpan.
Opsi timeout
, yang memiliki implementasi dasar dari 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, sesuai
urutan yang ditentukan pada baris perintah.
Opsi Boolean
Opsi jenis dasar boolean dapat ditetapkan ke true
dengan langsung meneruskan
nama opsi, misalnya, --[option-name]
dan dapat ditetapkan ke false
menggunakan
sintaksis --no-[option-name]
.