Das Framework für Social-Komponenten (SCF) vereinfacht den Prozess der Konfiguration, Anpassung und Erweiterung von Communities-Komponenten sowohl serverseitig als auch clientseitig.
Vorteile des Rahmens:
Entdecken Sie eine Instanz im Autoren- oder Veröffentlichungsmodus mithilfe des interaktiven Handbuchs "Community-Komponenten".
In SCF besteht eine Komponente aus einem SocialComponent-POJO, einer Handlebars-JS-Vorlage (zum Rendern der Komponente) und einem CSS (zum Formatieren der Komponente).
Eine Handlebars-JS-Vorlage kann die JS-Komponenten des Modells/der Ansicht erweitern, um die Benutzerinteraktion mit der Komponente auf dem Client zu verarbeiten.
Wenn eine Komponente eine Datenänderung unterstützen muss, kann die Implementierung der SocialComponent-API geschrieben werden, um die Bearbeitung/Speicherung von Daten zu unterstützen, die dem Modell/den Datenobjekten in herkömmlichen Webanwendungen ähnlich sind. Darüber hinaus können Vorgänge (Controller) und ein Vorgangsdienst hinzugefügt werden, um Vorgangsanforderungen zu bearbeiten, Geschäftslogik auszuführen und die APIs auf den Modell-/Datenobjekten aufzurufen.
Die SocialComponent-API kann erweitert werden, um Daten bereitzustellen, die von einem Client für eine Ansichten- oder HTTP-Client benötigt werden.
Um die Komponenten anzupassen oder zu erweitern, schreiben Sie nur die Überlagerungen und Erweiterungen in Ihren /apps-Ordner, was die Aktualisierung auf zukünftige Versionen vereinfacht.
Das Framework stellt APIs zum Zugriff auf Funktionen auf dem Server und zur Unterstützung der Interaktion zwischen Client und Server bereit.
Die Java-APIs bieten abstrakte Klassen und Schnittstellen, die leicht geerbt oder unterklassifiziert werden können.
Die Hauptklassen werden auf der Seite Serverseitige Anpassung beschrieben.
Informationen zum Arbeiten mit UGC finden Sie unter Übersicht über den Ressourcenanbieter der Datenspeicherung.
Die HTTP-API unterstützt die einfache Anpassung und Auswahl von Client-Plattformen für PhoneGap-Apps, native Apps und andere Integrationen und Mashups. Darüber hinaus ermöglicht die HTTP-API es einer Community-Site, als Dienst ohne Client zu laufen, sodass Framework-Komponenten in jede Webseite integriert werden können, die auf einer beliebigen Technologie basiert.
Für jede SocialComponent stellt das Framework einen HTTP-basierten API-Endpunkt bereit. Der Zugriff auf den Endpunkt erfolgt durch Senden einer GET an die Ressource mit der Auswahl ".social.json" + Erweiterung. Mit Sling wird die Anfrage an das DefaultSocialGetServlet
übergeben.
DefaultSocialGetServlet
Übergibt die Ressource (resourceType) an das SocialComponentFactoryManager
und empfängt eine SocialComponentFactory, die eine SocialComponent
auswählen kann, welche die Ressource darstellt.
Ruft die Factory auf und empfängt ein SocialComponent
, das die Ressource und Anforderung bearbeiten kann.
Ruft das SocialComponent
auf, das die Anforderung verarbeitet und eine JSON-Darstellung der Ergebnisse zurückgibt.
Gibt die JSON-Antwort an den Client zurück.
GET Request
Ein standardmäßiges GET-Servlet überwacht Anforderungen vom Typ .social.json, auf die die SocialComponent mit anpassbarer JSON-Datei reagiert.
Zusätzlich zu den Vorgängen "GET (Lesen)"definiert das Framework ein Endpunktmuster, um andere Vorgänge für eine Komponente zu aktivieren, einschließlich Erstellen, Aktualisieren und Löschen. Diese Endpunkte sind HTTP-APIs, die Eingaben akzeptieren und entweder mit HTTP-Statuscodes oder mit einem JSON-Antwortobjekt reagieren.
Dieses Framework-Endpunktmuster macht CUD-Vorgänge erweiterbar, wiederverwendbar und prüfbar.
POST Request
Für jeden SocialComponent-Vorgang gibt es eine Sling POST:operation. Die Geschäftslogik und der Wartungscode für jeden Vorgang werden in einen OperationService eingeschlossen, auf den über die HTTP-API oder von einem anderen Ort aus als OSGi-Dienst zugegriffen werden kann. Haken werden bereitgestellt, die Plug-In-Operationserweiterungen für Vor-/Nach-Aktionen unterstützen.
Informationen zum Umgang mit UGC, die im Community Content Store gespeichert sind, finden Sie unter:
Informationen zum Anpassen der Geschäftslogik und des Verhaltens einer Communities-Komponente auf Serverseite finden Sie unter Serverseitige Anpassungen.
Eine der auffälligsten Änderungen im neuen Framework ist die Verwendung der Handlebars JS-Vorlagenstufe (HBS), einer beliebten Open-Source-Technologie zum Rendern von Server-Clients.
HBS-Skripten sind einfach, logisch-frei, kompiliert auf Server und Client, leicht zu überlagern und anzupassen und natürlich mit dem Client-UX zu binden, da HBS das clientseitige Rendering unterstützt.
Das Framework stellt mehrere Handlebars Helpers bereit, die bei der Entwicklung von SocialComponents nützlich sind.
Wenn Sling auf dem Server eine GET auflöst, identifiziert er das Skript, das zur Beantwortung der Anforderung verwendet wird. Wenn es sich bei dem Skript um eine HBS-Vorlage (.hbs) handelt, leitet Sling die Anforderung an die Handlebars-Engine weiter. Die Handlebars-Engine ruft dann die SocialComponent aus der entsprechenden SocialComponentFactory ab, erstellt einen Kontext und gibt den HTML-Code wieder.
Handlebars (HBS)-Vorlagendateien (.hbs) sind mit .jsp- und .html-Vorlagendateien identisch, können jedoch sowohl im Client-Browser als auch auf dem Server gerendert werden. Daher erhält ein Client-Browser, der eine clientseitige Vorlage anfordert, eine HB-Datei vom Server.
Dies erfordert, dass alle HBS-Vorlagen im sling-Suchpfad (alle .hbs-Dateien unter /libs/ oder /apps) von jedem Benutzer aus dem Autor oder der Veröffentlichung abgerufen werden können.
HTTP-Zugriff auf .hbs-Dateien ist möglicherweise nicht verboten.
Die meisten Communities-Komponenten müssen hinzugefügt als adressierbare Sling-Ressource sein. Einige der Communities-Komponenten können in einer Vorlage als nicht vorhandene Ressource enthalten sein, um eine dynamische Einbindung und Anpassung des Ortes zu ermöglichen, an dem benutzergenerierte Inhalte geschrieben werden (UGC).
In beiden Fällen müssen auch die erforderlichen Client-Bibliotheken der Komponente vorhanden sein.
hinzufügen einer Komponente
Das Hinzufügen einer Komponente bezieht sich auf den Prozess, bei dem eine Instanz einer Ressource (Komponente) hinzugefügt wird, z. B. wenn sie vom Komponenten-Browser (Sidekick) auf eine Seite im Authoring-Bearbeitungsmodus gezogen wird.
Das Ergebnis ist ein untergeordneter JCR-Knoten unter einem par-Knoten, der Sling adressierbar ist.
Komponente einschließen
Das Einschließen einer Komponente bezieht sich auf den Prozess, bei dem innerhalb der Vorlage eine Referenz zu einer nicht vorhandenen Ressource (kein JCR-Knoten) hinzugefügt wird, z. B. mithilfe einer Skriptsprache.
Ab AEM 6.1 ist es möglich, die Eigenschaften der Komponente im Autorenmodus *design *mode zu bearbeiten, wenn eine Komponente dynamisch eingeschlossen und nicht hinzugefügt wird.
Es können nur einige ausgewählte AEM Communities-Komponenten dynamisch eingeschlossen werden. Sie sind:
Das Community-Komponentenleitfaden ermöglicht das Umschalten zwischen den Einschlüssen von inklusiven Komponenten.
Bei Verwendung der Handlebarstemplersprache wird die nicht vorhandene Ressource mit der include- Hilfe eingeschlossen, indem der resourceType angegeben wird:
{{include this.id path="comments" resourceType="social/commons/components/hbs/comments"}}
Bei Verwendung von JSP wird eine Ressource mit dem Tag cq:include eingeschlossen:
<cq:include path="votes"
resourceType="social/tally/components/voting" />
Informationen zum dynamischen Hinzufügen einer Komponente zu einer Seite finden Sie unter Komponenten-Sideloading.
Eine Liste und Beschreibung der in SCF verfügbaren benutzerdefinierten Helfer finden Sie unter SCF Handlebars Helpers.
Das Framework umfasst eine Erweiterung von Backbone.js, einem JavaScript-Framework für Modell-Ansichten, um die Entwicklung von Rich-Interaktive-Komponenten zu erleichtern. Die objektorientierte Natur unterstützt ein erweiterbares/wiederverwendbares Framework. Die Kommunikation zwischen Client und Server wird mithilfe der HTTP-API vereinfacht.
Das Framework nutzt serverseitige Handlebars-Vorlagen, um die Komponenten für den Client wiederzugeben. Die Modelle basieren auf den JSON-Antworten, die von der HTTP-API generiert wurden. Die Ansichten binden sich an HTML, das von den Handlebars-Vorlagen generiert wurde, und bieten Interaktivität.
Die folgenden Konventionen werden zur Definition und Verwendung von CSS-Klassen empfohlen:
.social-forum .topic-list .li { color: blue; }
Zum Anpassen des Erscheinungsbilds und Verhaltens einer Communities-Komponente auf Clientseite verweisen Sie auf Clientseitige Anpassungen, die Informationen zu folgenden Themen enthalten:
Grundlegende Informationen für Entwickler werden im Abschnitt Feature und Component Essentials beschrieben.
Weitere Entwicklerinformationen finden Sie im Abschnitt Coding Guidelines.
Allgemeine Probleme und bekannte Probleme werden im Abschnitt Fehlerbehebung beschrieben.