Jedan od najtežih problema u razvoju softvera je imenovanje. Stvaranje smislenih imena za temeljne aspekte programa, kao što su klase i metode, može biti teško. Ograničenja imenovanja, kao što je nedostatak razmaka, dodatno pojačavaju ovaj problem.
Problem s imenovanjem postoji u svakom aspektu životnog ciklusa razvoja softvera, uključujući testiranje. Ovdje JUnit @DisplayName napomena postaje korisna.
Što je anotacija @DisplayName?
Jedna metoda može imati nekoliko metoda testiranja od kojih svaka testira određeno ponašanje. Međutim, ako metodama testiranja dodijelite bihevioralna imena, one mogu postati dvosmislene i teške za čitanje.
Napomena @DisplayName je JUnit komponenta koja vam omogućuje stvaranje prilagođenih naziva za vaše testne klase i metode. Ta imena mogu sadržavati razmake, posebne znakove, pa čak i emojije. Bilješka @DisplayName trebala bi vam pomoći da stvorite opisnija, smislenija imena za testne klase i metode.
Kako koristiti napomenu @DisplayName
U JUnit test klasa, napomena @DisplayName pojavljuje se iznad naziva klase ili neposredno prije deklaracije metode. Napomena @DisplayName uzima jedan argument (ime). Taj se argument kasnije pojavljuje u izvješćima o testiranju, čineći dokumentaciju testiranja opisnijom.
paket prikazno ime;
uvoz org.junit.jupiter.api. DisplayName;
uvoz org.junit.jupiter.api. Test;@Ime za prikaz("Test razredademonstrirajućikakothe @DisplayNameanotacijadjela.")
razredaDisplayNameTest{
@Test
@Ime za prikaz("Testiranje imena za prikaz koje sadrži posebne znakove: °□°)╯")
poništititestDisplayNameWithSpecialCharacters(){}@Test
@Ime za prikaz("Testiranje imena za prikaz koje sadrži razmak")
poništititestDisplayNameWithSpaces(){}
@Test
@Ime za prikaz("Testiranje imena za prikaz koje sadrži emoji: 😱")
poništititestDisplayNameWithEmoji(){}
}
Izvođenje ove Java klase generira sljedeće izvješće o testiranju jedinice JUnit:
Svaki argument anotacije @DisplayName zamjenjuje naziv odgovarajuće klase ili metode u JUnit test izvješću. Bilješka @DisplayName, "Testna klasa koja pokazuje kako funkcionira anotacija @DisplayName" puno je izražajnija i sveobuhvatnija od DisplayNameTest.
Što je sljedeće za testiranje?
Znanje kako koristiti napomenu @DisplayName zasigurno će poboljšati vašu dokumentaciju o jediničnom testu. Osim napomene @DisplayName, vidjet ćete da će svi vaši JUnit jedinični testovi trebati jednu ili više tvrdnji. Tvrdnje su sastavni dijelovi JUnit jediničnih testova, stoga je dobro naučiti kako ih koristiti.