org.kuali.kfs.sys.ObjectUtil.java Source code

Java tutorial

Introduction

Here is the source code for org.kuali.kfs.sys.ObjectUtil.java

Source

/*
 * The Kuali Financial System, a comprehensive financial management system for higher education.
 * 
 * Copyright 2005-2014 The Kuali Foundation
 * 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 * 
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package org.kuali.kfs.sys;

import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.math.BigDecimal;
import java.sql.Date;
import java.sql.Timestamp;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Properties;

import org.apache.commons.beanutils.DynaClass;
import org.apache.commons.beanutils.DynaProperty;
import org.apache.commons.beanutils.PropertyUtils;
import org.apache.commons.beanutils.WrapDynaClass;
import org.apache.commons.lang.ObjectUtils;
import org.apache.commons.lang.StringUtils;
import org.kuali.rice.core.api.util.type.KualiDecimal;
import org.kuali.rice.core.api.util.type.KualiInteger;
import org.kuali.rice.krad.bo.PersistableBusinessObjectBase;

/**
 * This class provides a set of facilities that can be used to manipulate objects, for example, object population
 */
public class ObjectUtil {
    private static org.apache.log4j.Logger LOG = org.apache.log4j.Logger.getLogger(ObjectUtil.class);

    /**
     * create an object of the specified type
     * 
     * @param clazz the specified type of the object
     * @return an object of the specified type
     */
    public static <T> T createObject(Class<T> clazz) {
        T object = null;

        try {
            object = clazz.newInstance();
        } catch (InstantiationException ie) {
            LOG.error(ie);
            throw new RuntimeException(ie);
        } catch (IllegalAccessException iae) {
            LOG.error(iae);
            throw new RuntimeException(iae);
        }

        return object;
    }

    /**
     * Populate the given fields of the target object with the corresponding field values of source object
     * 
     * @param targetObject the target object
     * @param sourceObject the source object
     * @param keyFields the given fields of the target object that need to be popluated
     */
    public static void buildObject(Object targetObject, Object sourceObject, List<String> keyFields) {
        if (sourceObject.getClass().isArray()) {
            buildObject(targetObject, sourceObject, keyFields);
            return;
        }

        for (String propertyName : keyFields) {
            if (PropertyUtils.isReadable(sourceObject, propertyName)
                    && PropertyUtils.isWriteable(targetObject, propertyName)) {
                try {
                    Object propertyValue = PropertyUtils.getProperty(sourceObject, propertyName);
                    PropertyUtils.setProperty(targetObject, propertyName, propertyValue);
                } catch (Exception e) {
                    LOG.debug(e);
                }
            }
        }
    }

    /**
     * Populate the given fields of the target object with the values of an array
     * 
     * @param targetObject the target object
     * @param sourceObject the given array
     * @param keyFields the given fields of the target object that need to be popluated
     */
    public static void buildObject(Object targetObject, Object[] sourceObject, List<String> keyFields) {
        int indexOfArray = 0;
        for (String propertyName : keyFields) {
            if (PropertyUtils.isWriteable(targetObject, propertyName) && indexOfArray < sourceObject.length) {
                try {
                    Object value = sourceObject[indexOfArray];
                    String propertyValue = value != null ? value.toString() : StringUtils.EMPTY;

                    String type = getSimpleTypeName(targetObject, propertyName);
                    Object realPropertyValue = valueOf(type, propertyValue);

                    if (realPropertyValue != null && !StringUtils.isEmpty(realPropertyValue.toString())) {
                        PropertyUtils.setProperty(targetObject, propertyName, realPropertyValue);
                    } else {
                        PropertyUtils.setProperty(targetObject, propertyName, null);
                    }
                } catch (Exception e) {
                    LOG.debug(e);
                }
            }
            indexOfArray++;
        }
    }

    public static String getSimpleTypeName(Object targetObject, String propertyName) {
        String simpleTypeName = StringUtils.EMPTY;
        try {
            simpleTypeName = PropertyUtils.getPropertyType(targetObject, propertyName).getSimpleName();
        } catch (Exception e) {
            LOG.debug(e);
        }

        return simpleTypeName;
    }

