]> git.argeo.org Git - lgpl/argeo-commons.git/blobdiff - server/runtime/org.argeo.server.jackrabbit/src/main/java/org/argeo/jcr/BeanNodeMapper.java
Add utilities
[lgpl/argeo-commons.git] / server / runtime / org.argeo.server.jackrabbit / src / main / java / org / argeo / jcr / BeanNodeMapper.java
index d05af407f33e3996e696c871bf0d146746868588..6f282bac7177143da530bc4f55df4d5b7f0f4c4c 100644 (file)
@@ -28,7 +28,7 @@ import org.argeo.ArgeoException;
 import org.springframework.beans.BeanWrapper;
 import org.springframework.beans.BeanWrapperImpl;
 
-public class BeanNodeMapper {
+public class BeanNodeMapper implements NodeMapper {
        private final static Log log = LogFactory.getLog(BeanNodeMapper.class);
 
        private final static String NODE_VALUE = "value";
@@ -39,34 +39,64 @@ public class BeanNodeMapper {
 
        private Boolean versioning = false;
        private Boolean strictUuidReference = false;
+
+       // TODO define a primaryNodeType Strategy
        private String primaryNodeType = null;
 
        private ClassLoader classLoader = getClass().getClassLoader();
 
-       public String storagePath(Object obj) {
-               String clss = obj.getClass().getName();
-               StringBuffer buf = new StringBuffer("/objects/");
-               StringTokenizer st = new StringTokenizer(clss, ".");
-               while (st.hasMoreTokens()) {
-                       buf.append(st.nextToken()).append('/');
-               }
-               buf.append(obj.toString());
-               return buf.toString();
-       }
+       private NodeMapperProvider nodeMapperProvider;
 
-       public Node save(Session session, Object obj) {
-               return save(session, storagePath(obj), obj);
+       /**
+        * exposed method to retrieve a bean from a node
+        */
+       public Object load(Node node) {
+               try {
+                       if (nodeMapperProvider != null) {
+                               NodeMapper nodeMapper = nodeMapperProvider.findNodeMapper(node);
+                               if (nodeMapper != this) {
+                                       return nodeMapper.load(node);
+                               }
+                       }
+                       return nodeToBean(node);
+               } catch (RepositoryException e) {
+                       throw new ArgeoException("Cannot load object from node " + node, e);
+               }
        }
 
+       /** Update an existing node with an object */
        public void update(Node node, Object obj) {
                try {
-                       beanToNode(createBeanWrapper(obj), node);
+                       if (nodeMapperProvider != null) {
+
+                               NodeMapper nodeMapper = nodeMapperProvider.findNodeMapper(node);
+                               if (nodeMapper != this) {
+                                       nodeMapper.update(node, obj);
+                               } else
+                                       beanToNode(createBeanWrapper(obj), node);
+                       } else
+                               beanToNode(createBeanWrapper(obj), node);
                } catch (RepositoryException e) {
                        throw new ArgeoException("Cannot update node " + node + " with "
                                        + obj, e);
                }
        }
 
+       /**
+        * if no storage path is given; we use canonical path
+        * 
+        * @see this.storagePath()
+        */
+       public Node save(Session session, Object obj) {
+               return save(session, storagePath(obj), obj);
+       }
+
+       /**
+        * Create a new node to store an object. If the parentNode doesn't exist, it
+        * is created
+        * 
+        * the primaryNodeType may be initialized before
+        */
        public Node save(Session session, String path, Object obj) {
                try {
                        BeanWrapper beanWrapper = createBeanWrapper(obj);
@@ -76,17 +106,28 @@ public class BeanNodeMapper {
                        Node parentNode;
                        if (session.itemExists(path))
                                parentNode = (Node) session.getItem(parentPath);
-                       else
+                       else {
                                parentNode = JcrUtils.mkdirs(session, parentPath, null,
                                                versioning);
+                       }
                        // create node
+
                        if (primaryNodeType != null)
                                node = parentNode.addNode(JcrUtils.lastPathElement(path),
                                                primaryNodeType);
                        else
                                node = parentNode.addNode(JcrUtils.lastPathElement(path));
 
-                       beanToNode(beanWrapper, node);
+                       // Check specific cases
+                       if (nodeMapperProvider != null) {
+
+                               NodeMapper nodeMapper = nodeMapperProvider.findNodeMapper(node);
+                               if (nodeMapper != this) {
+                                       nodeMapper.update(node, obj);
+                                       return node;
+                               }
+                       }
+                       update(node, obj);
                        return node;
                } catch (ArgeoException e) {
                        throw e;
@@ -96,15 +137,30 @@ public class BeanNodeMapper {
                }
        }
 
+       /**
+        * Parse the FQN of a class to string with '/' delimiters Prefix the
+        * returned string with "/objects/"
+        */
+       public String storagePath(Object obj) {
+               String clss = obj.getClass().getName();
+               StringBuffer buf = new StringBuffer("/objects/");
+               StringTokenizer st = new StringTokenizer(clss, ".");
+               while (st.hasMoreTokens()) {
+                       buf.append(st.nextToken()).append('/');
+               }
+               buf.append(obj.toString());
+               return buf.toString();
+       }
+
        @SuppressWarnings("unchecked")
-       public Object nodeToBean(Node node) throws RepositoryException {
+       /** 
+        * Transforms a node into an object of the class defined by classProperty Property
+        */
+       protected Object nodeToBean(Node node) throws RepositoryException {
 
                String clssName = node.getProperty(classProperty).getValue()
                                .getString();
 
-               if (log.isTraceEnabled())
-                       log.debug("Map node " + node.getPath() + " to bean " + clssName);
-
                BeanWrapper beanWrapper = createBeanWrapper(loadClass(clssName));
 
                // process properties
@@ -118,7 +174,8 @@ public class BeanNodeMapper {
                                        .getName());
                        Class propClass = pd.getPropertyType();
 
-                       // list
+                       // Process case of List and its derived classes
+                       // primitive list
                        if (propClass != null && List.class.isAssignableFrom(propClass)) {
                                List<Object> lst = new ArrayList<Object>();
                                Class<?> valuesClass = classFromProperty(prop);
@@ -129,6 +186,8 @@ public class BeanNodeMapper {
                                continue props;
                        }
 
+                       // Case of other type of property accepted by jcr
+                       // Long, Double, String, Binary, Date, Boolean, Name
                        Object value = asObject(prop.getValue(), pd.getPropertyType());
                        if (value != null)
                                beanWrapper.setPropertyValue(prop.getName(), value);
@@ -145,6 +204,7 @@ public class BeanNodeMapper {
                        PropertyDescriptor pd = beanWrapper.getPropertyDescriptor(name);
                        Class propClass = pd.getPropertyType();
 
+                       // objects list
                        if (propClass != null && List.class.isAssignableFrom(propClass)) {
                                String lstClass = childNode.getProperty(classProperty)
                                                .getString();
@@ -166,6 +226,7 @@ public class BeanNodeMapper {
                                continue nodes;
                        }
 
+                       // objects map
                        if (propClass != null && Map.class.isAssignableFrom(propClass)) {
                                String mapClass = childNode.getProperty(classProperty)
                                                .getString();
@@ -217,15 +278,18 @@ public class BeanNodeMapper {
                return beanWrapper.getWrappedInstance();
        }
 
+       /**
+        * Transforms an object to the specified jcr Node in order to persist it.
+        * 
+        * @param beanWrapper
+        * @param node
+        * @throws RepositoryException
+        */
        protected void beanToNode(BeanWrapper beanWrapper, Node node)
                        throws RepositoryException {
-               if (log.isTraceEnabled())
-                       log.debug("Map bean to node " + node.getPath());
-
                properties: for (PropertyDescriptor pd : beanWrapper
                                .getPropertyDescriptors()) {
                        String name = pd.getName();
-
                        if (!beanWrapper.isReadableProperty(name))
                                continue properties;// skip
 
@@ -255,6 +319,7 @@ public class BeanNodeMapper {
                                continue properties;
                        }
 
+                       // Some bean reference other classes. We must deal with this case
                        if (value instanceof Class<?>) {
                                node.setProperty(name, ((Class<?>) value).getName());
                                continue properties;
@@ -298,6 +363,14 @@ public class BeanNodeMapper {
                }
        }
 
+       /**
+        * Process specific case of list
+        * 
+        * @param node
+        * @param name
+        * @param lst
+        * @throws RepositoryException
+        */
        protected void addList(Node node, String name, List<?> lst)
                        throws RepositoryException {
                if (node.hasNode(name)) {// update
@@ -336,6 +409,14 @@ public class BeanNodeMapper {
                }
        }
 
+       /**
+        * Process specific case of maps.
+        * 
+        * @param node
+        * @param name
+        * @param map
+        * @throws RepositoryException
+        */
        protected void addMap(Node node, String name, Map<?, ?> map)
                        throws RepositoryException {
                if (node.hasNode(name)) {// update
@@ -473,7 +554,7 @@ public class BeanNodeMapper {
        }
 
        protected Class<?> loadClass(String name) {
-               //log.debug("Class loader: " + classLoader);
+               // log.debug("Class loader: " + classLoader);
                try {
                        return classLoader.loadClass(name);
                } catch (ClassNotFoundException e) {
@@ -509,4 +590,15 @@ public class BeanNodeMapper {
                this.classLoader = classLoader;
        }
 
+       public void setNodeMapperProvider(NodeMapperProvider nodeMapperProvider) {
+               this.nodeMapperProvider = nodeMapperProvider;
+       }
+
+       public String getPrimaryNodeType() {
+               return this.primaryNodeType;
+       }
+
+       public String getClassProperty() {
+               return this.classProperty;
+       }
 }