Serverseitige Anpassung server-side-customization

Java™-APIs java-apis

SocialComponent-Schnittstelle socialcomponent-interface

SocialComponents sind POJOs, die eine Ressource für eine AEM Communities-Funktion darstellen. Idealerweise stellt jede SocialComponent einen bestimmten resourceType mit offen gelegten GETters dar, die dem Client Daten bereitstellen, damit die Ressource korrekt dargestellt wird. Die gesamte Geschäfts- und Ansichtslogik ist in die SocialComponent eingeschlossen, einschließlich der Sitzungsinformationen des Site-Besuchers, sofern erforderlich.

Die Schnittstelle definiert einen grundlegenden Satz von GETters, die für die Darstellung einer Ressource erforderlich sind. Wichtig ist, dass die Schnittstelle die Methoden Map<String, Object> getAsMap() und String toJSONString() vorschreibt, die zum Rendern von Handlebars-Vorlagen und zum Bereitstellen von GET JSON-Endpunkten für Ressourcen erforderlich sind.

Alle SocialComponent-Klassen müssen die Schnittstelle com.adobe.cq.social.scf.SocialComponent implementieren

SocialCollectionComponent-Schnittstelle socialcollectioncomponent-interface

Die Schnittstelle SocialCollectionComponent erweitert die Schnittstelle SocialComponent , um Ressourcen besser darzustellen, die Sammlungen anderer Ressourcen sind.

Alle SocialCollectionComponent-Klassen müssen die Schnittstelle com.adobe.cq.social.scf.SocialCollectionComponent implementieren

SocialComponentFactory-Schnittstelle socialcomponentfactory-interface

Eine SocialComponentFactory (Factory) registriert eine SocialComponent mit dem Framework. Die Factory bietet eine Möglichkeit, dem Framework mitzuteilen, welche SocialComponents für einen bestimmten resourceType verfügbar sind, und seine Prioritätsstufe zu geben, wenn mehrere SocialComponents identifiziert werden.

Eine SocialComponentFactory ist für das Erstellen einer Instanz der ausgewählten SocialComponent verantwortlich, die es ermöglicht, alle Abhängigkeiten, die von der SocialComponent benötigt werden, mithilfe von DI-Verfahren aus der Factory einzufügen.

Eine SocialComponentFactory ist ein OSGi-Dienst und hat Zugriff auf andere OSGi-Dienste, die über einen Konstruktor an die SocialComponent übergeben werden können.

Alle SocialComponentFactory-Klassen müssen die Schnittstelle com.adobe.cq.social.scf.SocialComponentFactory implementieren

Eine Implementierung der Methode SocialComponentFactory.getPriority() sollte den höchsten Wert für die Factory zurückgeben, die für den angegebenen resourceType verwendet werden soll, wie von getResourceType() zurückgegeben.

SocialComponentFactoryManager-Schnittstelle socialcomponentfactorymanager-interface

Der SocialComponentFactoryManager (manager) verwaltet alle im Framework registrierten SocialComponents und ist für die Auswahl der SocialComponentFactory für eine bestimmte Ressource (resourceType) verantwortlich. Wenn für einen bestimmten resourceType keine Fabriken registriert sind, gibt der Manager eine Factory mit dem nächsten Supertyp für die jeweilige Ressource zurück.

Ein SocialComponentFactoryManager ist ein OSGi-Dienst und hat Zugriff auf andere OSGi-Dienste, die über einen Konstruktor an die SocialComponent übergeben werden können.

Ein Handle für den OSGi-Dienst wird durch Aufrufen von com.adobe.cq.social.scf.SocialComponentFactoryManager abgerufen

HTTP-API - POST-Anfragen http-api-post-requests

PostOperation-Klasse postoperation-class

Die HTTP-API-POST-Endpunkte sind PostOperation-Klassen, die durch Implementierung der SlingPostOperation -Schnittstelle (package org.apache.sling.servlets.post) definiert werden.

Die Implementierung des Endpunkts PostOperation setzt sling.post.operation auf einen Wert, auf den der Vorgang reagiert. Alle POST-Anfragen mit einem:operation -Parameter, der auf diesen Wert gesetzt ist, werden dieser Implementierungsklasse zugewiesen.

