JUnit-testien kirjoitus ja ajo

Tässä osassa kirjoitetaan ja ajetaan testejä käyttämällä JUnit-testauskehystä. Pääset alkuun JUnitin kanssa tutustumalla oppaaseen JUnit Cookbook.

Testien kirjoitus

Luo projekti "JUnitTest". Nyt voit kirjoittaa ensimmäisen testisi. Testi toteutetaan TestCase-aliluokassa. Voit käyttää joko ohjattua luokan luonnin vakiotoimintoa tai erityistä ohjattua Testitapaus-toimintoa:

1. Avaa ohjattu uuden testitapauksen luontitoiminto (Tiedosto > Uusi > JUnit-testitapaus).
2. Valitse Uusi JUnit 3.8.1 -testi ja syötä testiluokan nimeksi "TestFailure":

   
   

   Huomautus: Jos haluat käyttää JUnit 4 -testejä, varmista, että kääntäjän yhteensopivuusasetus on 5.0.

3. Näkyviin tulee varoitussanoma, jossa pyydetään lisäämään junit-kirjasto koontipolkuun. Voit lisätä junit-kirjaston automaattisesti käyttämällä Napsauta tätä -linkkiä.
4. Luo testiluokka napsauttamalla Valmis-painiketta.

Lisää luokkaan TestFailure testimetodi, joka epäonnistuu. Voit syöttää testimetodin nopeasti käyttämällä test-mallipohjaa. Siirrä sitä varten kohdistin luokan esittelyyn. Kirjoita "test", aktivoi koodinhallinnan aputoiminto painamalla Ctrl+välilyönti ja valitse "test"-mallipohja. Vaihda luodun metodin nimeksi testFailure ja kutsu fail()-metodi.

public void testFailure() throws Exception {
    fail();
}

Nyt voit ajaa ensimmäisen testisi.

Testien ajo

Voit ajaa TestFailure-testin napsauttamalla työkalurivin Aja-painiketta. Se ajetaan automaattisesti JUnit-testinä. Voit tarkastaa testin tulokset JUnit-näkymässä. Näkymässä näkyvät testiajon tilannetiedot ja tila:

Näkymä näkyy nykyisessä perspektiivissä aina, kun aloitat testiajon. JUnit-näkymä kannattaa asettaa pikanäkymäksi. JUnit-näkymässä on kaksi välilehteä: toisessa näkyy vikojen luettelo ja toisessa koko testipaketti rakenteena. Voit siirtyä viasta vastaavaan lähteeseen kaksoisnapsauttamalla vastaavaa riviä vian jäljityksessä.

Aseta JUnit-näkymä pikanäkymäksi, poista fail()-lause metodista testFailure(), jotta testi onnistuisi, ja aja testi uudelleen. Voit ajaa testin uudelleen joko napsauttamalla näkymän työkalurivin Aja uudelleen -painiketta tai voit ajaa uudelleen ohjelman, joka aloitettiin viimeksi valitsemalla avattava Aja-valikko. Tällä kerralla testin pitäisi onnistua. Kun testi onnistuu, JUnit-näkymä ei tule näyttöön, mutta onnistumisen ilmaisin näkyy JUnit-näkymän kuvakkeessa ja tilarivillä näkyy testin tulos. Näkymän kuvakkeessa näkyy testien uudelleenajosta muistuttava merkki "*" aina, kun muutat työtilan sisältöä ajon jälkeen.

- Onnistunut testiajo
- Onnistunut testiajo, mutta työtilan sisältöä on muutettu edellisen testiajon jälkeen

Edellä kuvatun testitapauksen ajon lisäksi voit myös

• ajaa kaikki projektin, lähdekansion tai paketin sisältämät testit -  
  Valitse projekti, paketti tai lähdekansio ja aja kaikki sen sisältämät testit valitsemalla Aja muodossa> JUnit-testi. Tämä komento etsii kaikki projektin, lähdekansion tai paketin sisältämät testit ja suorittaa ne.
• ajaa yhden testimetodin -
  Valitse testimetodi hahmotelmanäkymässä tai pakettien selausnäkymässä ja valitse Aja muodossa > JUnit-testi, jolloin valitsemasi testimetodi ajetaan.
• ajaa yhden testin uudelleen -
  Valitse testi JUnit-näkymässä ja suorita Aja pikavalikosta.

Testauskokoonpanon mukautus

Kun haluat välittää parametreja tai mukauttaa testiajon asetuksia, avaa Aloituskokoonpano-valintaikkuna. Valitse työkalurivin avattavasta Aja-valikosta Avaa ajovalintaikkuna...:

Tässä valintaikkunassa voit määrittää ajettavan testin, sen argumentit, ajonaikaisen luokkapolun ja ajonaikaisen Java-ympäristön.

Testin vianmääritys

Kun testi epäonnistuu, voit tehdä sille vianmäärityksen noudattamalla seuraavia ohjeita:

1. Avaa vastaava tiedosto muokkausohjelmaan kaksoisnapsauttamalla häiriöstä kertovaa merkintää JUnit-näkymän Häiriöt-välilehdessä.
2. Aseta keskeytyskohta testimetodin alkuun.
3. Valitse testitapaus ja suorita avattavasta Vianmääritys-valikosta  Tee vianmääritys muodossa>JUnit-testi.

JUnit-aloituskokoonpanolla on "keep alive" -vaihtoehto. Jos Java-näennäiskone tukee "käytönaikaista koodinvaihtoa", voit korjata koodin ja ajaa testin uudelleen aloittamatta koko testiajoa uudelleen. Voit ottaa tämän vaihtoehdon käyttöön valitsemalla Pidä JUnit ajossa testausajon jälkeen vianmäärityksen aikana -valintaruudun JUnit-aloituskokoonpanossa.

Testipaketin luonti

Ohjatun JUnit TestSuite -toiminnon avulla voit luoda testipaketin. Voit valita pakettiin kuuluvien luokkien joukon.

1. Avaa ohjattu Uusi-toiminto.
2. Valitse Java > JUnit > JUnit-testipaketti ja napsauta Seuraava-painiketta.
3. Syötä testipaketin luokan nimi (käytäntönä on käyttää oletusarvoa "AllTests").
   

   

4. Valitse pakettiin sisällytettävät luokat. Tällä hetkellä testiluokkia on vain yksi, mutta voit lisätä luokkia pakettiin myöhemmin.

Voit lisätä tai poistaa testipaketista testiluokkia

• muokkaamalla testipakettitiedostoa manuaalisesti
• ajamalla ohjatun toiminnon uudelleen ja valitsemalla uuden testiluokkien joukon.

Huomautus: Ohjattu toiminto asettaa luotuun testipakettiluokkaan kaksi merkintää, merkinnät//$JUnit-BEGIN$ ja //$JUnit-END$, jolloin ohjattu toiminto voi päivittää olemassa olevat testipaketin luokat. Merkintöjen välisen koodin muokkausta ei suositella.

Seuraava osa: Projektin määrityksen opas