Activation de l’exportateur JSON pour un composant

Dernière mise à jour : 2024-02-26

Les composants peuvent être adaptés pour générer l’exportation JSON de leur contenu en fonction d’un framework de modeleur.

Vue d’ensemble

L’exportation JSON est basée sur des modèles Sling et sur le framework d’exportation des modèles Sling (lequel s’appuie lui-même sur des annotations Jackson).

Cela signifie que le composant doit disposer d’un modèle Sling s’il doit exporter le fichier JSON. Par conséquent, suivez ces deux étapes pour activer l’exportation JSON sur n’importe quel composant.

Définition d’un modèle Sling pour le composant

Il faut d’abord définir un modèle Sling pour le composant.

REMARQUE

Pour obtenir un exemple d’utilisation des modèles Sling, consultez l’article sur le développement d’exportateurs de modèles Sling dans AEM.

La classe de mise en œuvre des modèles Sling doit être annotée comme suit :

@Model(... adapters = {..., ComponentExporter.class})
@Exporter(name = ExporterConstants.SLING_MODEL_EXPORTER_NAME, extensions = ExporterConstants.SLING_MODEL_EXTENSION)
@JsonSerialize(as = MyComponent.class)

Cela garantit que votre composant peut être exporté seul, à l’aide du sélecteur .model de l’extension .json.

En outre, cela indique que la classe de modèles Sling peut être adaptée dans l’interface ComponentExporter.

REMARQUE

Les annotations Jackson ne sont généralement pas spécifiées au niveau de la classe de modèles Sling, mais plutôt au niveau de l’interface de modèle. Cela permet de s’assurer que l’exportation du code JSON est considéré comme faisant partie de l’API du composant.

REMARQUE

Les classes ExporterConstants et ComponentExporter proviennent du lot com.adobe.cq.export.json.

Utilisation de plusieurs sélecteurs

Bien qu’il ne s’agisse pas d’un cas d’utilisation standard, il est possible de configurer plusieurs sélecteurs en plus du sélecteur model.

https://<server>:<port>/content/page.model.selector1.selector2.json

Toutefois, dans ce cas, le sélecteur model doit être le premier et l’extension doit être .json.

Annotation de l’interface du modèle Sling

Pour être prise en compte par le framework de l’exportateur JSON, l’interface Modèle doit mettre en œuvre l’interface ComponentExporter (ou ContainerExporter dans le cas d’un composant de conteneur).

L’interface de modèle Sling correspondante (MyComponent) est alors marquée avec les annotations Jackson pour définir la manière dont les méthodes doivent être exportées (sérialisées).

L’interface de modèle doit être correctement annotée afin de définir les méthodes à sérialiser. Par défaut, toutes les méthodes qui respectent la convention de nommage habituelle pour les méthodes getter sont sérialisées. En outre, leurs noms de propriétés JSON sont naturellement dérivés des noms des méthodes getter. Cela peut être évité en utilisant @JsonIgnore ou @JsonProperty pour renommer la propriété JSON.

Exemple

Les composants principaux prennent en charge l’exportation JSON et peuvent être utilisés comme référence.

Pour obtenir un exemple, consultez la mise en œuvre du modèle Sling sur le composant principal de l’image et son interface annotée.

Sur cette page