org.sakaiproject.metaobj.utils.mvc.impl.BeanWrapperBase.java Source code

Java tutorial

Introduction

Here is the source code for org.sakaiproject.metaobj.utils.mvc.impl.BeanWrapperBase.java

Source

/**********************************************************************************
 * $URL: https://source.sakaiproject.org/svn/metaobj/trunk/metaobj-util/tool-lib/src/java/org/sakaiproject/metaobj/utils/mvc/impl/BeanWrapperBase.java $
 * $Id: BeanWrapperBase.java 105079 2012-02-24 23:08:11Z ottenhoff@longsight.com $
 ***********************************************************************************
 *
 * Copyright (c) 2004, 2005, 2006, 2008 The Sakai Foundation
 *
 * Licensed under the Educational Community License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *       http://www.opensource.org/licenses/ECL-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 **********************************************************************************/

package org.sakaiproject.metaobj.utils.mvc.impl;

import java.beans.PropertyEditor;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.beans.BeanWrapper;
import org.springframework.beans.BeanWrapperImpl;
import org.springframework.beans.BeansException;

/**
 * Created by IntelliJ IDEA.
 * User: John Ellis
 * Date: Apr 23, 2004
 * Time: 1:50:42 PM
 * To change this template use File | Settings | File Templates.
 */
public abstract class BeanWrapperBase extends BeanWrapperImpl {
    protected final Log logger = LogFactory.getLog(getClass());
    protected List customEditors = new ArrayList();

    /**
     * The nested path of the object
     */
    private String nestedPath = "";

    /* Map with cached nested BeanWrappers */
    private Map nestedBeanWrappers;

    public BeanWrapperBase() {
    }

    /**
     * Create new BeanWrapperImpl for the given object.
     *
     * @param object object wrapped by this BeanWrapper.
     * @throws org.springframework.beans.BeansException
     *          if the object cannot be wrapped by a BeanWrapper
     */
    public BeanWrapperBase(Object object) throws BeansException {
        super.setWrappedInstance(object);
    }

    /**
     * Create new BeanWrapperImpl for the given object,
     * registering a nested path that the object is in.
     *
     * @param object     object wrapped by this BeanWrapper.
     * @param nestedPath the nested path of the object
     * @param rootObject the root object at the top of the path
     * @throws org.springframework.beans.BeansException
     *          if the object cannot be wrapped by a BeanWrapper
     */
    public BeanWrapperBase(Object object, String nestedPath, Object rootObject) throws BeansException {
        super(object, nestedPath, rootObject);
        this.nestedPath = nestedPath;
    }

    public Object getPropertyValue(String propertyName) throws BeansException {
        if (isNestedProperty(propertyName)) {
            BeanWrapper nestedBw = getBeanWrapperForPropertyPath(propertyName);
            return nestedBw.getPropertyValue(getFinalPath(propertyName));
        } else {
            return super.getPropertyValue(propertyName);
        }
    }

    /**
     * Recursively navigate to return a BeanWrapper for the nested property path.
     *
     * @param propertyPath property property path, which may be nested
     * @return a BeanWrapper for the target bean
     */
    protected BeanWrapperImpl getBeanWrapperForPropertyPath(String propertyPath) {
        int pos = propertyPath.indexOf(NESTED_PROPERTY_SEPARATOR);
        // Handle nested properties recursively
        if (pos > -1) {
            String nestedProperty = propertyPath.substring(0, pos);
            String nestedPath = propertyPath.substring(pos + 1);
            logger.debug("Navigating to nested property '" + nestedProperty + "' of property path '" + propertyPath
                    + "'");
            BeanWrapperImpl nestedBw = getNestedBeanWrapper(nestedProperty);

            if (nestedBw instanceof BeanWrapperBase) {
                return ((BeanWrapperBase) nestedBw).getBeanWrapperForPropertyPath(nestedPath);
            } else {
                return nestedBw;
            }
        } else {
            return this;
        }
    }

