README.adoc

todo-list-eksempel

Forord

Denne modulen i todo-list-eksemplet inneholder dokumentasjon tenkt brukt som læringsmateriell, ikke vanlig dokumentasjon rettet mot utviklere av den typen en forventer i tilsvarende prosjekter.

Dokumentasjonen er skrevet med Asciidoctor og bygget med

Introduksjon

Todolist er en applikasjon for håndtering av todo-lister. Den er implementert som en kombinasjon av en JavaFX-app og et REST API som appen bruker for håndtering av data. Med et REST API adskilt fra appen, er det lett å støtte andre klienter som bruker de samme dataene, f.eks. en "native"-app for Android eller web-klient basert på React.

arkitekturen

En kan tenke på appen som delt i ulike lag, med et indre lag som håndterer representasjon og lagring av data, og et brukergrensesnittlag som brukeren interagerer med. Representasjonsdelen av det indre laget kalles ofte domenelogikken, fordi det bestemmer strukturen på dataene og hva en har lov til å gjøre med det. REST API-et har på en måte en lignende struktur, hvor brukergrensesnittet er byttet ut med et API som en når over web-protokollen HTTP.

Modularisering

Todolist er strukturert i et sett moduler, hvor hver modul fokuserer på en viss funksjonalitet eller del av arkitekturen. Det indre laget ligger i core-modulen, brukergrensesnittet i fxui (og fxutil), mens REST API-et er fordelt over to moduler, restapi og restserver (og en alternativ implementasjon i springboot/restserver):

• core - klasser for representasjon og lagring (som JSON) av todo-lister og -elementer

• fxui (og fxutil) - app-brukergrensesnitt basert på JavaFX og FXML

• restapi og restserver - REST API og server basert på JAX-RS-standarden og Jersey-implementasjonen

• springboot/restserver - alternativ REST API og server basert på spring boot-rammeverket

• integrationtests - (integrasjons)test for app koblet til REST-serveren

Disse forklares i hver sine kapitler. Under viser et pakkediagram strukturen av moduler og pakker og deres avhengigheter.