Die PostOperation ruft die SocialOperation auf, die die für den Vorgang erforderlichen Aktionen ausführt.

Die PostOperation erhält das Ergebnis von der SocialOperation und gibt die entsprechende Antwort an den Client zurück.

SocialOperation-Klasse socialoperation-class

Jeder SocialOperation -Endpunkt erweitert die Klasse AbstractSocialOperation und überschreibt die Methode performOperation(). Diese Methode führt alle Aktionen aus, die zum Abschließen des Vorgangs und zum Zurückgeben eines SocialOperationResult erforderlich sind, sonst wird ein OperationException ausgegeben. In diesem Fall wird anstelle des normalen JSON-Antwort- oder Erfolgs-HTTP-Status-Codes ein HTTP-Fehlerstatus mit einer Nachricht zurückgegeben, sofern verfügbar.

Die Erweiterung von AbstractSocialOperation ermöglicht die Wiederverwendung von SocialComponents zum Senden von JSON-Antworten.

SocialOperationResult-Klasse socialoperationresult-class

Die SocialOperationResult -Klasse wird als Ergebnis des SocialOperation zurückgegeben und besteht aus einer SocialComponent-, HTTP-Status-Code- und HTTP-Statusmeldung.

Der SocialComponent stellt die Ressource dar, die vom Vorgang betroffen war.

Bei einem Vorgang vom Typ Erstellen steht der im SocialOperationResult enthaltene SocialComponent für die erstellte Ressource und bei einem Vorgang vom Typ Aktualisieren für die Ressource, die durch den Vorgang verändert wurde. Für einen Löschvorgang wird kein SocialComponent zurückgegeben.

Folgende Erfolgs-HTTP-Status-Codes werden verwendet:

OperationException-Klasse operationexception-class

Beim Ausführen eines Vorgangs wird ein OperationExcepton ausgegeben, wenn die Anfrage ungültig ist oder ein anderer Fehler auftritt. Zum Beispiel interne Fehler, ungültige Parameterwerte oder falsche Berechtigungen. Eine OperationException besteht aus einem HTTP-Statuscode und einer Fehlermeldung, die als Antwort auf die PostOperatoin an den Client zurückgegeben werden.

OperationService-Klasse operationservice-class

Das Social-Komponenten-Framework empfiehlt, dass die für die Ausführung des Vorgangs verantwortliche Geschäftslogik nicht innerhalb der SocialOperation -Klasse implementiert, sondern stattdessen an einen OSGi-Dienst delegiert wird. Durch die Verwendung eines OSGi-Diensts für Geschäftslogik kann ein SocialComponent, auf das ein SocialOperation -Endpunkt reagiert, in anderen Code integriert werden und unterschiedliche Geschäftslogik angewendet werden.

Alle OperationService Klassen erweitern AbstractOperationService, wodurch zusätzliche Erweiterungen möglich sind, die in den ausgeführten Vorgang eingebunden werden können. Jeder Vorgang im Dienst wird durch eine SocialOperation -Klasse dargestellt. Die OperationExtensions-Klasse kann während der Vorgangsausführung durch Aufruf der Methoden aufgerufen werden

OperationExtension-Klasse operationextension-class

Die OperationExtension -Klassen sind benutzerdefinierte Code-Abschnitte, die in einen Vorgang eingefügt werden können, der eine Anpassung der Vorgänge an die Geschäftsanforderungen ermöglicht. Die Verbraucher der Komponente können der Komponente dynamisch und schrittweise Funktionen hinzufügen. Das Erweiterungs-/Erweiterungs-Muster ermöglicht es Entwicklern, sich ausschließlich auf die Erweiterungen selbst zu konzentrieren, und macht das Kopieren und Überschreiben ganzer Vorgänge und Komponenten überflüssig.

Beispielcode sample-code

Beispielcode ist im Repository Adobe Experience Cloud GitHub verfügbar. Suchen Sie nach Projekten mit dem Präfix aem-communities oder aem-scf.

Best Practices best-practices

Im Abschnitt Coding Guidelines finden Sie verschiedene Codierungsrichtlinien und Best Practices für AEM Communities-Entwickler.

Weitere Informationen zum Zugriff auf benutzergenerierte Inhalte finden Sie unter SRP (Storage Resource Provider) für UGC .