Arquitectura de contenido content-architecture
Seguir el modelo de David follow-david-s-model
David Nuescheler escribió el Modelo de David hace años, pero sus ideas siguen siendo válidas hoy en día. Los principios principales del Modelo de David son los siguientes:
- Los datos van primero, la estructura después. Tal vez.
- Controle la jerarquía de contenido; no permita que esto ocurra.
- Los espacios de trabajo son para
clone(),merge()yupdate(). - Tenga cuidado con los hermanos del mismo nombre.
- Las referencias pueden considerarse perjudiciales.
- Los archivos son archivos.
- Los identificadores son malvados.
El modelo de David se encuentra en la wiki de Jackrabbit en https://wiki.apache.org/jackrabbit/DavidsModel.
Todo está contenido everything-is-content
Todo debe almacenarse en el repositorio, en lugar de depender de fuentes de datos de terceros independientes, como bases de datos. Este enfoque se aplica al contenido creado, a los datos binarios como imágenes, códigos y configuraciones. Permite utilizar un conjunto de API para administrar todo el contenido y administrar la promoción de este contenido a través de la replicación. También obtiene una única fuente de copia de seguridad, registro, etc.
Utilice el principio de diseño "el modelo de contenido primero" use-the-content-model-first-design-principle
Al crear una nueva función, comience siempre por diseñar primero la estructura de contenido JCR y, a continuación, busque leer y escribir el contenido utilizando los servlets predeterminados de Sling. Este enfoque le permite asegurarse de que la implementación funciona correctamente con los mecanismos de control de acceso predeterminados y evitar generar servlets innecesarios de estilo CRUD.
Ser RESTful be-restful
Defina servlets basados en resourceTypes en lugar de rutas. Este método permite utilizar controles de acceso JCR, adherirse a los principios de REST y utilizar el solucionador de recursos y recursos que se nos proporciona en la solicitud. Este método permite cambiar los scripts que representan las direcciones URL en el servidor sin cambiar ninguna dirección URL del lado del cliente. También oculta los detalles de implementación del lado del servidor del cliente para una mayor seguridad.
Evite definir nuevos tipos de nodo avoid-defining-new-node-types
Los tipos de nodo funcionan a un nivel bajo en la capa de infraestructura. La mayoría de los requisitos se cumplen usando un nodo sling:resourceType asignado a un tipo de nodo nt:unstructured, oak:Unstructured, sling:Folder o cq:Page. Los tipos de nodo equivalen al esquema en el repositorio y cambiar los tipos de nodo puede resultar caro en el futuro.
Respetar las convenciones de nomenclatura en JCR. adhere-to-naming-conventions-in-the-jcr
El cumplimiento de las convenciones de nomenclatura agrega coherencia a la base de código, reduciendo la tasa de incidencia de defectos y aumentando la velocidad de los desarrolladores que trabajan en el sistema. Adobe utiliza las siguientes convenciones para desarrollar AEM:
-
Nombres de nodo
- Todo en minúsculas.
- Separación de palabras mediante guiones.
-
Nombres de propiedades
- Mayúsculas y minúsculas, empezando por una letra minúscula.
-
Componentes (JSP/HTML)
- Todo en minúsculas.
- Separación de palabras mediante guiones.