Viena iš sudėtingiausių programinės įrangos kūrimo problemų yra įvardijimas. Gali būti sudėtinga sukurti prasmingus pagrindinių programos aspektų, pvz., klasių ir metodų, pavadinimus. Vardų suteikimo apribojimai, pvz., nenaudojami tarpai, dar labiau sustiprina šią problemą.
Pavadinimo problema išlieka visais programinės įrangos kūrimo ciklo aspektais, įskaitant testavimą. Čia praverčia JUnit @DisplayName anotacija.
Kas yra @DisplayName anotacija?
Vienas metodas gali turėti kelis bandymo metodus, kurių kiekvienas tikrina konkretų elgesį. Tačiau jei bandymo metodams priskirsite elgsenos pavadinimus, jie gali tapti žodiški ir sunkiai įskaitomi.
@DisplayName anotacija yra JUnit komponentas, leidžiantis sukurti pasirinktinius bandymų klasių ir metodų pavadinimus. Šiuose pavadinimuose gali būti tarpų, specialiųjų simbolių ir net jaustukų. @DisplayName komentaras turėtų padėti sukurti labiau apibūdinančius, prasmingesnius bandymų klasių ir metodų pavadinimus.
Kaip naudoti @DisplayName komentarą
A
JUnit testo klasė, @DisplayName anotacija rodoma virš klasės pavadinimo arba prieš pat metodo deklaraciją. @DisplayName komentaras turi vieną argumentą (pavadinimą). Šis argumentas vėliau pasirodo bandymų ataskaitose, todėl bandymų dokumentai yra labiau aprašomi.paketą rodomas pavadinimas;importuoti org.junit.jupiter.api. Rodomas pavadinimas;
importuoti org.junit.jupiter.api. Testas;@Rodomas pavadinimas(„Test klasėdemonstruodamaskaipį @Rodomas pavadinimasanotacijadarbai.&citata;)
klasėDisplayNameTest{
@Test
@Rodomas pavadinimas(„Tikrinamas rodomas pavadinimas su specialiaisiais simboliais: °□°）╯“)
tuštumatestDisplayNameWithSpecialCharacters(){}@Test
@Rodomas pavadinimas("Bandomas rodomas pavadinimas, kuriame yra tarpo")
tuštumatestDisplayNameWithSpaces(){}
@Test
@Rodomas pavadinimas(„Bandomas rodomas pavadinimas su jaustukais: 😱“)
tuštumatestDisplayNameWithEmoji(){}
}
Vykdant šią „Java“ klasę sukuriama ši „JUnit“ vieneto bandymo ataskaita:
Kiekvienas @DisplayName anotacijos argumentas pakeičia atitinkamą klasės arba metodo pavadinimą JUnit bandymo ataskaitoje. @DisplayName anotacija „Test klasė, rodanti, kaip veikia @DisplayName anotacija“ yra daug išraiškingesnė ir išsamesnė nei „DisplayNameTest“.
Kas laukia toliau atliekant bandymus?
Žinodami, kaip naudoti @DisplayName anotaciją, tikrai pagerinsite įrenginio bandymo dokumentaciją. Be @DisplayName anotacijos, pastebėsite, kad visiems jūsų JUnit vienetų testams reikės vieno ar daugiau tvirtinimų. Teiginiai yra JUnit vienetų testų sudedamoji dalis, todėl pravartu išmokti jais naudotis.