All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.commons.beanutils.BeanMap Maven / Gradle / Ivy

Go to download

Apache Commons BeanUtils provides an easy-to-use but flexible wrapper around reflection and introspection.

There is a newer version: 20030211.134440
Show newest version
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache 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.apache.org/licenses/LICENSE-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.apache.commons.beanutils;

import java.beans.BeanInfo;
import java.beans.IntrospectionException;
import java.beans.Introspector;
import java.beans.PropertyDescriptor;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.AbstractMap;
import java.util.AbstractSet;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;

import org.apache.commons.collections.Transformer;
import org.apache.commons.collections.keyvalue.AbstractMapEntry;

/**
 * An implementation of Map for JavaBeans which uses introspection to
 * get and put properties in the bean.
 * 

* If an exception occurs during attempts to get or set a property then the * property is considered non existent in the Map * * @version $Id: BeanMap.java 1746219 2016-05-31 05:05:09Z ggregory $ */ public class BeanMap extends AbstractMap implements Cloneable { private transient Object bean; private transient HashMap readMethods = new HashMap(); private transient HashMap writeMethods = new HashMap(); private transient HashMap> types = new HashMap>(); /** * An empty array. Used to invoke accessors via reflection. */ public static final Object[] NULL_ARGUMENTS = {}; /** * Maps primitive Class types to transformers. The transformer * transform strings into the appropriate primitive wrapper. * * N.B. private & unmodifiable replacement for the (public & static) defaultTransformers instance. */ private static final Map, Transformer> typeTransformers = Collections.unmodifiableMap(createTypeTransformers()); /** * This HashMap has been made unmodifiable to prevent issues when * loaded in a shared ClassLoader enviroment. * * @see "http://issues.apache.org/jira/browse/BEANUTILS-112" * @deprecated Use {@link BeanMap#getTypeTransformer(Class)} method */ @Deprecated public static HashMap defaultTransformers = new HashMap() { @Override public void clear() { throw new UnsupportedOperationException(); } @Override public boolean containsKey(final Object key) { return typeTransformers.containsKey(key); } @Override public boolean containsValue(final Object value) { return typeTransformers.containsValue(value); } @Override public Set entrySet() { return typeTransformers.entrySet(); } @Override public Object get(final Object key) { return typeTransformers.get(key); } @Override public boolean isEmpty() { return false; } @Override public Set keySet() { return typeTransformers.keySet(); } @Override public Object put(final Object key, final Object value) { throw new UnsupportedOperationException(); } @Override public void putAll(final Map m) { throw new UnsupportedOperationException(); } @Override public Object remove(final Object key) { throw new UnsupportedOperationException(); } @Override public int size() { return typeTransformers.size(); } @Override public Collection values() { return typeTransformers.values(); } }; private static Map, Transformer> createTypeTransformers() { final Map, Transformer> defaultTransformers = new HashMap, Transformer>(); defaultTransformers.put( Boolean.TYPE, new Transformer() { public Object transform( final Object input ) { return Boolean.valueOf( input.toString() ); } } ); defaultTransformers.put( Character.TYPE, new Transformer() { public Object transform( final Object input ) { return new Character( input.toString().charAt( 0 ) ); } } ); defaultTransformers.put( Byte.TYPE, new Transformer() { public Object transform( final Object input ) { return Byte.valueOf( input.toString() ); } } ); defaultTransformers.put( Short.TYPE, new Transformer() { public Object transform( final Object input ) { return Short.valueOf( input.toString() ); } } ); defaultTransformers.put( Integer.TYPE, new Transformer() { public Object transform( final Object input ) { return Integer.valueOf( input.toString() ); } } ); defaultTransformers.put( Long.TYPE, new Transformer() { public Object transform( final Object input ) { return Long.valueOf( input.toString() ); } } ); defaultTransformers.put( Float.TYPE, new Transformer() { public Object transform( final Object input ) { return Float.valueOf( input.toString() ); } } ); defaultTransformers.put( Double.TYPE, new Transformer() { public Object transform( final Object input ) { return Double.valueOf( input.toString() ); } } ); return defaultTransformers; } // Constructors //------------------------------------------------------------------------- /** * Constructs a new empty BeanMap. */ public BeanMap() { } /** * Constructs a new BeanMap that operates on the * specified bean. If the given bean is null, then * this map will be empty. * * @param bean the bean for this map to operate on */ public BeanMap(final Object bean) { this.bean = bean; initialise(); } // Map interface //------------------------------------------------------------------------- /** * Renders a string representation of this object. * @return a String representation of this object */ @Override public String toString() { return "BeanMap<" + String.valueOf(bean) + ">"; } /** * Clone this bean map using the following process: * *

    *
  • If there is no underlying bean, return a cloned BeanMap without a * bean. * *
  • Since there is an underlying bean, try to instantiate a new bean of * the same type using Class.newInstance(). * *
  • If the instantiation fails, throw a CloneNotSupportedException * *
  • Clone the bean map and set the newly instantiated bean as the * underlying bean for the bean map. * *
  • Copy each property that is both readable and writable from the * existing object to a cloned bean map. * *
  • If anything fails along the way, throw a * CloneNotSupportedException. * *
      * * @return a cloned instance of this bean map * @throws CloneNotSupportedException if the underlying bean * cannot be cloned */ @Override public Object clone() throws CloneNotSupportedException { final BeanMap newMap = (BeanMap)super.clone(); if(bean == null) { // no bean, just an empty bean map at the moment. return a newly // cloned and empty bean map. return newMap; } Object newBean = null; final Class beanClass = bean.getClass(); // Cannot throw Exception try { newBean = beanClass.newInstance(); } catch (final Exception e) { // unable to instantiate final CloneNotSupportedException cnse = new CloneNotSupportedException ("Unable to instantiate the underlying bean \"" + beanClass.getName() + "\": " + e); BeanUtils.initCause(cnse, e); throw cnse; } try { newMap.setBean(newBean); } catch (final Exception exception) { final CloneNotSupportedException cnse = new CloneNotSupportedException ("Unable to set bean in the cloned bean map: " + exception); BeanUtils.initCause(cnse, exception); throw cnse; } try { // copy only properties that are readable and writable. If its // not readable, we can't get the value from the old map. If // its not writable, we can't write a value into the new map. final Iterator readableKeys = readMethods.keySet().iterator(); while(readableKeys.hasNext()) { final Object key = readableKeys.next(); if(getWriteMethod(key) != null) { newMap.put(key, get(key)); } } } catch (final Exception exception) { final CloneNotSupportedException cnse = new CloneNotSupportedException ("Unable to copy bean values to cloned bean map: " + exception); BeanUtils.initCause(cnse, exception); throw cnse; } return newMap; } /** * Puts all of the writable properties from the given BeanMap into this * BeanMap. Read-only and Write-only properties will be ignored. * * @param map the BeanMap whose properties to put */ public void putAllWriteable(final BeanMap map) { final Iterator readableKeys = map.readMethods.keySet().iterator(); while (readableKeys.hasNext()) { final Object key = readableKeys.next(); if (getWriteMethod(key) != null) { this.put(key, map.get(key)); } } } /** * This method reinitializes the bean map to have default values for the * bean's properties. This is accomplished by constructing a new instance * of the bean which the map uses as its underlying data source. This * behavior for clear() differs from the Map contract in that * the mappings are not actually removed from the map (the mappings for a * BeanMap are fixed). */ @Override public void clear() { if(bean == null) { return; } Class beanClass = null; try { beanClass = bean.getClass(); bean = beanClass.newInstance(); } catch (final Exception e) { final UnsupportedOperationException uoe = new UnsupportedOperationException("Could not create new instance of class: " + beanClass); BeanUtils.initCause(uoe, e); throw uoe; } } /** * Returns true if the bean defines a property with the given name. *

      * The given name must be a String; if not, this method * returns false. This method will also return false if the bean * does not define a property with that name. *

      * Write-only properties will not be matched as the test operates against * property read methods. * * @param name the name of the property to check * @return false if the given name is null or is not a String; * false if the bean does not define a property with that name; or * true if the bean does define a property with that name */ @Override public boolean containsKey(final Object name) { final Method method = getReadMethod(name); return method != null; } /** * Returns true if the bean defines a property whose current value is * the given object. * * @param value the value to check * @return false true if the bean has at least one property whose * current value is that object, false otherwise */ @Override public boolean containsValue(final Object value) { // use default implementation return super.containsValue(value); } /** * Returns the value of the bean's property with the given name. *

      * The given name must be a {@link String} and must not be * null; otherwise, this method returns null. * If the bean defines a property with the given name, the value of * that property is returned. Otherwise, null is * returned. *

      * Write-only properties will not be matched as the test operates against * property read methods. * * @param name the name of the property whose value to return * @return the value of the property with that name */ @Override public Object get(final Object name) { if ( bean != null ) { final Method method = getReadMethod( name ); if ( method != null ) { try { return method.invoke( bean, NULL_ARGUMENTS ); } catch ( final IllegalAccessException e ) { logWarn( e ); } catch ( final IllegalArgumentException e ) { logWarn( e ); } catch ( final InvocationTargetException e ) { logWarn( e ); } catch ( final NullPointerException e ) { logWarn( e ); } } } return null; } /** * Sets the bean property with the given name to the given value. * * @param name the name of the property to set * @param value the value to set that property to * @return the previous value of that property * @throws IllegalArgumentException if the given name is null; * if the given name is not a {@link String}; if the bean doesn't * define a property with that name; or if the bean property with * that name is read-only * @throws ClassCastException if an error occurs creating the method args */ @Override public Object put(final Object name, final Object value) throws IllegalArgumentException, ClassCastException { if ( bean != null ) { final Object oldValue = get( name ); final Method method = getWriteMethod( name ); if ( method == null ) { throw new IllegalArgumentException( "The bean of type: "+ bean.getClass().getName() + " has no property called: " + name ); } try { final Object[] arguments = createWriteMethodArguments( method, value ); method.invoke( bean, arguments ); final Object newValue = get( name ); firePropertyChange( name, oldValue, newValue ); } catch ( final InvocationTargetException e ) { final IllegalArgumentException iae = new IllegalArgumentException(e.getMessage()); if (BeanUtils.initCause(iae, e) == false) { logInfo(e); } throw iae; } catch ( final IllegalAccessException e ) { final IllegalArgumentException iae = new IllegalArgumentException(e.getMessage()); if (BeanUtils.initCause(iae, e) == false) { logInfo(e); } throw iae; } return oldValue; } return null; } /** * Returns the number of properties defined by the bean. * * @return the number of properties defined by the bean */ @Override public int size() { return readMethods.size(); } /** * Get the keys for this BeanMap. *

      * Write-only properties are not included in the returned set of * property names, although it is possible to set their value and to get * their type. * * @return BeanMap keys. The Set returned by this method is not * modifiable. */ @SuppressWarnings({ "unchecked", "rawtypes" }) // The set actually contains strings; however, because it cannot be // modified there is no danger in selling it as Set @Override public Set keySet() { return Collections.unmodifiableSet((Set) readMethods.keySet()); } /** * Gets a Set of MapEntry objects that are the mappings for this BeanMap. *

      * Each MapEntry can be set but not removed. * * @return the unmodifiable set of mappings */ @Override public Set> entrySet() { return Collections.unmodifiableSet(new AbstractSet>() { @Override public Iterator> iterator() { return entryIterator(); } @Override public int size() { return BeanMap.this.readMethods.size(); } }); } /** * Returns the values for the BeanMap. * * @return values for the BeanMap. The returned collection is not * modifiable. */ @Override public Collection values() { final ArrayList answer = new ArrayList( readMethods.size() ); for ( final Iterator iter = valueIterator(); iter.hasNext(); ) { answer.add( iter.next() ); } return Collections.unmodifiableList(answer); } // Helper methods //------------------------------------------------------------------------- /** * Returns the type of the property with the given name. * * @param name the name of the property * @return the type of the property, or null if no such * property exists */ public Class getType(final String name) { return types.get( name ); } /** * Convenience method for getting an iterator over the keys. *

      * Write-only properties will not be returned in the iterator. * * @return an iterator over the keys */ public Iterator keyIterator() { return readMethods.keySet().iterator(); } /** * Convenience method for getting an iterator over the values. * * @return an iterator over the values */ public Iterator valueIterator() { final Iterator iter = keyIterator(); return new Iterator() { public boolean hasNext() { return iter.hasNext(); } public Object next() { final Object key = iter.next(); return get(key); } public void remove() { throw new UnsupportedOperationException( "remove() not supported for BeanMap" ); } }; } /** * Convenience method for getting an iterator over the entries. * * @return an iterator over the entries */ public Iterator> entryIterator() { final Iterator iter = keyIterator(); return new Iterator>() { public boolean hasNext() { return iter.hasNext(); } public Map.Entry next() { final Object key = iter.next(); final Object value = get(key); @SuppressWarnings("unchecked") final // This should not cause any problems; the key is actually a // string, but it does no harm to expose it as Object Map.Entry tmpEntry = new Entry( BeanMap.this, key, value ); return tmpEntry; } public void remove() { throw new UnsupportedOperationException( "remove() not supported for BeanMap" ); } }; } // Properties //------------------------------------------------------------------------- /** * Returns the bean currently being operated on. The return value may * be null if this map is empty. * * @return the bean being operated on by this map */ public Object getBean() { return bean; } /** * Sets the bean to be operated on by this map. The given value may * be null, in which case this map will be empty. * * @param newBean the new bean to operate on */ public void setBean( final Object newBean ) { bean = newBean; reinitialise(); } /** * Returns the accessor for the property with the given name. * * @param name the name of the property * @return the accessor method for the property, or null */ public Method getReadMethod(final String name) { return readMethods.get(name); } /** * Returns the mutator for the property with the given name. * * @param name the name of the property * @return the mutator method for the property, or null */ public Method getWriteMethod(final String name) { return writeMethods.get(name); } // Implementation methods //------------------------------------------------------------------------- /** * Returns the accessor for the property with the given name. * * @param name the name of the property * @return null if the name is null; null if the name is not a * {@link String}; null if no such property exists; or the accessor * method for that property */ protected Method getReadMethod( final Object name ) { return readMethods.get( name ); } /** * Returns the mutator for the property with the given name. * * @param name the name of the * @return null if the name is null; null if the name is not a * {@link String}; null if no such property exists; null if the * property is read-only; or the mutator method for that property */ protected Method getWriteMethod( final Object name ) { return writeMethods.get( name ); } /** * Reinitializes this bean. Called during {@link #setBean(Object)}. * Does introspection to find properties. */ protected void reinitialise() { readMethods.clear(); writeMethods.clear(); types.clear(); initialise(); } private void initialise() { if(getBean() == null) { return; } final Class beanClass = getBean().getClass(); try { //BeanInfo beanInfo = Introspector.getBeanInfo( bean, null ); final BeanInfo beanInfo = Introspector.getBeanInfo( beanClass ); final PropertyDescriptor[] propertyDescriptors = beanInfo.getPropertyDescriptors(); if ( propertyDescriptors != null ) { for (final PropertyDescriptor propertyDescriptor : propertyDescriptors) { if ( propertyDescriptor != null ) { final String name = propertyDescriptor.getName(); final Method readMethod = propertyDescriptor.getReadMethod(); final Method writeMethod = propertyDescriptor.getWriteMethod(); final Class aType = propertyDescriptor.getPropertyType(); if ( readMethod != null ) { readMethods.put( name, readMethod ); } if ( writeMethod != null ) { writeMethods.put( name, writeMethod ); } types.put( name, aType ); } } } } catch ( final IntrospectionException e ) { logWarn( e ); } } /** * Called during a successful {@link #put(Object,Object)} operation. * Default implementation does nothing. Override to be notified of * property changes in the bean caused by this map. * * @param key the name of the property that changed * @param oldValue the old value for that property * @param newValue the new value for that property */ protected void firePropertyChange( final Object key, final Object oldValue, final Object newValue ) { } // Implementation classes //------------------------------------------------------------------------- /** * Map entry used by {@link BeanMap}. */ protected static class Entry extends AbstractMapEntry { private final BeanMap owner; /** * Constructs a new Entry. * * @param owner the BeanMap this entry belongs to * @param key the key for this entry * @param value the value for this entry */ protected Entry( final BeanMap owner, final Object key, final Object value ) { super( key, value ); this.owner = owner; } /** * Sets the value. * * @param value the new value for the entry * @return the old value for the entry */ @Override public Object setValue(final Object value) { final Object key = getKey(); final Object oldValue = owner.get( key ); owner.put( key, value ); final Object newValue = owner.get( key ); super.setValue( newValue ); return oldValue; } } /** * Creates an array of parameters to pass to the given mutator method. * If the given object is not the right type to pass to the method * directly, it will be converted using {@link #convertType(Class,Object)}. * * @param method the mutator method * @param value the value to pass to the mutator method * @return an array containing one object that is either the given value * or a transformed value * @throws IllegalAccessException if {@link #convertType(Class,Object)} * raises it * @throws IllegalArgumentException if any other exception is raised * by {@link #convertType(Class,Object)} * @throws ClassCastException if an error occurs creating the method args */ protected Object[] createWriteMethodArguments( final Method method, Object value ) throws IllegalAccessException, ClassCastException { try { if ( value != null ) { final Class[] types = method.getParameterTypes(); if ( types != null && types.length > 0 ) { final Class paramType = types[0]; if ( ! paramType.isAssignableFrom( value.getClass() ) ) { value = convertType( paramType, value ); } } } final Object[] answer = { value }; return answer; } catch ( final InvocationTargetException e ) { final IllegalArgumentException iae = new IllegalArgumentException(e.getMessage()); if (BeanUtils.initCause(iae, e) == false) { logInfo(e); } throw iae; } catch ( final InstantiationException e ) { final IllegalArgumentException iae = new IllegalArgumentException(e.getMessage()); if (BeanUtils.initCause(iae, e) == false) { logInfo(e); } BeanUtils.initCause(iae, e); throw iae; } } /** * Converts the given value to the given type. First, reflection is * is used to find a public constructor declared by the given class * that takes one argument, which must be the precise type of the * given value. If such a constructor is found, a new object is * created by passing the given value to that constructor, and the * newly constructed object is returned.

      * * If no such constructor exists, and the given type is a primitive * type, then the given value is converted to a string using its * {@link Object#toString() toString()} method, and that string is * parsed into the correct primitive type using, for instance, * {@link Integer#valueOf(String)} to convert the string into an * int.

      * * If no special constructor exists and the given type is not a * primitive type, this method returns the original value. * * @param newType the type to convert the value to * @param value the value to convert * @return the converted value * @throws NumberFormatException if newType is a primitive type, and * the string representation of the given value cannot be converted * to that type * @throws InstantiationException if the constructor found with * reflection raises it * @throws InvocationTargetException if the constructor found with * reflection raises it * @throws IllegalAccessException never * @throws IllegalArgumentException never */ protected Object convertType( final Class newType, final Object value ) throws InstantiationException, IllegalAccessException, IllegalArgumentException, InvocationTargetException { // try call constructor final Class[] types = { value.getClass() }; try { final Constructor constructor = newType.getConstructor( types ); final Object[] arguments = { value }; return constructor.newInstance( arguments ); } catch ( final NoSuchMethodException e ) { // try using the transformers final Transformer transformer = getTypeTransformer( newType ); if ( transformer != null ) { return transformer.transform( value ); } return value; } } /** * Returns a transformer for the given primitive type. * * @param aType the primitive type whose transformer to return * @return a transformer that will convert strings into that type, * or null if the given type is not a primitive type */ protected Transformer getTypeTransformer( final Class aType ) { return typeTransformers.get( aType ); } /** * Logs the given exception to System.out. Used to display * warnings while accessing/mutating the bean. * * @param ex the exception to log */ protected void logInfo(final Exception ex) { // Deliberately do not use LOG4J or Commons Logging to avoid dependencies System.out.println( "INFO: Exception: " + ex ); } /** * Logs the given exception to System.err. Used to display * errors while accessing/mutating the bean. * * @param ex the exception to log */ protected void logWarn(final Exception ex) { // Deliberately do not use LOG4J or Commons Logging to avoid dependencies System.out.println( "WARN: Exception: " + ex ); ex.printStackTrace(); } }