Activación de la exportación de JSON para un componente

Los componentes se pueden adaptar para generar la exportación JSON de su contenido en función de un marco de modelos.

Información general

La exportación JSON se basa en Modelos Sling y en el marco Sling Model Exporter (que se basa en anotaciones Jackson).

Esto significa que el componente debe tener un modelo de Sling si necesita exportar JSON. Por lo tanto, debe seguir estos dos pasos para habilitar la exportación de JSON en cualquier componente.

Definir un modelo de Sling para el componente

Primero debe definirse un modelo de Sling para el componente.

NOTA

Para ver un ejemplo del uso de modelos Sling, consulte el artículo Desarrollo de exportadores de modelos Sling en AEM.

La clase de implementación del modelo de Sling debe estar anotada con lo siguiente:

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

Esto garantiza que el componente se pueda exportar por su cuenta, utilizando el selector .model y la extensión .json.

Además, esto especifica que la clase del Modelo Sling se puede adaptar a la interfaz ComponentExporter.

NOTA

Las anotaciones Jackson no suelen especificarse en el nivel de clase del Modelo Sling, sino en el nivel de interfaz del Modelo. Esto sirve para garantizar que la exportación de JSON se considere parte de la API de componente.

NOTA

Las clases ExporterConstants y ComponentExporter provienen del paquete com.adobe.cq.export.json.

Uso de varios selectores

Aunque no es un caso de uso estándar, es posible configurar varios selectores además del selector model.

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

Sin embargo, en tal caso el selector model debe ser el primer selector y la extensión debe ser .json.

Anotar la interfaz del modelo de Sling

Para que el marco del exportador JSON lo tenga en cuenta, la interfaz del modelo debe implementar la interfaz ComponentExporter (o ContainerExporter, en el caso de un componente contenedor).

La interfaz del modelo de Sling correspondiente (MyComponent) se anotaría utilizando anotaciones Jackson para definir cómo se debe exportar (serializado).

La interfaz del modelo debe estar debidamente anotada para definir qué métodos deben serializarse. De forma predeterminada, todos los métodos que respetan la convención de nombres habitual para los captadores se serializarán y derivarán sus nombres de propiedades JSON de forma natural de los nombres de los captadores. Esto se puede evitar o sobrescribir usando @JsonIgnore o @JsonProperty para cambiar el nombre de la propiedad JSON.

Ejemplo

Los componentes principales admiten la exportación JSON y pueden utilizarse como referencia.

Para ver un ejemplo, consulte la implementación del modelo Sling del componente principal de imagen y su interfaz anotada.

Para obtener más información, consulte:

En esta página