Installatie en gebruik van JUnit Auteurs: Niels Hendriks - 89713 Matthijs Langenberg - 89870 Wiebe van Schie - 84313 Siet Toorman - 91623 Job Vermeulen 90589 Semester: 6 DSO: QSO: Dhr. R.J.W.T. Tangelder Dhr. J.W.M. Stroet Datum: 13-04-2008 Versie: 2.0
Document geschiedenis Versie Datum Actie Auteur(s) 0.1 01-04-2008 Document opgesteld als google document Job Vermeulen 0.2 02-04-2008 Document aangevuld / gewijzigd Job Vermeulen 1.0 03-04-2008 Document klaar voor eerste review Job Vermeulen 1.1 03-04-2008 Wijzigingen document n.a.v. 1 e review Job Vermeulen 2.0 13-04-2008 Document opmaak toegevoegd Niels Hendriks Versie 2.0 Pagina 2 van 7 13-4-2008
Inhoudsopgave Document geschiedenis...2 Inleiding...4 1. Junit activeren in eclipse...5 2. Installatie van JUnit op een server...5 3. Opstellen van een testclass...6 Bronnen...7 Versie 2.0 Pagina 3 van 7 13-4-2008
Inleiding Dit document is opgesteld als guideline voor het opzetten van een JUnit testomgeving. In de komende hoofdstukken zal worden uitgelegd worden hoe de JUnit plugin onder eclipse geactiveerd kan worden en welke stappen ondernomen moeten worden om JUnit te installeren en te testen. Verder zal aan de hand van een voorbeeld worden uitgelegd hoe men een simpele JUnit testclass kan schrijven en runnen. Versie 2.0 Pagina 4 van 7 13-4-2008
1. Junit activeren in eclipse 1. Download de Eclipse IDE voor Java Developers. Hierin zit Junit 3 en 4 bijgeleverd. 2. Start een nieuw Java project. 3. Open via het 'Project' menu de eigenschappen van het zojuist aangemaakte project 4. Ga naar 'Java Build Path' en open het tabblad 'Libraries' 5. Klik op 'Add Library'. Er verschijnt nu een wizard. 6. Selecteer 'JUnit' uit de lijst. De rest van de wizard wijst zichzelf. 7. JUnit is nu toegevoegd aan je eclipse omgeving. 2. Installatie van JUnit op een server 1. Ga naar de website van JUnit (www.junit.org) en download daar de laatste versie in zip formaat. 2. Pak het gedownloade zip bestand uit naar de gewenste installatie locatie. 3. JUnit kan nu rechtstreeks vanuit deze locatie gestart worden, echter dienen er nog wel een aantal configuratie stappen ondernomen te worden. Deze zijn beschreven hieronder. 4. Download vervolgens WhichJunit in zipformaat http://www.clarkware.com/software/whichjunit.zip. De bestanden uit dit zip bestand zullen gebruikt worden voor het configureren en testen van de werking van het JUnit programma. 5. Pak het zip bestand uit naar een locatie naar wens. 6. Open de directory waarin WhichJUnit is uitgepakt en hernoem de file README naar README.txt zodat het makkelijker te openen is onder Windows. Onder linux zou het bestand vanaf de command-line direct geopend moeten kunnen worden. 7. De README file bevat een uitvoerige beschrijving van de stappen die ondernomen moeten worden voor het juist configureren van het CLASSPATH. Deze handelingen zullen hier om die reden dan ook niet herhaald worden. Nadat alle handelingen uit de README file met succes zijn afgerond is het tijd om een testclass te schrijven, waarmee getest kan worden of JUnit ook goed werkt met een zelf geschreven testclass die zich in de directory structuur bevindt van het project. Hou er wel rekening mee dat er in CLASSPATH ook een verwijzing moet worden opgenomen naar de directory waar de source code van het project staat!! Versie 2.0 Pagina 5 van 7 13-4-2008
3. Opstellen van een testclass Een uitgebreidere uitleg over het opstellen van testclasses en de beschikbare @param annotaties binnen JUnit is te vinden in de FAQ van JUnit en op de site van IBM http://www- 128.ibm.com/developerworks/java/library/j-junit4.html. Waneer een class die getest moet worden te diep gaande dependencies heeft, dient men gebruik te maken van mock classes. Uitleg over mock classes is te vinden op http://www.onjava.com/pub/a/onjava/2004/02/11/mocks.html 1. Schrijf een class om te testen. 2. Voeg aan de class de volgende imports toe: import org.junit.*; import static org.junit.assert.*; 3. Definieer een test methode. @Test public void testimageisnotnull() { Image image = this.getimage(); asserttrue(image!= null); } @Test geeft aan dat JUnit deze methode kan gebruiken om te testen. Als de assert succesvol is, zal deze test slagen. Voeg deze regel toe aan de Main methode: org.junit.runner.junitcore.main("junitfaq.classname"); 4. Klik op Run->Run As en kies JUnit Application om de geschreven test class te laten runnen door JUnit. 5. Het is nu ook mogelijk om de testclass vanaf de console te runnen door gebruik te maken van het volgende commando: voorbeeld: Java org.junit.runner.junitcore org.junit.tests.alltests java org.junit.runner.junitcore <package_name>.<testclass_naam> Versie 2.0 Pagina 6 van 7 13-4-2008
Bronnen http://junit.sourceforge.net/#documentation http://junit.sourceforge.net/doc/faq/faq.htm http://www-128.ibm.com/developerworks/java/library/j-junit4.html http://www.onjava.com/pub/a/onjava/2004/02/11/mocks.html Versie 2.0 Pagina 7 van 7 13-4-2008