Concetti di base dell’AEM aem-core-concepts

Prerequisiti per lo sviluppo sull’AEM prerequisites-for-developing-on-aem

Per sviluppare in aggiunta all’AEM, ha bisogno delle seguenti competenze:

È inoltre consigliabile leggere e seguire le Linee guida e best practice.

Archivio dei contenuti Java™ java-content-repository

Lo standard Java™ Content Repository (JCR), JSR 283, specifica un modo indipendente dal fornitore e dall'implementazione per accedere al contenuto in modo bidirezionale su un livello granulare all'interno di un repository dei contenuti.

Il piombo delle specifiche è detenuto da Adobe Research (Switzerland) AG.

Il pacchetto JCR API 2.0, javax.jcr.* viene utilizzato per l'accesso diretto e la manipolazione del contenuto del repository.

Experience Server (CRX) e Jackrabbit experience-server-crx-and-jackrabbit

Experience Server fornisce i servizi di esperienza su cui si basa l’AEM, che possono essere utilizzati per creare applicazioni personalizzate e incorpora il Content Repository basato su Jackrabbit.

Apache Jackrabbit è un'implementazione open source, pienamente conforme, dell'API 2.0 JCR.

Elaborazione richiesta Sling sling-request-processing

Introduzione a Sling introduction-to-sling

L'AEM viene creato utilizzando Sling, un framework di applicazioni Web basato sui principi REST che consente di sviluppare facilmente applicazioni orientate ai contenuti. Sling utilizza come archivio dati un archivio JCR, come Apache Jackrabbit o, in presenza di AEM, CRX Content Repository. Sling ha contribuito alla Apache Software Foundation; ulteriori informazioni sono disponibili su Apache.

Utilizzando Sling, il tipo di contenuto di cui eseguire il rendering non è la prima considerazione di elaborazione. Al contrario, la considerazione principale è se l’URL viene risolto in un oggetto di contenuto per il quale è possibile trovare uno script per eseguire il rendering. Questo fornisce un supporto eccellente agli autori di contenuti web per creare pagine facilmente personalizzate in base alle loro esigenze.

I vantaggi di questa flessibilità sono evidenti nelle applicazioni con un’ampia gamma di elementi di contenuto diversi o quando servono pagine facilmente personalizzabili. In particolare, quando si implementa un sistema di gestione dei contenuti web come WCM nella soluzione AEM.

Consulta Scopri Sling in 15 minuti per i primi passaggi per lo sviluppo con Sling.

Il diagramma seguente spiega la risoluzione dello script Sling. Mostra come passare dalla richiesta HTTP al nodo di contenuto, dal nodo di contenuto al tipo di risorsa, dal tipo di risorsa allo script e quali variabili di script sono disponibili.

Il diagramma seguente spiega tutti i potenti, nascosti, parametri di richiesta che è possibile utilizzare quando si tratta di SlingPostServlet. Include il gestore predefinito per tutte le richieste POST, che offre opzioni infinite per la creazione, la modifica, l’eliminazione, la copia e lo spostamento dei nodi nell’archivio.

Sling è incentrato sui contenuti sling-is-content-centric

Sling è incentrato sul contenuto. Ciò significa che l’elaborazione si concentra sul contenuto, in quanto ogni richiesta (HTTP) è mappata sul contenuto sotto forma di risorsa JCR (un nodo dell’archivio):

Sling RESTful restful-sling

Grazie alla filosofia incentrata sui contenuti, Sling implementa un server orientato a REST e quindi presenta un nuovo concetto nei framework delle applicazioni web. I vantaggi sono i seguenti:

Scomposizione URL url-decomposition

In Sling, l’elaborazione è guidata dall’URL della richiesta dell’utente. Questo definisce il contenuto da visualizzare con gli script appropriati. A questo scopo, le informazioni vengono estratte dall’URL.

Se analizzi il seguente URL:

https://myhost/tools/spy.printable.a4.html/a/b?x=12

È possibile suddividerlo nelle sue parti composite:

HTTP protocollo

host Nome del sito Web.

percorso contenuto Percorso che specifica il contenuto di cui eseguire il rendering. Utilizzato con l’estensione. In questo esempio, traducono in tools/spy.html.

