Jedným z najťažších problémov pri vývoji softvéru je pomenovanie. Vytváranie zmysluplných názvov pre základné aspekty programu, ako sú triedy a metódy, môže byť zložité. Obmedzenia názvov, ako napríklad žiadne medzery, tento problém ešte umocňujú.
Problém s pomenovaním pretrváva v každom aspekte životného cyklu vývoja softvéru, vrátane testovania. Tu je užitočná anotácia JUnit @DisplayName.
Čo je anotácia @DisplayName?
Jedna metóda môže mať niekoľko testovacích metód, z ktorých každá testuje špecifické správanie. Ak však testovacím metódam priradíte názvy správania, môžu sa stať rozvláčnymi a ťažko čitateľnými.
Anotácia @DisplayName je komponent JUnit, ktorý vám umožňuje vytvárať vlastné názvy pre vaše testovacie triedy a metódy. Tieto názvy môžu obsahovať medzery, špeciálne znaky a dokonca aj emotikony. Anotácia @DisplayName by vám mala pomôcť vytvoriť popisnejšie a zmysluplnejšie názvy testovacích tried a metód.
Ako používať anotáciu @DisplayName
V Testovacia trieda JUnit, anotácia @DisplayName sa objaví nad názvom triedy alebo tesne pred deklaráciou metódy. Anotácia @DisplayName má jeden argument (názov). Tento argument sa neskôr objaví v testovacích správach, vďaka čomu je dokumentácia testovania popisnejšia.
balík zobraziť meno;importovať org.junit.jupiter.api. Zobraziť meno;
importovať org.junit.jupiter.api. Test;@Zobraziť meno("Test triedapredvádzanieakoa @Zobraziť menoanotáciaTvorba.")
triedaDisplayNameTest{
@Test
@Zobraziť meno("Testovací zobrazovaný názov obsahujúci špeciálne znaky: °□°）╯")
neplatnétestDisplayNameWithSpecialCharacters(){}@Test
@Zobraziť meno("Testovací zobrazovaný názov obsahujúci medzeru")
neplatnétestDisplayNameWithSpaces(){}
@Test
@Zobraziť meno(„Testovanie zobrazovaného názvu obsahujúceho emotikony: 😱“)
neplatnétestDisplayNameWithEmoji(){}
}
Spustenie tejto triedy Java vygeneruje nasledujúcu správu o teste jednotky JUnit:
Každý argument anotácie @DisplayName nahrádza príslušný názov triedy alebo metódy v testovacej správe JUnit. Anotácia @DisplayName, „Testovacia trieda demonštrujúca, ako funguje anotácia @DisplayName“ je oveľa výraznejšia a komplexnejšia ako DisplayNameTest.
Čo bude ďalej s testovaním?
Vedieť, ako používať anotáciu @DisplayName, určite zlepší dokumentáciu testovania vašej jednotky. Okrem anotácie @DisplayName zistíte, že všetky vaše testy jednotiek JUnit budú potrebovať jedno alebo viac tvrdení. Tvrdenia sú stavebnými kameňmi jednotkových testov JUnit, preto je dobré naučiť sa ich používať.