    /**
     * Get an object of the given type holding the property value of the specified String.
     * 
     * @param type the given type of the returning object
     * @param propertyValue the property value of the specified string
     * @return an object of the given type holding the property value of the specified String
     */
    public static Object valueOf(String type, String propertyValue) {
        Object realPropertyValue = null;

        if (type.equals("Integer")) {
            realPropertyValue = isInteger(propertyValue) ? Integer.valueOf(propertyValue) : null;
        } else if (type.equals("KualiInteger")) {
            realPropertyValue = isInteger(propertyValue) ? new KualiInteger(propertyValue) : null;
        } else if (type.equalsIgnoreCase("Boolean")) {
            realPropertyValue = Boolean.valueOf(propertyValue);
        } else if (type.equals("KualiDecimal")) {
            realPropertyValue = isDecimal(propertyValue) ? new KualiDecimal(propertyValue) : null;
        } else if (type.equals("Date")) {
            realPropertyValue = formatDate(propertyValue);
        } else if (type.equals("BigDecimal")) {
            realPropertyValue = isDecimal(propertyValue) ? new BigDecimal(propertyValue) : null;
        } else if (type.equals("Timestamp")) {
            realPropertyValue = formatTimeStamp(propertyValue);
        } else {
            realPropertyValue = propertyValue;
        }
        return realPropertyValue;
    }

    /**
     * determine if the given string can be converted into an Integer
     * 
     * @param value the value of the specified string
     * @return true if the string can be converted into an Integer; otherwise, return false
     */
    public static boolean isInteger(String value) {
        String pattern = "^(\\+|-)?\\d+$";
        return value != null && value.matches(pattern);
    }

    /**
     * determine if the given string can be converted into a decimal
     * 
     * @param value the value of the specified string
     * @return true if the string can be converted into a decimal; otherwise, return false
     */
    public static boolean isDecimal(String value) {
        String pattern = "^(((\\+|-)?\\d+(\\.\\d*)?)|((\\+|-)?(\\d*\\.)?\\d+))$";
        return value != null && value.matches(pattern);
    }

    /**
     * convert the given string into a date
     * 
     * @param value the given string
     * @return a date converted from the given string
     */
    public static Date formatDate(String value) {
        Date formattedDate = null;

        try {
            formattedDate = Date.valueOf(value);
        } catch (Exception e) {
            return formattedDate;
        }
        return formattedDate;
    }

    /**
     * convert the given string into a timestamp object if the string is in the valid format of timestamp
     * 
     * @param value the given string
     * @return a timestamp converted from the given string
     */
    public static Timestamp formatTimeStamp(String value) {
        Timestamp formattedTimestamp = null;

        String pattern = "^(\\d{1,4}-\\d{1,2}-\\d{1,2} \\d{1,2}:\\d{1,2}:\\d{1,2}(\\.\\d{1,9})?)$";
        boolean isTimestamp = value != null && value.matches(pattern);

        try {
            if (isTimestamp) {
                formattedTimestamp = Timestamp.valueOf(value);
            } else {
                formattedTimestamp = new Timestamp(formatDate(value).getTime());
            }
        } catch (Exception e) {
            return formattedTimestamp;
        }
        return formattedTimestamp;
    }

    /**
     * Populate the target object with the source object
     * 
     * @param targetObject the target object
     * @param sourceObject the source object
     */
    public static void buildObject(Object targetObject, Object sourceObject) {
        DynaClass dynaClass = WrapDynaClass.createDynaClass(targetObject.getClass());
        DynaProperty[] properties = dynaClass.getDynaProperties();

        for (DynaProperty property : properties) {
            ObjectUtil.setProperty(targetObject, sourceObject, property, false);
        }
    }

    /**
     * Populate the target object with the source object
     * 
     * @param targetObject the target object
     * @param sourceObject the source object
     */
    public static void buildObjectWithoutReferenceFields(Object targetObject, Object sourceObject) {
        DynaClass dynaClass = WrapDynaClass.createDynaClass(targetObject.getClass());
        DynaProperty[] properties = dynaClass.getDynaProperties();

        for (DynaProperty property : properties) {
            ObjectUtil.setProperty(targetObject, sourceObject, property, true);
        }
    }

    /**
     * Populate the property of the target object with the counterpart of the source object
     * 
     * @param targetObject the target object
     * @param sourceObject the source object
     * @param property the specified propety of the target object
     * @param skipReferenceFields determine whether the referencing fields need to be populated
     */
    public static void setProperty(Object targetObject, Object sourceObject, DynaProperty property,
            boolean skipReferenceFields) {
        String propertyName = property.getName();

        try {
            if (skipReferenceFields) {
                @SuppressWarnings("rawtypes")
                Class propertyType = property.getType();
                if (propertyType == null || PersistableBusinessObjectBase.class.isAssignableFrom(propertyType)
                        || List.class.isAssignableFrom(propertyType)) {
                    return;
                }
            }

            if (PropertyUtils.isReadable(sourceObject, propertyName)
                    && PropertyUtils.isWriteable(targetObject, propertyName)) {
                Object propertyValue = PropertyUtils.getProperty(sourceObject, propertyName);
                PropertyUtils.setProperty(targetObject, propertyName, propertyValue);
            }
        } catch (IllegalAccessException e) {
            if (LOG.isDebugEnabled()) {
                LOG.debug(e.getMessage() + ":" + propertyName);
            }
        } catch (InvocationTargetException e) {
            if (LOG.isDebugEnabled()) {
                LOG.debug(e.getMessage() + ":" + propertyName);
            }
        } catch (NoSuchMethodException e) {
            if (LOG.isDebugEnabled()) {
                LOG.debug(e.getMessage() + ":" + propertyName);
            }
        } catch (IllegalArgumentException e) {
            if (LOG.isDebugEnabled()) {
                LOG.debug(e.getMessage() + ":" + propertyName);
            }
        } catch (Exception e) {
            if (LOG.isDebugEnabled()) {
                LOG.debug(e.getMessage() + ":" + propertyName);
            }
        }
    }