selettori Utilizzati per metodi alternativi di rendering del contenuto; in questo esempio una versione compatibile con la stampante in formato A4.

estensione Formato contenuto; specifica anche lo script da utilizzare per il rendering.

suffix può essere utilizzato per specificare informazioni aggiuntive.

params Qualsiasi parametro necessario per il contenuto dinamico.

Da URL a contenuto e script from-url-to-content-and-scripts

Utilizzando questi principi:

L’immagine seguente illustra il meccanismo utilizzato, descritto più dettagliatamente nelle sezioni seguenti.

Con Sling, puoi specificare quale script esegue il rendering di una determinata entità (impostando la proprietà sling:resourceType nel nodo JCR). Questo meccanismo offre maggiore libertà rispetto a uno in cui lo script accede alle entità di dati (come farebbe un’istruzione SQL in uno script PHP) in quanto una risorsa può avere diverse rappresentazioni.

Mappatura delle richieste alle risorse mapping-requests-to-resources

La richiesta è suddivisa ed è possibile estrarre le informazioni necessarie. Nell’archivio viene eseguita la ricerca della risorsa richiesta (nodo del contenuto):

Sling consente anche di utilizzare come risorse elementi diversi dai nodi JCR, ma si tratta di una funzione avanzata.

Individuazione dello script locating-the-script

Quando si trova la risorsa appropriata (nodo di contenuto), viene estratto il tipo di risorsa sling. Questo è un percorso che individua lo script da utilizzare per il rendering del contenuto.

Il percorso specificato da sling:resourceType può essere:

Tutti gli script Sling sono archiviati in sottocartelle di /apps o /libs, in cui viene eseguita la ricerca in questo ordine (vedi Personalizzazione di componenti e altri elementi).

Altri punti da notare sono:

