Salah satu masalah yang paling sulit dalam pengembangan perangkat lunak adalah penamaan. Membuat nama yang bermakna untuk aspek dasar suatu program, seperti kelas dan metode, bisa jadi rumit. Pembatasan penamaan, seperti tidak ada spasi, semakin memperkuat masalah ini.

Masalah penamaan tetap ada di setiap aspek siklus hidup pengembangan perangkat lunak, termasuk pengujian. Di sinilah anotasi JUnit @DisplayName menjadi berguna.

Apa itu Anotasi @DisplayName?

Sebuah metode tunggal dapat memiliki beberapa metode pengujian yang masing-masing menguji perilaku tertentu. Namun, jika Anda menetapkan nama perilaku untuk metode pengujian, mereka bisa menjadi bertele-tele dan sulit dibaca.

Anotasi @DisplayName adalah komponen JUnit yang memungkinkan Anda membuat nama khusus untuk kelas dan metode pengujian Anda. Nama-nama ini dapat memiliki spasi, karakter khusus, dan bahkan emoji. Anotasi @DisplayName akan membantu Anda membuat nama yang lebih deskriptif dan bermakna untuk kelas dan metode pengujian.

instagram viewer

Cara Menggunakan Anotasi @DisplayName

Di sebuah kelas tes JUnit, anotasi @DisplayName muncul di atas nama kelas atau tepat sebelum deklarasi metode. Anotasi @DisplayName mengambil satu argumen (nama). Argumen ini kemudian muncul dalam laporan pengujian, membuat dokumentasi pengujian lebih deskriptif.

kemasan nama tampilan;

impor org.junit.jupiter.api. Nama tampilan;
impor org.junit.jupiter.api. Uji;

@Nama tampilan("Uji kelasmendemonstrasikanbagaimanaitu @Nama tampilananotasibekerja.&kutipan;)
kelasNamaTampilanTes{
@Uji
@Nama tampilan("Menguji nama tampilan yang mengandung karakter khusus: °□°)╯")
ruang kosongtestDisplayNameWithSpecialCharacters(){}

@Uji
@Nama tampilan("Menguji nama tampilan yang mengandung spasi")
ruang kosongtestDisplayNameWithSpaces(){}

@Uji
@Nama tampilan("Menguji nama tampilan yang mengandung emoji: ")
ruang kosongtestDisplayNameWithEmoji(){}
}

Menjalankan kelas Java ini menghasilkan laporan pengujian unit JUnit berikut:

Setiap argumen anotasi @DisplayName menggantikan nama kelas atau metodenya masing-masing dalam laporan pengujian JUnit. Anotasi @DisplayName, “Kelas uji yang mendemonstrasikan cara kerja anotasi @DisplayName” jauh lebih ekspresif dan komprehensif daripada DisplayNameTest.

Apa Selanjutnya untuk Pengujian?

Mengetahui cara menggunakan anotasi @DisplayName tentu akan meningkatkan dokumentasi pengujian unit Anda. Terlepas dari anotasi @DisplayName, Anda akan menemukan bahwa semua pengujian unit JUnit Anda akan memerlukan satu atau lebih pernyataan. Asersi adalah dasar dari pengujian unit JUnit, oleh karena itu, ada baiknya mempelajari cara menggunakannya.