Serverseitige Anpassung

⇐ Essentials Clientseitige Anpassung ⇒
SCF-Handlebars Helpers ⇒

Java-APIs

HINWEIS

Der Speicherort des Pakets von Communities-APIs kann sich ändern, wenn von einer Hauptversion zur nächsten aktualisiert wird.

SocialComponent-Schnittstelle

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äftslogik und die Logik der Ansicht sind in der SocialComponent eingeschlossen, einschließlich der Sitzungsinformationen des Site-Besuchers, sofern erforderlich.

Die Schnittstelle definiert einen grundlegenden Satz von GETters, die zur Darstellung einer Ressource erforderlich sind. Wichtig ist, dass in der Schnittstelle die Methoden Map<String, Object> getAsMap() und String toJSONString() festgelegt sind, 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

Die SocialCollectionComponent-Schnittstelle erweitert die SocialComponent-Schnittstelle, 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

Eine SocialComponentFactory (Factory) registriert eine SocialComponent mit dem Framework. Die Factory bietet eine Möglichkeit, das Framework darüber zu informieren, welche SocialComponents für einen bestimmten resourceType verfügbar sind und welche Priorität ranking&ast; wenn mehrere SocialComponents identifiziert werden.

Eine SocialComponentFactory ist für das Erstellen einer Instanz der ausgewählten SocialComponent zuständig, sodass alle Abhängigkeiten, die von der SocialComponent benötigt werden, mithilfe von DI-Verfahren aus der Factory eingefügt werden können.

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 zurückgeben, damit die Factory für den angegebenen resourceType verwendet wird, wie von getResourceType() zurückgegeben.

SocialComponentFactoryManager-Schnittstelle

Der SocialComponentFactoryManager (Manager) verwaltet alle im Framework registrierten SocialComponents und ist für die Auswahl der SocialComponentFactory für eine bestimmte Ressource (resourceType) zuständig. Wenn keine Fabriken für einen bestimmten resourceType 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

PostOperation-Klasse

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

Die PostOperationEndimplementierung setzt sling.post.operationauf einen Wert, auf den der Vorgang reagieren soll. Alle POST-Anfragen mit einem:operation-Parameter, der auf diesen Wert gesetzt ist, werden dieser Implementierungsklasse übertragen.

Das PostOperationruft das SocialOperationauf, das die für den Vorgang erforderlichen Aktionen ausführt.

PostOperationempfängt das Ergebnis von SocialOperationund gibt die entsprechende Antwort an den Client zurück.

SocialOperation-Klasse

Jeder SocialOperationEndpunkt erweitert die AbstractSocialOperation-Klasse und überschreibt die Methode performOperation().Diese Methode führt alle erforderlichen Aktionen aus, um den Vorgang abzuschließen und ein SocialOperationResultzurückzugeben oder stattdessen ein OperationException zu werfen. In diesem Fall wird anstelle der normalen JSON-Antwort- oder HTTP-Statuscode ein HTTP-Fehlerstatus mit einer Meldung zurückgegeben, falls verfügbar.

Die Erweiterung von AbstractSocialOperationermöglicht die Wiederverwendung von SocialComponentszum Senden von JSON-Antworten.

SocialOperationResult-Klasse

Die SocialOperationResultKlasse wird als Ergebnis von SocialOperationzurückgegeben und besteht aus einer SocialComponent-, HTTP-Statuscode- und HTTP-Statusmeldung.

SocialComponentstellt die Ressource dar, die von dem Vorgang betroffen war.

Bei einem Create-Vorgang stellt das SocialComponentim SocialOperationResultenthaltene Element die soeben erstellte Ressource und bei einem Update-Vorgang die Ressource dar, die durch den Vorgang geändert wurde. Für einen Löschvorgang wird kein SocialComponentzurückgegeben.

Die verwendeten Erfolgs-HTTP-Statuscodes sind

  • 201 für Create-Vorgänge
  • 200 für Aktualisierungsvorgänge
  • 204 für Löschvorgänge

OperationException-Klasse

Bei Ausführung eines Vorgangs kann ein OperationExceptonausgegeben werden, wenn die Anforderung ungültig ist oder ein anderer Fehler auftritt, z. B. interne Fehler, ungültige Parameterwerte, falsche Berechtigungen usw. Ein OperationExceptionbesteht aus einem HTTP-Statuscode und einer Fehlermeldung, die als Antwort auf PostOperatoin an den Client zurückgegeben werden.

OperationService-Klasse

Das Framework für soziale Komponenten empfiehlt, dass die Geschäftslogik, die für die Ausführung des Vorgangs verantwortlich ist, nicht innerhalb der Klasse SocialOperationimplementiert, sondern stattdessen an einen OSGi-Dienst delegiert wird. Durch die Verwendung eines OSGi-Dienstes für Geschäftslogik kann ein SocialComponent, der von einem SocialOperationEndpunkt ausgeführt wird, in anderen Code integriert werden und unterschiedliche Geschäftslogik angewendet werden.

Alle OperationServiceKlassen erweitern AbstractOperationService, wodurch zusätzliche Erweiterungen möglich sind, die mit dem ausgeführten Vorgang verknüpft werden können. Jeder Vorgang im Dienst wird durch eine SocialOperationKlasse dargestellt. Die OperationExtensionsKlasse kann während der Ausführung des Vorgangs durch Aufruf der Methoden aufgerufen werden

  • performBeforeActions()
    Ermöglicht die Vorab-/Vorverarbeitung und Überprüfung
  • performAfterActions()
    Ermöglicht eine weitere Änderung der Ressourcen oder das Aufrufen benutzerdefinierter Ereignis, Workflows usw.

OperationExtension-Klasse

OperationExtensionKlassen sind benutzerdefinierte Codeabschnitte, die in einen Vorgang eingefügt werden können, der eine Anpassung der Vorgänge an die geschäftlichen Anforderungen ermöglicht. Die Benutzer der Komponente können der Komponente dynamisch und inkrementell Funktionen hinzufügen. Das Erweiterungs-/Hakenmuster ermöglicht es Entwicklern, sich ausschließlich auf die Erweiterungen selbst zu konzentrieren und entfernt die Notwendigkeit, ganze Vorgänge und Komponenten zu kopieren und zu überschreiben.

Beispielcode

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

Best Practices

Ansicht der Coding Guidelines für verschiedene Codierungsrichtlinien und Best Practices für AEM Communities-Entwickler.

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

⇐ Essentials Clientseitige Anpassung ⇒
SCF-Handlebars Helpers ⇒

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free