L'elenco dei motori di script supportati dall'istanza di AEM specificata è elencato nella console di gestione Felix ( http://<host>:<port>/system/console/slingscripting).

Inoltre, Apache Sling supporta l’integrazione con altri motori di script popolari (ad esempio Groovy, JRuby, Freemarker) e offre un modo per integrare nuovi motori di script.

Utilizzando l'esempio precedente, se sling:resourceType è hr/jobs allora per:

Se per una determinata richiesta sono applicabili più script, viene selezionato lo script con la corrispondenza migliore. Più specifica è una corrispondenza, migliore sarà; in altre parole, più il selettore corrisponderà, indipendentemente da qualsiasi estensione di richiesta o corrispondenza del nome del metodo.

Ad esempio, considera una richiesta di accesso alla risorsa
/content/corporate/jobs/developer.print.a4.html
di tipo
sling:resourceType="hr/jobs"

Supponendo di avere il seguente elenco di script nella posizione corretta:

Quindi l'ordine di preferenza sarebbe (8) - (7) - (6) - (5) - (4) - (3) - (2) - (1).

Oltre ai tipi di risorsa (definiti principalmente dalla proprietà sling:resourceType), è presente anche il super tipo di risorsa. È indicato dalla proprietà sling:resourceSuperType. Questi super tipi vengono considerati anche quando si tenta di trovare uno script. Il vantaggio dei super-tipi di risorse è che possono formare una gerarchia di risorse in cui il tipo di risorsa predefinito sling/servlet/default (utilizzato dai servlet predefiniti) è effettivamente la radice.

Il super tipo di risorsa di una risorsa può essere definito in due modi:

Ad esempio:

Gerarchia dei tipi di:

Questo perché /y ha la proprietà sling:resourceSuperType mentre /x no e pertanto il suo supertipo viene preso dal suo tipo di risorsa.

Gli script Sling non possono essere chiamati direttamente sling-scripts-cannot-be-called-directly

All’interno di Sling, gli script non possono essere chiamati direttamente in quanto ciò infrangerebbe il concetto rigoroso di server REST; è possibile combinare risorse e rappresentazioni.

Se chiami direttamente la rappresentazione (lo script), nascondi la risorsa all’interno dello script, pertanto il framework (Sling) non ne è più a conoscenza. In questo modo si perdono alcune funzionalità:

API Sling sling-api

Questo utilizza il pacchetto API Sling, org.apache.sling.* e librerie di tag.

Riferimento a elementi esistenti mediante sling:include referencing-existing-elements-using-sling-include

Un'ultima considerazione è la necessità di fare riferimento agli elementi esistenti all'interno degli script.

Gli script più complessi (aggregazione di script) devono accedere a più risorse (ad esempio, navigazione, barra laterale, piè di pagina, elementi di un elenco) includendo la risorsa.

A questo scopo, utilizza il comando sling:include("/<percorso>/<risorsa>"). Ciò include effettivamente la definizione della risorsa di riferimento, come nell’istruzione seguente che fa riferimento a una definizione esistente per il rendering delle immagini:

%><sling:include resourceType="geometrixx/components/image/img"/><%

OSGI osgi

OSGi definisce un’architettura per lo sviluppo e la distribuzione di librerie e applicazioni modulari (nota anche come Dynamic Module System per Java™). I contenitori OSGi ti consentono di suddividere l’applicazione in singoli moduli (file jar con metadati aggiuntivi e denominati bundle nella terminologia OSGi) e di gestire le dipendenze incrociate tra di essi con:

Questi servizi e contratti forniscono un’architettura che consente ai singoli elementi di scoprirsi dinamicamente a vicenda per collaborare.

Un framework OSGi offre quindi operazioni dinamiche di caricamento/scaricamento, configurazione e controllo di questi bundle, senza richiedere riavvii.

Questa architettura consente di estendere Sling con moduli specifici per le applicazioni. Sling, e quindi CQ5, utilizza l’implementazione Apache Felix di OSGI (Open Services Gateway initiative) ed è basata sulle specifiche della piattaforma di servizio OSGi versione 4 versione 4.2. Sono entrambe raccolte di bundle OSGi in esecuzione all’interno di un framework OSGi.

Questo consente di eseguire le azioni seguenti su uno qualsiasi dei pacchetti all’interno dell’installazione:

Per ulteriori informazioni, vedere Console Web, Configurazione OSGI e Impostazioni configurazione OSGi.

Oggetti di sviluppo nell’ambiente AEM development-objects-in-the-aem-environment

Di seguito sono riportati gli elementi di maggiore interesse per lo sviluppo:

Elemento Un elemento è un nodo o una proprietà.

Per informazioni dettagliate sulla manipolazione degli oggetti Item, vedi i documenti Java™ dell'interfaccia javax.jcr.Item

Nodo (e relative proprietà) Nodi e relative proprietà sono definiti nella specifica JCR API 2.0 (JSR 283). Memorizzano il contenuto, le definizioni degli oggetti, gli script di rendering e altri dati.

I nodi definiscono la struttura del contenuto e le relative proprietà memorizzano il contenuto effettivo e i metadati.

I nodi di contenuto guidano il rendering. Sling ottiene il nodo del contenuto dalla richiesta in ingresso. La proprietà sling:resourceType di questo nodo punta al componente di rendering Sling da utilizzare.

Un nodo, che è un nome JCR, è anche chiamato risorsa nell’ambiente Sling.

Ad esempio, per ottenere le proprietà del nodo corrente, puoi utilizzare il seguente codice nello script:

PropertyIterator properties = currentNode.getProperties();

CurrentNode è l'oggetto nodo corrente.

Per ulteriori informazioni sulla manipolazione degli oggetti Node, vedere i documenti Java™.

Widget In AEM tutti gli input utente sono gestiti da widget. Queste vengono spesso utilizzate per controllare la modifica di un contenuto.

Le finestre di dialogo vengono create combinando widget.

L’AEM è stato sviluppato utilizzando la libreria ExtJS di widget.

Finestra di dialogo Una finestra di dialogo è un tipo speciale di widget.

Per modificare il contenuto, l’AEM utilizza le finestre di dialogo definite dallo sviluppatore dell’applicazione. Combinano una serie di widget per presentare all’utente tutti i campi e le azioni necessari per modificare il contenuto correlato.

Le finestre di dialogo vengono utilizzate anche per la modifica dei metadati e da vari strumenti di amministrazione.

Componente Un componente software è un elemento di sistema che offre un servizio o un evento predefinito ed è in grado di comunicare con altri componenti.

All’interno dell’AEM, un componente viene spesso utilizzato per riprodurre il contenuto di una risorsa. Quando la risorsa è una pagina, il componente di cui viene eseguito il rendering è denominato Componente di livello principale o Componente pagina. Tuttavia, un componente non deve eseguire il rendering del contenuto né essere collegato a una risorsa specifica. Ad esempio, un componente di navigazione visualizza informazioni su più risorse.

La definizione di un componente include quanto segue:

Modello Un modello è la base per un tipo specifico di pagina. Durante la creazione di una pagina nella scheda Siti Web, l’utente deve selezionare un modello. La nuova pagina viene quindi creata copiando questo modello.

Un modello è una gerarchia di nodi con la stessa struttura della pagina da creare, ma senza alcun contenuto effettivo.

Definisce il componente Pagina utilizzato per eseguire il rendering della pagina e il contenuto predefinito (contenuto principale di primo livello). Il contenuto definisce il modo in cui viene riprodotto poiché l’AEM è incentrato sui contenuti.

Componente Pagina (Componente Di Livello Superiore) Componente da utilizzare per il rendering della pagina.

Pagina Una pagina è un'istanza di un modello.

Una pagina ha un nodo di gerarchia di tipo cq:Page e un nodo di contenuto di tipo cq:PageContent. La proprietà sling:resourceType del nodo di contenuto punta al componente Pagina utilizzato per il rendering della pagina.

Ad esempio, per ottenere il nome della pagina corrente, è possibile utilizzare il codice seguente nello script:

String pageName = currentPage.getName();

TcurrentPage è l'oggetto della pagina corrente. Per ulteriori informazioni sulla manipolazione degli oggetti Page, vedere i documenti Java™.

Gestione pagine Il gestore pagine è un'interfaccia che fornisce metodi per le operazioni a livello di pagina.

Ad esempio, per ottenere la pagina contenitore di una risorsa, puoi utilizzare il seguente codice nello script:

Page myPage = pageManager.getContainingPage(myResource);

PageManager è l'oggetto di gestione pagina e myResource un oggetto risorsa. Per ulteriori informazioni sui metodi forniti dal gestore delle pagine, consulta la documentazione Java™.

Struttura all’interno del repository structure-within-the-repository

L’elenco seguente offre una panoramica della struttura visualizzata all’interno dell’archivio.

Ambienti environments

Con l'AEM, un ambiente di produzione è spesso costituito da due diversi tipi di istanze: un istanza Autore e un'istanza Publish.

Dispatcher the-dispatcher

Dispatcher è lo strumento di Adobe per il caching e/o il bilanciamento del carico. Ulteriori informazioni sono disponibili in Dispatcher.

FileVault (sistema di revisione sorgente) filevault-source-revision-system

FileVault fornisce all’archivio JCR la mappatura del file system e il controllo della versione. Può essere utilizzato per gestire progetti di sviluppo AEM con supporto completo per l’archiviazione e il controllo delle versioni del codice del progetto, del contenuto, delle configurazioni e così via, nei sistemi di controllo delle versioni standard (ad esempio, Subversion).

Per informazioni dettagliate, consulta la documentazione dello strumento FileVault.

Flussi di lavoro workflows

I contenuti sono spesso soggetti a processi organizzativi, tra cui passaggi quali l’approvazione e l’approvazione da parte di vari partecipanti. Questi processi possono essere rappresentati come flussi di lavoro, definiti e sviluppati all'interno di AEM, quindi applicati alle pagine di contenuto appropriate o alle risorse digitali come richiesto.

Il motore dei flussi di lavoro consente di gestire l’implementazione dei flussi di lavoro e della successiva applicazione ai contenuti.

Gestione multisito multi-site-management

Multi Site Manager (MSM) consente di gestire facilmente più siti Web che condividono contenuti comuni. MSM consente di definire relazioni tra i siti in modo che le modifiche al contenuto in un sito vengano automaticamente replicate in altri siti.

Ad esempio, i siti web sono spesso disponibili in più lingue per il pubblico internazionale. Quando il numero di siti nella stessa lingua è basso (da tre a cinque), è possibile un processo manuale per la sincronizzazione dei contenuti tra siti diversi. Tuttavia, quando il numero di siti aumenta o sono coinvolte più lingue, diventa più efficiente automatizzare il processo.

Per ulteriori informazioni, vedere Gestione multisito.