Una dintre cele mai dificile probleme în dezvoltarea de software este denumirea. Crearea de nume semnificative pentru aspectele fundamentale ale unui program, cum ar fi clase și metode, poate fi dificilă. Restricțiile de denumire, cum ar fi lipsa spațierii, amplifică și mai mult această problemă.

Problema denumirii persistă în fiecare aspect al ciclului de viață al dezvoltării software, inclusiv în testare. Aici devine utilă adnotarea JUnit @DisplayName.

Ce este adnotarea @DisplayName?

O singură metodă poate avea mai multe metode de testare care testează fiecare un anumit comportament. Cu toate acestea, dacă atribuiți nume comportamentale metodelor de testare, acestea pot deveni pronunțate și dificil de citit.

Adnotarea @DisplayName este o componentă JUnit care vă permite să creați nume personalizate pentru clasele și metodele dvs. de testare. Aceste nume pot avea spații, caractere speciale și chiar emoji. Adnotarea @DisplayName ar trebui să vă ajute să creați nume mai descriptive și semnificative pentru clasele și metodele de testare.

instagram viewer

Cum să utilizați adnotarea @DisplayName

Într-o Clasa de testare JUnit, adnotarea @DisplayName apare deasupra numelui clasei sau chiar înaintea declarației metodei. Adnotarea @DisplayName ia un singur argument (numele). Acest argument apare mai târziu în rapoartele de testare, făcând documentația de testare mai descriptivă.

pachet Numele de afișare;

import org.junit.jupiter.api. Numele de afișare;
import org.junit.jupiter.api. Test;

@Numele de afișare("Test clasădemonstrândCumcel @Numele de afișareadnotarelucrări.")
clasăDisplayNameTest{
@Test
@Numele de afișare("Numele afișat de testare care conține caractere speciale: °□°)╯")
goltestDisplayNameWithSpecialCharacters(){}

@Test
@Numele de afișare("Testarea numelui afișat care conține spațiu")
goltestDisplayNameWithSpaces(){}

@Test
@Numele de afișare("Se testează numele afișat care conține emoji: 😱")
goltestDisplayNameWithEmoji(){}
}

Executarea acestei clase Java generează următorul raport de test unitar JUnit:

Fiecare argument de adnotare @DisplayName înlocuiește numele clasei sau metodei respective în raportul de testare JUnit. Adnotarea @DisplayName, „Clasa de testare care demonstrează cum funcționează adnotarea @DisplayName” este mult mai expresivă și mai cuprinzătoare decât DisplayNameTest.

Ce urmează pentru testare?

Știind cum să utilizați adnotarea @DisplayName vă va îmbunătăți cu siguranță documentația testului unitar. În afară de adnotarea @DisplayName, veți descoperi că toate testele unitare JUnit vor avea nevoie de una sau mai multe afirmații. Aserțiunile sunt elementele de bază ale testelor unitare JUnit, prin urmare, este bine să învățați cum să le folosiți.