Yazılım geliştirmedeki en zor problemlerden biri isimlendirmedir. Sınıflar ve yöntemler gibi bir programın temel yönleri için anlamlı adlar oluşturmak zor olabilir. Boşluk olmaması gibi adlandırma kısıtlamaları bu sorunu daha da artırır.
Adlandırma sorunu, test de dahil olmak üzere yazılım geliştirme yaşam döngüsünün her alanında devam eder. JUnit @DisplayName ek açıklamasının yararlı olduğu yer burasıdır.
@DisplayName Açıklaması Nedir?
Tek bir yöntem, her biri belirli bir davranışı test eden birkaç test yöntemine sahip olabilir. Ancak, test yöntemlerine davranışsal adlar atarsanız, bu adlar uzun ve okunması zor olabilir.
@DisplayName ek açıklaması, test sınıflarınız ve yöntemleriniz için özel adlar oluşturmanıza olanak tanıyan bir JUnit bileşenidir. Bu adlarda boşluklar, özel karakterler ve hatta emojiler olabilir. @DisplayName ek açıklaması, test sınıfları ve yöntemleri için daha açıklayıcı, anlamlı adlar oluşturmanıza yardımcı olmalıdır.
@DisplayName Ek Açıklaması Nasıl Kullanılır
Bir JUnit test sınıfında , @DisplayName ek açıklaması, sınıf adının üzerinde veya yöntem bildiriminden hemen önce görünür. @DisplayName ek açıklaması tek bir bağımsız değişken (ad) alır. Bu argüman daha sonra test raporlarında görünerek test belgelerini daha açıklayıcı hale getirir.
package displayname;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
@DisplayName(“Test class demonstrating how the @DisplayName annotation works.")
class DisplayNameTest {
@Test
@DisplayName(“Testing display name containing special characters: °□°)╯”)
void testDisplayNameWithSpecialCharacters() {}
@Test
@DisplayName(“Testing display name containing space”)
void testDisplayNameWithSpaces() {}
@Test
@DisplayName(“Testing display name containing emoji: 😱”)
void testDisplayNameWithEmoji() {}
}
Bu Java sınıfının çalıştırılması, aşağıdaki JUnit birim test raporunu oluşturur:
Görünen ad açıklama çıktısı
Her @DisplayName açıklama bağımsız değişkeni, JUnit test raporunda ilgili sınıf veya yöntem adının yerini alır. @DisplayName ek açıklaması, “@DisplayName ek açıklamasının nasıl çalıştığını gösteren test sınıfı”, DisplayNameTest’ten çok daha anlamlı ve kapsamlıdır.
Test için Sırada Ne Var?
@DisplayName ek açıklamasını nasıl kullanacağınızı bilmek, birim test belgelerinizi kesinlikle iyileştirecektir. @DisplayName ek açıklamasının yanı sıra, tüm JUnit birim testlerinizin bir veya daha fazla onaylamaya ihtiyaç duyacağını göreceksiniz. İddialar, JUnit birim testlerinin yapı taşlarıdır, bu nedenle, bunların nasıl kullanılacağını öğrenmek iyidir.