Routering met Compojure

Wanneer je een URL in je browser typt, hoe weet een webtoepassing dan welk deel van de code moet worden uitgevoerd?

Daar komt routering om de hoek kijken! Routering is het proces waarbij binnenkomende webverzoeken (zoals het bezoeken van een URL) worden gekoppeld aan specifieke functies of stukjes code die ze afhandelen.

• Het stuurt verkeer.
• Het ordent je toepassing.
• Het maakt URL's betekenisvol.

Compojure is een populaire routeringsbibliotheek voor Clojure-webtoepassingen. Het bouwt voort op Ring, de webtoepassingsspecificatie van Clojure.

Compojure biedt eenvoudige macro's om routes te definiëren, waardoor je URL's eenvoudig aan je handlerfuncties kunt koppelen. Het helpt de structuur van je webtoepassing overzichtelijk en begrijpelijk te houden.

Compojure gebruikt macro's zoals GET, POST, PUT en DELETE om routes voor verschillende HTTP-methoden te definiëren. De eenvoudigste is GET voor het ophalen van gegevens.

Zo definieer je een route die reageert op verzoeken naar het basispad /:

Om onze routes actief te maken, hebben we een webserver nodig. We gebruiken http-kit, een eenvoudige en snelle server. We wikkelen onze app-routes in een functie en starten de server.

Voer dit volledige voorbeeld uit. Open vervolgens je browser op http://localhost:3000!

Vaak moet je dynamische delen uit een URL halen, zoals een item-ID of gebruikersnaam. Met Compojure kun je dit doen met padparameters, die worden aangegeven met een dubbele punt (:) gevolgd door de parameternaam.

Deze parameters zijn vervolgens als argumenten beschikbaar in je handlerfunctie.

Webtoepassingen halen niet alleen gegevens op (GET). Ze maken (POST), werken bij (PUT) en verwijderen (DELETE) ook bronnen. Compojure biedt voor elk hiervan specifieke macro's.

Je kunt verschillend gedrag definiëren voor hetzelfde URL-pad, afhankelijk van de gebruikte HTTP-methode.

Naarmate je toepassing groeit, krijg je veel routes. Met Compojure's macro routes kun je ze logisch groeperen. Hierdoor wordt je routeringsdefinitie overzichtelijker en beter leesbaar.

Vervolgens kun je deze gegroepeerde routes combineren in je hoofdhandler van de toepassing.

Voor een nog betere ordening, vooral bij API-versies of deelgebieden, kun je routes nesten. Met Compojure kun je een gemeenschappelijk padvoorvoegsel voor een groep routes definiëren met context.

Hierdoor ontstaat een duidelijke hiërarchie voor de eindpunten van je toepassing, zoals /api/v1/users of /admin/dashboard.

Compojure verwerkt routes in de volgorde waarin ze zijn gedefinieerd. De eerste route die overeenkomt met het pad en de HTTP-methode van een binnenkomend verzoek, wordt gebruikt.

• Definieer specifiekere routes VÓÓR algemene routes.
• Zo moet /users/new vóór /users/:id komen.

Anders kan /users/new ten onrechte overeenkomen met /users/:id, waarbij 'new' als een ID wordt behandeld.

In deze les heb je de basis van webroutering geleerd en gezien hoe Compojure dit voor Clojure-toepassingen vereenvoudigt:

• Routering koppelt URL's aan handlerfuncties.
• Compojure biedt macro's (GET, POST enzovoort) om routes te definiëren.
• Je kunt padparameters zoals :id vastleggen.
• Routes kunnen worden gegroepeerd met routes en genest met context.
• De volgorde is belangrijk: specifieke routes moeten vóór algemene routes komen.

Je bent nu klaar om duidelijke, overzichtelijke routes voor je Clojure-webservices te definiëren!