REST-rajapinnan toteutus ja yksikkötestaus Java EE -teknologialla

Abstract

Insinöörityössä toteutettiin REST-rajapinta vakuutusrekisterijärjestelmään Java EE -teknologialla. Toteutukselle kirjoitettiin yksikkötestit, joiden tarkoitus oli varmistaa kirjoitetun ohjelman laatua ja toimintavarmuutta sekä auttaa tulevaisuuden muutoksien heijastusvaikutusten selvittämisessä.

Jokaiselle luokalle tehtiin omat yksikkötestit omiin yksikkötestiluokkiin. Iteratiivisen kehitys-prosessin päätteeksi sovelluksen arkkitehtuuria parannettiin yksinkertaistamalla, jolloin yksikkötestien avulla voitiin todeta, että sovellus edelleen toimitti tehtävänsä.

Kehitysympäristönä käytettiin Eclipse Mars -sovellusta. Ennestään olemassa oleva Vakuutusrekisteri-sovellus ja siihen tässä insinöörityössä toteutettu REST-rajapinta toteutettiin Ja-valla. REST-rajapinta toteutettiin JAX-RS RESTEasy -implementaatiolla. Yksikkötestit toteutettiin JUnit-kirjastolla, ja yksikkötestien riippuvuuksia sisältävien kenttien oliot injektoitiin Mockito-kirjaston mock-olioilla.

Sovellettu toteutustapa yksikkötesteineen palveli tarkoitusta, jolla insinöörityön konkreettisen työvaiheen suoritus saatiin toteutettua varmasti ja tulevaisuuden muutoksia kestäväksi.

The goal of this final year project was to develop a REST API with Java EE technology for an insurance database system. To guarantee quality, stability and maintenance ability, unit tests were written for the feature developed during the implementation.

All classes introduced as part of the new feature were unit tested. The architecture of the application was streamlined towards the end of the iterative development process. Refactoring of the application because of streamlining was confirmed not to have side effects with the help of the written unit tests.

Eclipse Mars IDE was used for writing the software and running the unit tests. The already existing application Vakuutusrekisteri and the developed REST API was written in Java and the REST API was developed using the JAX-RS RESTEasy implementation. Unit tests were made and run using JUnit. Integration dependencies contained in the new code were tested by utilizing the Mockito mocking framework mock objects.

The result was a completed and deliverable feature including complete unit tests providing protection against regression.

The chosen unit testing approach was appropriate, providing quality control over produced work during development and providing protection against possible errors caused by future modifications.

I detta examensarbete utvecklades ett REST-gränssnitt för ett försäkringsregister med hjälp av Java EE -teknologi. Under förverkligandet av programmet skrevs enhetstest, vars uppgift var att försäkra programmets kvalitet, tillförlitlighet och möjlighet för förändringar i den eventuella framtiden.

För varje klass skrevs enhetstest i separata enhetstestklasser. Genom den hela iterativa utvecklingsprocessen kunde programmets ändamålsenliga funktion verifieras, även om programvarans arkitektur ändrades och förenklades på vägen mot den slutliga versionen.

Som integrerad utvecklingsmiljö (IDE) användes Eclipse Mars. REST-gränssnittet som utvecklades i detta examensarbete för den redan existerande Vakuutusrekisteri-programmet förverkligades med Java. För implementeringen av REST-gränssnittet valdes JAX-RS RESTEasy-implementationen. Enhetstesten utvecklades med hjälp av JUnit-ramverket. Mockito-ramverket användes till att injektera mock-objekt för enhetstest. Mock-objekten spelade en betydande roll i enhetstestningen av klasser som hade externa besittningar.

Valet över framställningssättet var lyckat. Programmeringsarbetet som utfördes kunde konstateras vara enligt uppdragsgivarens krav. Med stöd av de skrivna enhetstesten, ansågs det realiserade programmet tåla möjliga förändringar i framtiden.