El documento presenta una introducción a JCR (Content Repository API para Java) y Jackrabbit, una implementación de referencia de JCR. Explica conceptos clave como nodos, tipos de nodos, observación, búsqueda, versionado, importación/exportación, ordenamiento y seguridad. JCR provee una estructura jerárquica para almacenar datos y metadatos que puede ser utilizada por aplicaciones de gestión de contenidos.

1. Presentador Edwin Guilbert
Recorrido por el Content Repository API para Java (JCR),
analizando JackRabbit.
20 de Mayo, 2015
JCR

2. ¿QUÉ ES JCR?
!
Content Repository API para Java:
!
CMS
Java Standard: JSR-170, JSR-283
Object database para guardar, buscar y obtener datos
jerárquicos
Java Package: javax.jcr

4. ¿QUÉ ES JACKRABBIT?
!
Implementación de referencia de JCR:
!
!
Session
Repository
Node

6. NODE TYPES
!
Define los nodos hijo y sus propiedades. Sirve de modelo de
contenidos para aplicaciones:
!
Primary type: Estructura del nodo. Propiedades, hijos,
herencia
!
Mixin: Capacidad con propiedades o nodos hijos

7. Primary: Product
<nodeTypes
xmlns:rep="internal"
xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
xmlns:mix="http://www.jcp.org/jcr/mix/1.0"
xmlns:mgnl="http://www.magnolia.info/jcr/mgnl"
xmlns:jcr="http://www.jcp.org/jcr/1.0">
<!-- custom node types -->
<nodeType name="mgnl:product" isMixin="false"
hasOrderableChildNodes="true" primaryItemName="">
<supertypes>
<supertype>mgnl:content</supertype>
</supertypes>
</nodeType>
</nodeTypes>

8. Primary: Content
<nodeType name="mgnl:contentNode" isMixin="false" hasOrderableChildNodes="true"
primaryItemName="">
<supertypes>
<supertype>nt:hierarchyNode</supertype>
<supertype>mix:referenceable</supertype>
<supertype>mgnl:created</supertype>
<supertype>mgnl:activatable</supertype>
<supertype>mgnl:lastModified</supertype>
<supertype>mgnl:renderable</supertype>
</supertypes>
<childNodeDefinition name="*" defaultPrimaryType="" autoCreated="false" mandatory="false"
onParentVersion="COPY" protected="false" sameNameSiblings="false">
<requiredPrimaryTypes>
<requiredPrimaryType>nt:base</requiredPrimaryType>
</requiredPrimaryTypes>
</childNodeDefinition>
<propertyDefinition name="*" requiredType="undefined" autoCreated="false" mandatory="false"
onParentVersion="COPY" protected="false" multiple="false"/>
<propertyDefinition name="*" requiredType="undefined" autoCreated="false" mandatory="false"
onParentVersion="COPY" protected="false" multiple="true"/>
</nodeType>

9. Mixin: Created
<nodeType name="mgnl:created" isMixin=“true">
!
<supertypes>
<supertype>nt:base</supertype>
</supertypes>
!
<propertyDefinition name="mgnl:created" requiredType="Date"
autoCreated="false" mandatory="false" onParentVersion="COPY"
protected="false" multiple=“false"/>
!
<propertyDefinition name="mgnl:createdBy" requiredType="String"
autoCreated="false" mandatory="false" onParentVersion="COPY"
protected="false" multiple=“false"/>
!
</nodeType>

10. BENEFICIOS DE JCR
Estructura Jerárquica
Observación
Búsqueda
Versionado
Exportar
Importar
Ordenamiento
Seguridad

11. ESTRUCTURA JERÁRQUICA
Los datos en JCR consisten en un árbol de nodos con
propiedades asociadas:
!
Los datos se almacenan en propiedades
Strings o datos binarios
Un nodo puede tener uno o mas NodeTypes asociados
Propiedad especial que permite referenciar nodos entre sí
Herencia/Integridad referencial
JCR+API

12. REPOSITORIO Y WORKSPACES
!
!
Carpetas comparables con nodos
!
Ficheros comparables con
propiedades
!
Navegación por path:
/A/B/property

