Skip to content

Custom node type phpcr:managed

dbu edited this page Nov 23, 2011 · 17 revisions

The PHPCR odm stores meta information into the PHPCR node for each document. To avoid collisions and avoid issues with built-in types, every nodes gets the mixin type phpcr:managed that defines a phpcr:alias property. That way, meta information can be added to any node in a clean way.

Set up

See the README file of the project.

What are NodeTypes

JCR defines node types which can be thought of a kind of schema for the repository's nodes. These types define the properties and children a node can have. JCR defines a set of node types that can be readily used. Some node types like nt:file restrict the set of allowed properties others like nt:unstructured allow any kind of properties and child nodes.

Why a custom node type

The PHPCR ODM stores with every node the alias of the document the node corresponds to. Therefore it adds a property named phpcr:alias to the node. If you use a node type like nt:file that does not allow free properties the node can not be saved when there are additional properties. Since the ODM uses the information stored in the property to construct the proper class when a node is read we need to find a way to store that property with all nodes managed by the ODM.

Node type phpcr:managed

The node type phpcr:managed defines that property. When this node type is registered with the repository we can simply add that type to the node when the node is created.