Personnalisation côté serveur

API Java

Interface du composant social

Les composants sociaux sont des POJO qui représentent une ressource pour une fonction AEM Communities. Idéalement, chaque composant SocialComponent représente un type de ressource spécifique avec des balises GETters exposées qui fournissent des données au client afin que la ressource soit représentée de manière précise. Toute la logique métier et la logique de vue sont encapsulées dans SocialComponent, y compris les informations de session du visiteur du site, si nécessaire.

L’interface définit un ensemble de base de GETters nécessaires pour représenter une ressource. L’interface stipule les méthodes Map<String, Object> getAsMap() et String toJSONString() nécessaires pour rendre les modèles Handlebars et exposer les points de terminaison GET JSON pour les ressources.

Toutes les classes SocialComponent doivent implémenter l’interface com.adobe.cq.social.scf.SocialComponent

Interface SocialCollectionComponent

L’interface SocialCollectionComponent étend l’interface SocialComponent pour mieux représenter les ressources qui sont des collections d’autres ressources.

Toutes les classes SocialCollectionComponent doivent implémenter l’interface com.adobe.cq.social.scf.SocialCollectionComponent

Interface SocialComponentFactory

Une fabrique de composants sociaux (fabrique) enregistre un composant social avec la structure. L’usine permet à la structure de savoir quels composants sociaux sont disponibles pour un type de ressource donné et leur priorité de classement&amp ; ast ; lorsque plusieurs composants sociaux sont identifiés.

Un SocialComponentFactory est responsable de la création d’une instance du SocialComponent sélectionné, ce qui permet d’injecter toutes les dépendances dont le SocialComponent a besoin à partir de l’usine à l’aide des pratiques d’ID.

Un SocialComponentFactory est un service OSGi et a accès à d’autres services OSGi qui peuvent être transmis à SocialComponent par l’intermédiaire d’un constructeur.

Toutes les classes SocialComponentFactory doivent implémenter l'interface com.adobe.cq.social.scf.SocialComponentFactory

Une implémentation de la méthode SocialComponentFactory.getPriority() doit renvoyer la valeur la plus élevée pour que la fabrique soit utilisée pour le type de ressource donné, comme retourné par getResourceType().

Interface SocialComponentFactoryManager

SocialComponentFactoryManager (gestionnaire) gère tous les composants SocialComponents enregistrés dans la structure et est responsable de la sélection de SocialComponentFactory à utiliser pour une ressource donnée (resourceType). Si aucune usine n'est enregistrée pour un type de ressource spécifique, le gestionnaire renvoie une usine avec le type de ressource le plus proche pour la ressource donnée.

Un SocialComponentFactoryManager est un service OSGi et a accès à d’autres services OSGi qui peuvent être transmis à SocialComponent par l’intermédiaire d’un constructeur.

Un handle vers le service OSGi est obtenu en appelant com.adobe.cq.social.scf.SocialComponentFactoryManager

API HTTP - Demandes du POST

PostOperation, classe

Les points de terminaison du POST d'API HTTP sont des classes PostOperation définies en implémentant l'interface SlingPostOperation(package org.apache.sling.servlets.post).

L'implémentation PostOperationpoint de terminaison définit sling.post.operationsur une valeur à laquelle l'opération répondra. Toutes les requêtes du POST dont le paramètre a:operation est défini sur cette valeur seront déléguées à cette classe d'implémentation.

Le PostOperationappelle le SocialOperationqui exécute les actions nécessaires pour l'opération.

PostOperationreçoit le résultat de SocialOperationet renvoie la réponse appropriée au client.

Classe SocialOperation

Chaque point de terminaison SocialOperationétend la classe AbstractSocialOperation et remplace la méthode performOperation().Cette méthode exécute toutes les actions nécessaires pour terminer l'opération et renvoyer une SocialOperationResultou renvoie une OperationException, auquel cas un état d'erreur HTTP avec un message, s'il est disponible, est renvoyé à la place de la réponse JSON normale ou du code d'état HTTP de réussite.

L'extension de AbstractSocialOperationpermet la réutilisation de SocialComponentspour envoyer des réponses JSON.

SocialOperationResult, classe

La classe SocialOperationResultest renvoyée comme résultat de SocialOperationet est composée d'un SocialComponent, d'un code d'état HTTP et d'un message d'état HTTP.

SocialComponentreprésente la ressource qui a été affectée par l'opération.

Pour une opération de création, l'élément SocialComponentinclus dans l'élément SocialOperationResultreprésente la ressource qui vient d'être créée et pour une opération de mise à jour, il représente la ressource qui a été modifiée par l'opération. Aucun élément SocialComponentn'est renvoyé pour une opération de suppression.

Les codes d’état HTTP de réussite utilisés sont les suivants :

• 201 pour les opérations de création
• 200 pour les opérations de mise à jour
• 204 pour les opérations de suppression

Classe OperationException

Un OperationExceptonpeut être envoyé lors de l'exécution d'une opération si la requête n'est pas valide ou qu'une autre erreur se produit, telle que des erreurs internes, des valeurs de paramètre erronées, des autorisations incorrectes, etc. Un OperationExceptionest composé d'un code d'état HTTP et d'un message d'erreur, qui sont renvoyés au client comme réponse à PostOperatoin.

Classe OperationService

La structure des composants sociaux recommande que la logique commerciale responsable de l'exécution de l'opération ne soit pas implémentée dans la classe SocialOperationmais plutôt déléguée à un service OSGi. L'utilisation d'un service OSGi pour la logique métier permet à un SocialComponent, agissant par un point de terminaison SocialOperationd'être intégré à un autre code et d'appliquer une logique métier différente.

Toutes les classes OperationServices'étendent AbstractOperationService, ce qui permet des extensions supplémentaires pouvant être associées à l'opération en cours. Chaque opération du service est représentée par une classe SocialOperation. La classe OperationExtensionspeut être appelée pendant l'exécution de l'opération en appelant les méthodes

• performBeforeActions()
  Permet les pré-contrôles/prétraitement et les validations
• performAfterActions()
  Permet de modifier davantage les ressources ou d’appeler des événements, workflows, etc. personnalisés

OperationExtension Class

OperationExtensionsont des éléments de code personnalisés qui peuvent être injectés dans une opération permettant de personnaliser les opérations en fonction des besoins de l’entreprise. Les utilisateurs du composant peuvent ajouter de manière dynamique et incrémentielle des fonctionnalités au composant. Le modèle extension/hook permet aux développeurs de se concentrer exclusivement sur les extensions elles-mêmes et élimine le besoin de copier et de remplacer des opérations et des composants entiers.

Exemple de code

Un exemple de code est disponible dans le référentiel Adobe Marketing Cloud GitHub. Recherchez des projets avec le préfixe aem-communities ou aem-scf.

Bonnes pratiques

Vue de la section Lignes directrices sur le codage pour connaître les différentes directives de codage et les meilleures pratiques pour les développeurs AEM Communities.

Voir aussi Fournisseur de ressources d’Enregistrement (SRP) pour UGC pour en savoir plus sur l’accès au contenu généré par l’utilisateur.