14. OBSERVACIÓN
!
Permite a las aplicaciones recibir notificaciones sobre
cambios en un workspace:
!
Modelo de eventos
Tipos de evento: Agregar, remover, persistir
Propiedades de evento: Path, identificador, usuario, fecha

15. ObservationManager:addEventListener
!
ObservationUtil.registerDeferredChangeListener(
RepositoryConstants.CONFIG,
SERVER_FILTERS,
filtersEventListener,
1000,
5000);
!
!
ObservationManager observationManager = getObservationManager(workspace);
!
observationManager.addEventListener(listener, eventTypesMask,
observationPath, includeSubnodes, null, nodeTypes, false);

16. EventListener por Workspace
!
public class CommandEventListener implements EventListener {
!
public void onEvent(EventIterator events) {
!
while (events.hasNext()) {
!
event = events.nextEvent();
!
path = getPath(event);
!
Context executionCtx = this.createContext();
!
executionCtx.put(Context.ATTRIBUTE_PATH, path);
!
getCommand().execute(executionCtx);
}
}
}

17. BÚSQUEDA
!
JSR-283 establece que se debe soportar una forma
estandarizada de SQL:
!
Abstract Query Model
Lenguajes: JCR-SQL2 y JCR-JQOM
Semántica: Selectores, Joins, Constraints, Orderings,
Query results
JCR Query Cheat Sheet

19. VERSIONADO
El versionado permite al usuario guardar y restaurar el estado
de un nodo y su sub-árbol:
!
Version
<mix:versionable> subtipo de <mix:referenceable>
Checkin, checkout y checkpoint
VersionHistory / VersionStorage
Base version
Frozen nodes

21. protected Version createVersion(Node node, Rule rule, String userName)
throws UnsupportedRepositoryOperationException,
RepositoryException {
!
node.addMixin(“mix:versionable");
node.addMixin.save();
!
// add version
Version newVersion = node.checkin();
node.checkout();
!
}
!
BaseVersionManager: createVersion

22. public synchronized void restore(final Node node, Version version,
boolean removeExisting)
throws VersionException, UnsupportedRepositoryOperationException,
RepositoryException {
!
!
node.restore(unwrappedVersion, removeExisting);
!
node.checkout();
!
!
}
BaseVersionManager: restore

23. IMPORTAR / EXPORTAR
JCR provee serialización convirtiendo a XML el contenido del
workspace sin pérdida de información:
!
XML refleja estructura jerárquica de JCR
Namespace: sv: http://www.jcp.org/jcr/sv/1.0
Nodos se convierten en <sv:node>
Propiedades se convierten en <sv:property>
Nombres se convierten en atributo sv:name=“”

25. !
!
!
Session session = ws.getSession();
!
!
session.importXML(basepath, xmlStream, importMode);
!
!
session.exportSystemView(basepath, outputStream, false, false);
DataTransporter: import export

26. ORDENAMIENTO
!
JCR permite que los nodos tengan un ordenamiento dentro
del árbol jerárquico:
!
Propiedades no son ordenables
<nodeType name="mgnl:content" hasOrderableChildNodes=“true">
Node.getNodes() siempre tiene un orden
El nodo padre ordena a sus hijos

27. !
!
!
public static void orderBefore(Node node, String siblingName)
throws RepositoryException {
!
node.getParent().orderBefore(node.getName(), siblingName);
!
}
!
!
!
NodeUtil: orderBefore

28. SEGURIDAD
!
JCR permite la gestión de control de acceso en el repositorio:
!
AccessControlManager
Privilegios que un usuario tiene sobre un nodo
jcr:read Obtener un nodo y sus propiedades
jcr:write Modificar propiedades, agregar/eliminar nodos

29. Roles provide fine-grained access
controls for both Apps and site URLs

30. public void addPermission(final Role role, final String workspace, final
String path, final long permission) {
!
Node roleNode = session.getNodeByIdentifier(role.getId());
Node aclNode = getAclNode(roleNode, workspace);
if (!existsPermission(aclNode, path, permission)) {
String nodeName = Path.getUniqueLabel(session, aclNode.getPath(), "0");
Node node = aclNode.addNode(nodeName, NodeTypes.ContentNode.NAME);
node.setProperty("path", path);
node.setProperty("permissions", permission);
session.save();
}
!
}
MgnlRoleManager: addPermission

31. BUSINESS APPS