Presentador Edwin Guilbert Recorrido por el Content Repository API para Java (JCR),

analizando JackRabbit.20 de Mayo, 2015

JCR

¿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

¿QUÉ ES JACKRABBIT?!

Implementación de referencia de JCR: !

!

Session Repository Node

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

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>

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>

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>

BENEFICIOS DE JCREstructura Jerárquica Observación Búsqueda Versionado Exportar Importar Ordenamiento Seguridad

ESTRUCTURA JERÁRQUICALos 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

REPOSITORIO Y WORKSPACES!

!

Carpetas comparables con nodos !

Ficheros comparables con propiedades !

Navegación por path: /A/B/property

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

ObservationManager:addEventListener !

ObservationUtil.registerDeferredChangeListener( RepositoryConstants.CONFIG, SERVER_FILTERS, filtersEventListener, 1000, 5000); !

!

ObservationManager observationManager = getObservationManager(workspace); !

observationManager.addEventListener(listener, eventTypesMask, observationPath, includeSubnodes, null, nodeTypes, false);

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); } } }

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

VERSIONADOEl 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

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

public synchronized void restore(final Node node, Version version, boolean removeExisting) throws VersionException, UnsupportedRepositoryOperationException, RepositoryException { !

!

node.restore(unwrappedVersion, removeExisting); !

node.checkout(); !

!

}

BaseVersionManager: restore

IMPORTAR / EXPORTARJCR 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=“”

!

!

!

Session session = ws.getSession(); !

!

session.importXML(basepath, xmlStream, importMode); !

!

session.exportSystemView(basepath, outputStream, false, false);

DataTransporter: import export

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

!

!

!

public static void orderBefore(Node node, String siblingName) throws RepositoryException { !

node.getParent().orderBefore(node.getName(), siblingName); !

} !

!

!

NodeUtil: orderBefore

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

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

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

BUSINESS APPS