SPA- och serveråtergivning spa-and-server-side-rendering

Ökning overview

Single page-applikationer (SPA) kan ge användaren en rik, dynamisk upplevelse som reagerar och beter sig på välbekanta sätt, ofta precis som ett systemspecifikt program. Detta uppnås genom att klienten förlitar sig på att läsa in innehållet i förväg och sedan göra en grov förbättring av användarinteraktionen och på så sätt minimera mängden kommunikation som krävs mellan klienten och servern, vilket gör appen mer reaktiv.

Detta kan dock leda till längre inledande inläsningstider, särskilt om SPA är stor och har mycket innehåll. För att optimera inläsningstiden kan en del av innehållet återges på serversidan. Med SSR-återgivning (server-side rendering) går sidans initiala belastning snabbare och skickar sedan vidare återgivning till klienten.

Använd SSR when-to-use-ssr

SSR krävs inte för alla projekt. Även om AEM stöder JS SSR fullt ut för SPA rekommenderar Adobe inte att man implementerar det systematiskt för varje projekt.

När du beslutar dig för att implementera SSR måste du först uppskatta vilken ytterligare komplexitet, insats och kostnad som SSR innebär på ett realistiskt sätt för projektet, inklusive det långsiktiga underhållet. En SSR-arkitektur bör endast väljas när mervärdet klart överstiger de uppskattade kostnaderna.

SSR ger vanligtvis ett visst värde när det finns ett tydligt"ja" till någon av följande frågor:

Endast när minst en av dessa två frågor besvaras med ett tydligt"ja" för ditt projekt rekommenderar Adobe att SSR implementeras. I följande avsnitt beskrivs hur du gör detta med Adobe I/O Runtime.

Adobe I/O Runtime adobe-i-o-runtime

Om du är säker på att ditt projekt kräver implementering av SSR rekommenderar Adobe att du använder Adobe I/O Runtime.

Mer information om Adobe I/O Runtime finns i:

I följande avsnitt beskrivs hur Adobe I/O Runtime kan användas för att implementera SSR för dina SPA i två olika modeller:

Fjärrrenderarkonfiguration remote-renderer-configuration

AEM måste veta var det fjärråtergivna innehållet kan hämtas. Oavsett vilken modell du väljer att implementera för SSR,, måste du ange hur du ska AEM åtkomst till den här fjärråtergivningstjänsten.

Detta görs via RemoteContentRenderer - Configuration Factory OSGi-tjänsten. Sök efter strängen RemoteContentRenderer i webbkonsolens konsol på http://<host>:<port>/system/console/configMgr.

Följande fält är tillgängliga för konfigurationen:

AEM kommunikationsflöde aem-driven-communication-flow

När du använder SSR innehåller komponentens interaktionsarbetsflöde för SPA i AEM en fas i vilken det inledande innehållet i appen genereras på Adobe I/O Runtime.

Adobe I/O Runtime-drivet kommunikationsflöde adobe-i-o-runtime-driven-communication-flow

I det föregående avsnittet beskrivs standardimplementeringen och den rekommenderade implementeringen av serversidesåtergivning för SPA i AEM, där AEM utför startsvällning och -visning av innehåll.

Alternativt kan SSR implementeras så att Adobe I/O Runtime ansvarar för startkomponenten, vilket effektivt kan vända kommunikationsflödet.

Båda modellerna är giltiga och stöds av AEM. Man bör dock beakta fördelarna och nackdelarna med var och en av modellerna innan man implementerar en viss modell.

Planering för SSR planning-for-ssr

Endast en del av ett program får återges på serversidan. Det vanliga exemplet är det innehåll som visas ovanför vikningen vid den första inläsningen av sidan återges på serversidan. Detta sparar tid genom att leverera till klienten, som redan har återgett innehåll. När användaren interagerar med SPA återges det extra innehållet av klienten.

När du funderar på att implementera serversidesåtergivning för SPA kan du kontrollera vilka delar av programmet som behövs.

Utveckla en SPA med SSR developing-an-spa-using-ssr

SPA kan återges av klienten (i webbläsaren) eller serversidan. Webbläsaregenskaper som fönsterstorlek och plats finns inte på den återgivna serversidan. SPA bör därför vara isomorfa, utan att man vet var de kommer att återges.

