IllegalArgumentException will be
* thrown.
*
* @param bean Bean whose property is to be extracted
* @param name propertyname[index] of the property value
* to be extracted
*
* @exception IllegalAccessException if the caller does not have
* access to the property accessor method
* @exception InvocationTargetException if the property accessor method
* throws an exception
* @exception NoSuchMethodException if an accessor method for this
* propety cannot be found
*/
public static Object getIndexedProperty(Object bean, String name)
throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
Object value = PropertyUtils.getIndexedProperty(bean, name);
return (ConvertUtils.convert(value));
}
/**
* Return the value of the specified indexed property of the specified
* bean, as a String.
*
* @param bean Bean whose property is to be extracted
* @param name Simple property name of the property value to be extracted
* @param index Index of the property value to be extracted
*
* @exception IllegalAccessException if the caller does not have
* access to the property accessor method
* @exception InvocationTargetException if the property accessor method
* throws an exception
* @exception NoSuchMethodException if an accessor method for this
* propety cannot be found
*/
public static Object getIndexedProperty(Object bean, String name, int index)
throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
Object value = PropertyUtils.getIndexedProperty(bean, name);
return (ConvertUtils.convert(value));
}
/**
* Return the value of the (possibly nested) property of the specified
* name, for the specified bean, as a String.
*
* @param bean Bean whose property is to be extracted
* @param name Possibly nested name of the property to be extracted
*
* @exception IllegalAccessException if the caller does not have
* access to the property accessor method
* @exception IllegalArgumentException if a nested reference to a
* property returns null
* @exception InvocationTargetException if the property accessor method
* throws an exception
* @exception NoSuchMethodException if an accessor method for this
* propety cannot be found
*/
public static String getNestedProperty(Object bean, String name)
throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
Object value = PropertyUtils.getNestedProperty(bean, name);
return (ConvertUtils.convert(value));
}
/**
* Return the value of the specified property of the specified bean,
* no matter which property reference format is used, as a String.
*
* @param bean Bean whose property is to be extracted
* @param name Possibly indexed and/or nested name of the property
* to be extracted
*
* @exception IllegalAccessException if the caller does not have
* access to the property accessor method
* @exception InvocationTargetException if the property accessor method
* throws an exception
* @exception NoSuchMethodException if an accessor method for this
* propety cannot be found
*/
public static String getProperty(Object bean, String name)
throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
return (getNestedProperty(bean, name));
}
/**
* Return the value of the specified property of the specified
* bean, with no type conversinos.
*
* @param bean Bean whose property is to be extracted
* @param name Name of the property to be extracted
*
* @exception IllegalAccessException if the caller does not have
* access to the property accessor method
* @exception InvocationTargetException if the property accessor method
* throws an exception
* @exception NoSuchMethodException if an accessor method for this
* propety cannot be found
*
* @deprecated Use PropertyUtils.getProperty() instead.
*/
public static Object getPropertyValue(Object bean, String name)
throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
return (PropertyUtils.getProperty(bean, name));
}
/**
* Return the value of the specified scalar property of the specified
* bean, as a String.
*
* @param bean Bean whose property is to be extracted
* @param name Name of the property to be extracted
*
* @exception IllegalAccessException if the caller does not have
* access to the property accessor method
* @exception InvocationTargetException if the property accessor method
* throws an exception
* @exception NoSuchMethodException if an accessor method for this
* propety cannot be found
*
* @deprecated Use getSimpleProperty(Object,String) instead
*/
public static String getScalarProperty(Object bean, String name)
throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
return (getSimpleProperty(bean, name));
}
/**
* Return the value of the specified simple property of the specified
* bean, converted to a String.
*
* @param bean Bean whose property is to be extracted
* @param name Name of the property to be extracted
*
* @exception IllegalAccessException if the caller does not have
* access to the property accessor method
* @exception InvocationTargetException if the property accessor method
* throws an exception
* @exception NoSuchMethodException if an accessor method for this
* propety cannot be found
*/
public static String getSimpleProperty(Object bean, String name)
throws IllegalAccessException, InvocationTargetException, NoSuchMethodException {
Object value = PropertyUtils.getSimpleProperty(bean, name);
return (ConvertUtils.convert(value));
}
/**
* Populate the JavaBeans properties of the specified bean, based on
* the specified name/value pairs. This method uses Java reflection APIs
* to identify corresponding "property setter" method names, and deals
* with setter arguments of type String, boolean,
* int, long, float, and
* double. In addition, array setters for these types (or the
* corresponding primitive types) can also be identified.
* * The particular setter method to be called for each property is * determined using the usual JavaBeans introspection mechanisms. Thus, * you may identify custom setter methods using a BeanInfo class that is * associated with the class of the bean itself. If no such BeanInfo * class is available, the standard method name conversion ("set" plus * the capitalized name of the property in question) is used. *
* NOTE: It is contrary to the JavaBeans Specification * to have more than one setter method (with different argument * signatures) for the same property. * * @param bean JavaBean whose properties are being populated * @param properties Map keyed by property name, with the * corresponding (String or String[]) value(s) to be set * * @exception IllegalAccessException if the caller does not have * access to the property accessor method * @exception InvocationTargetException if the property accessor method * throws an exception */ public static void populate(Object bean, Map properties) throws IllegalAccessException, InvocationTargetException { if ((bean == null) || (properties == null)) return; if (debug >= 1) System.out.println("BeanUtils.populate(" + bean + ", " + properties + ")"); // Loop through the property name/value pairs to be set Iterator names = properties.keySet().iterator(); if(bean instanceof Property) { while (names.hasNext()) { String name = (String) names.next(); if (name == null) continue; Object value = properties.get(name); // String or String[] Object parameters[] = new Object[1]; if (value instanceof String[]) { parameters[0] = ((String[])value)[0]; } else { parameters[0] = value; } try { PropertyUtils.setProperty(bean, name, parameters[0]); } catch (NoSuchMethodException e) { if (debug >= 1) { System.out.println(" CANNOT HAPPEN: " + e); e.printStackTrace(System.out); } } } } else { while (names.hasNext()) { // Identify the property name and value(s) to be assigned String name = (String) names.next(); if (name == null) continue; Object value = properties.get(name); // String or String[] /* if (debug >= 1) System.out.println(" name='" + name + "', value.class='" + (value == null ? "NONE" : value.getClass().getName()) + "'"); */ // Get the property descriptor of the requested property (if any) PropertyDescriptor descriptor = null; try { descriptor = PropertyUtils.getPropertyDescriptor(bean, name); } catch (Throwable t) { /* if (debug >= 1) System.out.println(" getPropertyDescriptor: " + t); */ descriptor = null; } if (descriptor == null) { /* if (debug >= 1) System.out.println(" No such property, skipping"); */ continue; } /* if (debug >= 1) System.out.println(" Property descriptor is '" + descriptor + "'"); */ // Identify the relevant setter method (if there is one) Method setter = null; if (descriptor instanceof IndexedPropertyDescriptor) setter = ((IndexedPropertyDescriptor) descriptor).getIndexedWriteMethod(); if (setter == null) setter = descriptor.getWriteMethod(); if (setter == null) { if (debug >= 1) System.out.println(" No setter method, skipping"); continue; } Class parameterTypes[] = setter.getParameterTypes(); /* if (debug >= 1) System.out.println(" Setter method is '" + setter.getName() + "(" + parameterTypes[0].getName() + (parameterTypes.length > 1 ? ", " + parameterTypes[1].getName() : "" ) + ")'"); */ Class parameterType = parameterTypes[0]; if (parameterTypes.length > 1) parameterType = parameterTypes[1]; // Indexed setter // Convert the parameter value as required for this setter method Object parameters[] = new Object[1]; if (parameterTypes[0].isArray()) { if (value instanceof String) { String values[] = new String[1]; values[0] = (String) value; parameters[0] = ConvertUtils.convert((String[]) values, parameterType); } else if (value instanceof String[]) { parameters[0] = ConvertUtils.convert((String[]) value, parameterType); } else { parameters[0] = value; } } else { if (value instanceof String) { parameters[0] = ConvertUtils.convert((String) value, parameterType); } else if (value instanceof String[]) { parameters[0] = ConvertUtils.convert(((String[]) value)[0], parameterType); } else { parameters[0] = value; } } // Invoke the setter method /* if (debug >= 1) System.out.println(" Setting to " + (parameters[0] == null ? "NULL" : "'" + parameters[0] + "'")); */ try { PropertyUtils.setProperty(bean, name, parameters[0]); } catch (NoSuchMethodException e) { if (debug >= 1) { System.out.println(" CANNOT HAPPEN: " + e); e.printStackTrace(System.out); } } } /* if (debug >= 1) System.out.println("============================================"); */ } } }