Ena najtežjih težav pri razvoju programske opreme je poimenovanje. Ustvarjanje smiselnih imen za temeljne vidike programa, kot so razredi in metode, je lahko težavno. Omejitve poimenovanja, kot je brez presledkov, to težavo še povečajo.
Težava pri poimenovanju ostaja prisotna v vseh vidikih življenjskega cikla razvoja programske opreme, vključno s testiranjem. Tukaj postane uporabna opomba JUnit @DisplayName.
Kaj je opomba @DisplayName?
Posamezna metoda ima lahko več testnih metod, od katerih vsaka testira določeno vedenje. Če pa testnim metodam dodelite vedenjska imena, lahko postanejo besedna in težko berljiva.
Opomba @DisplayName je komponenta JUnit, ki vam omogoča ustvarjanje imen po meri za vaše preskusne razrede in metode. Ta imena imajo lahko presledke, posebne znake in celo emojije. Opomba @DisplayName bi vam morala pomagati ustvariti bolj opisna in smiselna imena za testne razrede in metode.
Kako uporabljati opombo @DisplayName
V Testni razred JUnit, se opomba @DisplayName pojavi nad imenom razreda ali tik pred deklaracijo metode. Opomba @DisplayName ima en sam argument (ime). Ta argument se pozneje pojavi v poročilih o preskusih, zaradi česar je dokumentacija o testiranju bolj opisna.
paket prikazno ime;
uvoz org.junit.jupiter.api. DisplayName;
uvoz org.junit.jupiter.api. Test;@DisplayName("Test razreddokazovanjekakothe @DisplayNameopombadela.")
razredDisplayNameTest{
@Test
@DisplayName("Preizkusno prikazno ime, ki vsebuje posebne znake: °□°)╯")
prazninatestDisplayNameWithSpecialCharacters(){}@Test
@DisplayName("Preizkušam prikazno ime, ki vsebuje presledek")
prazninatestDisplayNameWithSpaces(){}
@Test
@DisplayName("Preizkušam prikazno ime, ki vsebuje emoji: 😱")
prazninatestDisplayNameWithEmoji(){}
}
Izvajanje tega razreda Java ustvari naslednje poročilo o preskusu enote JUnit:
Vsak argument opombe @DisplayName nadomesti svoje ime razreda ali metode v preskusnem poročilu JUnit. Pripis @DisplayName, »Preizkusni razred, ki prikazuje, kako deluje pripis @DisplayName«, je veliko bolj izrazit in celovit kot DisplayNameTest.
Kaj je naslednje za testiranje?
Če boste vedeli, kako uporabljati opombo @DisplayName, boste zagotovo izboljšali dokumentacijo o testu enote. Poleg opombe @DisplayName boste ugotovili, da bodo vsi vaši testi enot JUnit potrebovali eno ali več trditev. Trditve so gradniki testov enote JUnit, zato se je dobro naučiti, kako jih uporabljati.