    /**
     * Determine if they have the same values in the specified fields
     * 
     * @param targetObject the target object
     * @param sourceObject the source object
     * @param keyFields the specified fields
     * @return true if the two objects have the same values in the specified fields; otherwise, false
     */
    public static boolean equals(Object targetObject, Object sourceObject, List<String> keyFields) {
        if (targetObject == sourceObject) {
            return true;
        }

        if (targetObject == null || sourceObject == null) {
            return false;
        }

        for (String propertyName : keyFields) {
            try {
                Object propertyValueOfSource = PropertyUtils.getProperty(sourceObject, propertyName);
                Object propertyValueOfTarget = PropertyUtils.getProperty(targetObject, propertyName);

                if (!ObjectUtils.equals(propertyValueOfSource, propertyValueOfTarget)) {
                    return false;
                }
            } catch (Exception e) {
                LOG.info(e);
                return false;
            }
        }
        return true;
    }

    /**
     * compute the hash code for the given object from the given fields
     * 
     * @param object the given object
     * @param keyFields the specified fields
     * @return the hash code for the given object from the given fields
     */
    public static int generateHashCode(Object object, List<String> keyFields) {
        if (object == null) {
            return 0;
        }

        final int prime = 31;
        int result = 1;
        for (String propertyName : keyFields) {
            try {
                Object propertyValue = PropertyUtils.getProperty(object, propertyName);
                result = prime * result + ((propertyValue == null) ? 0 : propertyValue.hashCode());
            } catch (Exception e) {
                LOG.info(e);
            }
        }
        return result;
    }

    /**
     * build a map of business object with its specified property names and corresponding values
     * 
     * @param businessObject the given business object
     * @param the specified fields that need to be included in the return map
     * @return the map of business object with its property names and values
     */
    public static Map<String, Object> buildPropertyMap(Object object, List<String> keyFields) {
        DynaClass dynaClass = WrapDynaClass.createDynaClass(object.getClass());
        DynaProperty[] properties = dynaClass.getDynaProperties();
        Map<String, Object> propertyMap = new LinkedHashMap<String, Object>();

        for (DynaProperty property : properties) {
            String propertyName = property.getName();

            if (PropertyUtils.isReadable(object, propertyName) && keyFields.contains(propertyName)) {
                try {
                    Object propertyValue = PropertyUtils.getProperty(object, propertyName);

                    if (propertyValue != null && !StringUtils.isEmpty(propertyValue.toString())) {
                        propertyMap.put(propertyName, propertyValue);
                    }
                } catch (Exception e) {
                    LOG.info(e);
                }
            }
        }
        return propertyMap;
    }

    /**
     * concat the specified properties of the given object as a string
     * 
     * @param object the given object
     * @param the specified fields that need to be included in the return string
     * @return the specified properties of the given object as a string
     */
    public static String concatPropertyAsString(Object object, List<String> keyFields) {
        StringBuilder propertyAsString = new StringBuilder();
        for (String field : keyFields) {
            if (PropertyUtils.isReadable(object, field)) {
                try {
                    propertyAsString.append(PropertyUtils.getProperty(object, field));
                } catch (Exception e) {
                    LOG.error(e);
                }
            }
        }

        return propertyAsString.toString();
    }

    /**
     * Tokenize the input line with the given deliminator and populate the given object with values of the tokens
     * 
     * @param targetObject the target object
     * @param line the input line
     * @param delim the deminator that separates the fields in the given line
     * @param keyFields the specified fields
     */
    public static void convertLineToBusinessObject(Object targetObject, String line, String delim,
            List<String> keyFields) {
        String[] tokens = StringUtils.split(line, delim);
        ObjectUtil.buildObject(targetObject, tokens, keyFields);
    }

    /**
     * Tokenize the input line with the given deliminator and populate the given object with values of the tokens
     * 
     * @param targetObject the target object
     * @param line the input line
     * @param delim the deminator that separates the fields in the given line
     * @param keyFields the specified fields
     */
    public static void convertLineToBusinessObject(Object targetObject, String line, String delim,
            String fieldNames) {
        List<String> tokens = split(line, delim);
        List<String> keyFields = Arrays.asList(StringUtils.split(fieldNames, delim));
        ObjectUtil.buildObject(targetObject, tokens.toArray(), keyFields);
    }