    /**
     * Retrieve a BeanWrapper for the given nested property.
     * Create a new one if not found in the cache.
     * <p>Note: Caching nested BeanWrappers is necessary now,
     * to keep registered custom editors for nested properties.
     *
     * @param nestedProperty property to create the BeanWrapper for
     * @return the BeanWrapper instance, either cached or newly created
     */
    protected BeanWrapperImpl getNestedBeanWrapper(String nestedProperty) {
        if (this.nestedBeanWrappers == null) {
            this.nestedBeanWrappers = new HashMap();
        }

        BeanWrapperImpl nextWrapper = (BeanWrapperImpl) nestedBeanWrappers.get(nestedProperty);

        if (nextWrapper == null) {
            nextWrapper = createNestedWrapper(nestedPath, nestedProperty);
            ;
            nestedBeanWrappers.put(nestedProperty, nextWrapper);
            return nextWrapper;
        } else if (nextWrapper instanceof BeanWrapperBase) {
            return ((BeanWrapperBase) nextWrapper).getBeanWrapperForPropertyPath(nestedProperty);
        } else {
            return nextWrapper;
        }
    }

    protected BeanWrapperImpl createNestedWrapper(String parentPath, String nestedProperty) {
        BeanWrapperImpl nextWrapper = null;

        nextWrapper = constructWrapper(this.getPropertyValue(nestedProperty),
                parentPath + NESTED_PROPERTY_SEPARATOR + nestedProperty);

        nestedBeanWrappers.put(nestedProperty, nextWrapper);

        for (Iterator i = customEditors.iterator(); i.hasNext();) {
            CustomEditorHolder holder = (CustomEditorHolder) i.next();
            nextWrapper.registerCustomEditor(holder.requiredType, holder.propertyPath, holder.propertyEditor);
        }

        return nextWrapper;
    }

    abstract protected BeanWrapperBase constructWrapper(Object propertyValue, String nestedProperty);

    public void registerCustomEditor(Class requiredType, String propertyPath, PropertyEditor propertyEditor) {
        CustomEditorHolder holder = new CustomEditorHolder();
        holder.requiredType = requiredType;
        holder.propertyPath = propertyPath;
        holder.propertyEditor = propertyEditor;

        customEditors.add(holder);

        super.registerCustomEditor(requiredType, propertyPath, propertyEditor);
    }

    public void setPropertyValue(String propertyName, Object value) throws BeansException {

        if (isNestedProperty(propertyName)) {
            BeanWrapper nestedBw = getBeanWrapperForPropertyPath(propertyName);
            nestedBw.setPropertyValue(getFinalPath(propertyName), value);
            return;
        } else {
            super.setPropertyValue(propertyName, value);
        }
    }

    /**
     * Is the property nested? That is, does it contain the nested
     * property separator (usually ".").
     *
     * @param path property path
     * @return boolean is the property nested
     */
    protected boolean isNestedProperty(String path) {
        return path.indexOf(NESTED_PROPERTY_SEPARATOR) != -1;
    }

    /**
     * Get the last component of the path. Also works if not nested.
     *
     * @param nestedPath property path we know is nested
     * @return last component of the path (the property on the target bean)
     */
    protected String getFinalPath(String nestedPath) {
        String finalPath = nestedPath.substring(nestedPath.lastIndexOf(NESTED_PROPERTY_SEPARATOR) + 1);
        if (logger.isDebugEnabled() && !nestedPath.equals(finalPath)) {
            logger.debug("Final path in nested property value '" + nestedPath + "' is '" + finalPath + "'");
        }
        return finalPath;
    }

    public PropertyEditor findCustomEditor(Class requiredType, String propertyPath) {
        if (propertyPath != null && isNestedProperty(propertyPath)) {
            BeanWrapperImpl bw = getBeanWrapperForPropertyPath(propertyPath);
            return bw.findCustomEditor(requiredType, getFinalPath(propertyPath));
        } else {
            return super.findCustomEditor(requiredType, propertyPath);
        }
    }

    private class CustomEditorHolder {
        public Class requiredType;
        public String propertyPath;
        public PropertyEditor propertyEditor;
    }

}