Om du vill använda SSR distribuerar du koden i AEM och på Adobe I/O Runtime, som ansvarar för återgivningen på serversidan. Den mesta koden blir densamma, men serverspecifika åtgärder är olika.

SSR för SPA i AEM ssr-for-spas-in-aem

SSR för SPA i AEM kräver Adobe I/O Runtime, vilket krävs för återgivning av programinnehållsserversidan. I programmets HTML anropas en resurs på Adobe I/O Runtime för att återge innehållet.

Precis som AEM stöder ramverken Angular och React SPA direkt, stöds även serversidesrendering för Angular- och React-appar. Mer information finns i NPM-dokumentationen för båda ramverken.

Ett enkelt exempel finns i We.Retail Journal-appen. Det återger hela programserversidan. Även om detta inte är ett verkligt exempel visar det vad som behövs för att implementera SSR.

Använda Node.js using-node-js

Adobe I/O Runtime rekommenderas för implementering av SSR för SPA i AEM.

För premesis AEM-instanser är det också möjligt att implementera SSR med en anpassad Node.js-instans på samma sätt som beskrivs ovan. Även om detta stöds av Adobe rekommenderas det inte.

Renderare för fjärrinnehåll remote-content-renderer

Den Remote Content Renderer Configuration som krävs för att använda SSR med SPA i AEM finns i en mer generaliserad renderingstjänst som kan utökas och anpassas efter dina behov.

RemoteContentRenderingService remotecontentrenderingservice

RemoteContentRenderingService är en OSGi-tjänst som hämtar innehåll som återges på en fjärrserver, till exempel från Adobe I/O. Innehållet som skickas till fjärrservern baseras på den begärandeparameter som skickas.

RemoteContentRenderingService kan injiceras genom beroendeinvertering till antingen en anpassad Sling-modell eller en servlet när ytterligare innehållsmanipulering krävs.

Den här tjänsten används internt av RemoteContentRendererRequestHandlerServlet.

RemoteContentRendererRequestHandlerServlet remotecontentrendererrequesthandlerservlet

RemoteContentRendererRequestHandlerServlet kan användas för att ställa in konfigurationen för begäran programmatiskt. DefaultRemoteContentRendererRequestHandlerImpl, den angivna standardimplementeringen av begäranhanteraren, gör att du kan skapa flera OSGi-konfigurationer för att mappa en plats i innehållsstrukturen till en fjärrslutpunkt.

Implementera gränssnittet RemoteContentRendererRequestHandler om du vill lägga till en anpassad begärandehanterare. Se till att du ställer in Constants.SERVICE_RANKING-komponentegenskapen på ett heltal som är högre än 100, vilket är rankningen för DefaultRemoteContentRendererRequestHandlerImpl.

@Component(immediate = true,
        service = RemoteContentRendererRequestHandler.class,
        property={
            Constants.SERVICE_RANKING +":Integer=1000"
        })
public class CustomRemoteContentRendererRequestHandlerImpl implements RemoteContentRendererRequestHandler {}

Konfigurera OSGi-konfigurationen för standardhanteraren configure-default-handler

Konfigurationen av standardhanteraren måste konfigureras enligt beskrivningen i avsnittet Konfiguration av fjärrinnehållsrenderare.

Användning av fjärråtergivning av innehåll usage

Så här hämtar du en servlet och returnerar innehåll som kan injiceras på sidan:

Vanligtvis är HTML-mallen för en sidkomponent huvudmottagaren för en sådan funktion.

<sly data-sly-resource="${resource @ resourceType='cq/remote/content/renderer/request/handler'}" />

Krav requirements

Servlets använder Sling Model Exporter för att serialisera komponentdata. Som standard stöds både com.adobe.cq.export.json.ContainerExporter och com.adobe.cq.export.json.ComponentExporter som Sling Model-kort. Om det behövs kan du lägga till klasser som begäran ska anpassas till med RemoteContentRendererServlet och implementera RemoteContentRendererRequestHandler#getSlingModelAdapterClasses. De ytterligare klasserna måste utöka ComponentExporter.