    /**
     * Tokenize the input line with the given deliminator and store the tokens in a list
     * 
     * @param line the input line
     * @param delim the deminator that separates the fields in the given line
     * @return a list of tokens
     */
    public static List<String> split(String line, String delim) {
        List<String> tokens = new ArrayList<String>();

        int currentPosition = 0;
        for (int step = 0; step < line.length(); step++) {
            int previousPosition = currentPosition;
            currentPosition = StringUtils.indexOf(line, delim, currentPosition);
            currentPosition = currentPosition == -1 ? line.length() - 1 : currentPosition;

            String sub = line.substring(previousPosition, currentPosition);
            tokens.add(sub); // don't trim the string

            currentPosition += delim.length();
            if (currentPosition >= line.length()) {
                break;
            }
        }
        return tokens;
    }

    /**
     * Tokenize the input line with the given deliminator and populate the given object with values of the tokens
     * 
     * @param targetObject the target object
     * @param line the input line
     * @param delim the deminator that separates the fields in the given line
     * @param keyFields the specified fields
     */
    public static void convertLineToBusinessObject(Object targetObject, String line, int[] fieldLength,
            List<String> keyFields) {
        String[] tokens = new String[fieldLength.length];

        int currentPosition = 0;
        for (int i = 0; i < fieldLength.length; i++) {
            currentPosition = i <= 0 ? 0 : fieldLength[i - 1] + currentPosition;
            tokens[i] = StringUtils.mid(line, currentPosition, fieldLength[i]).trim();
        }
        ObjectUtil.buildObject(targetObject, tokens, keyFields);
    }

    /**
     * Populate a business object with the given properities and information
     * 
     * @param businessOjbject the business object to be populated
     * @param properties the given properties
     * @param propertyKey the property keys in the properties
     * @param fieldNames the names of the fields to be populated
     * @param deliminator the deliminator that separates the values to be used in a string
     */
    public static void populateBusinessObject(Object businessOjbject, Properties properties, String propertyKey,
            String fieldNames, String deliminator) {
        String data = properties.getProperty(propertyKey);
        ObjectUtil.convertLineToBusinessObject(businessOjbject, data, deliminator, fieldNames);
    }

    /**
     * Populate a business object with the given properities and information
     * 
     * @param businessOjbject the business object to be populated
     * @param properties the given properties
     * @param propertyKey the property keys in the properties
     * @param fieldNames the names of the fields to be populated
     * @param deliminator the deliminator that separates the values to be used in a string
     */
    public static void populateBusinessObject(Object businessOjbject, Properties properties, String propertyKey,
            int[] fieldLength, List<String> keyFields) {
        String data = properties.getProperty(propertyKey);
        ObjectUtil.convertLineToBusinessObject(businessOjbject, data, fieldLength, keyFields);
    }

    /**
     * determine if the source object has a field with null as its value
     * 
     * @param sourceObject the source object
     */
    public static boolean hasNullValueField(Object sourceObject) {
        DynaClass dynaClass = WrapDynaClass.createDynaClass(sourceObject.getClass());
        DynaProperty[] properties = dynaClass.getDynaProperties();

        for (DynaProperty property : properties) {
            String propertyName = property.getName();

            if (PropertyUtils.isReadable(sourceObject, propertyName)) {
                try {
                    Object propertyValue = PropertyUtils.getProperty(sourceObject, propertyName);
                    if (propertyValue == null) {
                        return true;
                    }
                } catch (Exception e) {
                    LOG.info(e);
                    return false;
                }
            }
        }
        return false;
    }

    /**
     * get the types of the nested attributes starting at the given class
     * 
     * @param clazz the given class
     * @param nestedAttribute the nested attributes of the given class
     * @return a map that contains the types of the nested attributes and the attribute names
     */
    public static Map<Class<?>, String> getNestedAttributeTypes(Class<?> clazz, String nestedAttribute) {
        List<String> attributes = Arrays.asList(StringUtils.split(nestedAttribute, PropertyUtils.NESTED_DELIM));
        Map<Class<?>, String> nestedAttributes = new HashMap<Class<?>, String>();

        Class<?> currentClass = clazz;
        for (String propertyName : attributes) {
            String methodName = "get" + StringUtils.capitalize(propertyName);
            try {
                Method method = currentClass.getMethod(methodName);
                currentClass = method.getReturnType();
                nestedAttributes.put(currentClass, propertyName);
            } catch (Exception e) {
                LOG.info(e);
                break;
            }
        }
        return nestedAttributes;
    }
}