De grundläggande principerna för REST utgör grunden för att skapa effektiva och lätt skalbara webbtjänster. I Spring Boot används de ofta för att implementera API:er.

Låt oss undersöka vilka dessa principer är, varför de är viktiga, och granska exempel på deras tillämpning i Spring Boot.

Grundläggande principer för REST

REST (Representational State Transfer) är en arkitekturstil baserad på sex nyckelprinciper som hjälper utvecklare att bygga enkla, flexibla och skalbara API:er. Dessa principer beskriver hur system bör interagera för att förbli anpassningsbara och lättunderhållna.

Klient-server-arkitektur

En REST API bör separera ansvar mellan klient och server. Klienten ansvarar för användargränssnittet och att göra förfrågningar, medan servern hanterar datalagring och förfrågningshantering.

REST API säkerställer en tydlig uppdelning mellan klientsidan och serversidan av applikationen, vilket gör att de kan utvecklas oberoende.

Klientsidan kan vara en webbläsare, mobilapp eller någon annan klientapplikation, medan serversidan kan implementeras i valfritt programspråk.

Tillståndslös

Varje begäran från klienten till servern måste innehålla all information som behövs för att behandla den begäran. Servern ska inte behålla något tillstånd mellan begäranden, vilket säkerställer att varje begäran är isolerad från andra.

Till exempel, tänk dig att vi har en applikation som returnerar en lista med produkter på olika språk. Klienten måste inkludera språkinformation i varje begäran så att servern vet vilket språk som ska användas för svaret. Servern lagrar inte språkinformation mellan begäranden. Låt oss implementera detta exempel i kod.

Denna kod representerar en REST-kontroller som hanterar HTTP GET-begäranden på slutpunkten /products. Metoden getProducts() tar en lang-parameter, som anger vilket språk klienten vill ta emot data på.

Baserat på denna parameter returnerar metoden en produktlista på det angivna språket eller på standardspråket.

Enhetligt gränssnitt

För att en REST API ska vara lätt att använda bör den ha en enkel och organiserad struktur. Detta innebär att alla endpoints måste följa vissa grundläggande riktlinjer. Här är de viktigaste principerna:

Använd substantiv för att representera resurser istället för verb. Till exempel, istället för att använda GET /createProduct, är det bättre att använda POST /products, där products är resursen.

GET /products — Hämtar en lista med produkter;

POST /products — Skapar en ny produkt;

PUT /products/{id} — Uppdaterar information om en specifik produkt, där {id} är produktens unika identifierare;

DELETE /products/{id} — Tar bort produkten med den angivna identifieraren.

Beskrivning av en Spring REST-kontroller som hanterar produkter genom att implementera olika HTTP-metoder för skapande, hämtning, uppdatering och borttagning av produktdata, samtidigt som bästa praxis för en användarvänlig API-struktur följs.

Annoteringen @RequestMapping("/products") anger att basadressen /products automatiskt prefixas till alla rutter inom denna controller.

I detta exempel hanterar controllern operationer relaterade till entiteten Product (Product class), så basadressen är /products. Detta tillvägagångssätt undviker upprepning av /products för varje metod. Istället anger vi endast HTTP-metoderna (GET, POST, PUT, DELETE), som kommer att tillämpas på denna basadress.

GET /products — Hämtar en lista med produkter;

POST /products — Skapar en ny produkt.

Det är möjligt att ha flera endpoints med samma URL men olika HTTP-metoder. Till exempel delar GET /products och POST /products samma URL, men de använder olika HTTP-metoder. Klienten anger HTTP-metoden i request header, vilket visar vilken åtgärd som ska utföras.

Caching

För att förbättra prestandan kan servern instruera klienten när data ska cachas. Detta minskar belastningen på servern och snabbar upp hanteringen av förfrågningar.

Detta innebär att när metoden anropas med samma parametrar, kommer resultatet att hämtas från cachen istället för att metoden körs om. Detta kan förbättra prestandan genom att minska belastningen på tjänsten.

I Spring Boot kan cachning av svar hanteras med hjälp av annotationer eller HTTP headers. Här är ett exempel på datacachning:

I det här exemplet används annoteringen @Cacheable för att cacha resultatet av metoden getAllProducts().

Annoteringen @Cacheable("products") anger att resultatet av metoden getAllProducts() kommer att lagras i cachen under namnet products. När metoden anropas igen med samma parametrar kommer Spring att söka efter resultatet i cachen products istället för att köra metoden på nytt.

Lagerbaserat system

Principen om lagerindelat system i REST API innebär att klienten inte interagerar med endast en server; istället arbetar den genom flera nivåer. Detta kan förklaras med hjälp av trelagersarkitekturen i Spring Boot.

När klienten skickar en förfrågan går den genom alla tre nivåer: från controller till service, vidare till repository, och tillbaka. Denna uppdelning bidrar till att hålla systemet organiserat och gör det enklare att underhålla koden.

Code on Demand

Även om det används mer sällan kan ett REST API returnera körbar kod till klienten för exekvering på deras sida. Denna princip tillämpas sällan och kräver ytterligare säkerhetsåtgärder.

Till exempel kan ett API returnera JavaScript-kod som körs i klientens webbläsare för att bearbeta data eller utföra andra uppgifter. Detta kan vara användbart för att dynamiskt ladda funktionalitet baserat på förfrågningar, såsom formulärhantering eller klientsidig datavalidering.

Sammanfattning

De grundläggande principerna för REST är viktiga riktlinjer för skapande av flexibla och underhållbara API:er. I Spring Boot implementeras dessa principer med hjälp av annotationer såsom @RestController, @Cacheable som underlättar utvecklingen av välstrukturerade och effektiva system för interaktion med klienter.