| /* |
| * 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.beanutils2; |
| |
| import java.beans.PropertyDescriptor; |
| import java.lang.reflect.InvocationTargetException; |
| import java.lang.reflect.Method; |
| import java.util.Map; |
| |
| |
| /** |
| * <p>Utility methods for using Java Reflection APIs to facilitate generic |
| * property getter and setter operations on Java objects.</p> |
| * |
| * <p>The implementations for these methods are provided by <code>PropertyUtilsBean</code>. |
| * For more details see {@link PropertyUtilsBean}.</p> |
| * |
| * @version $Id$ |
| * @see PropertyUtilsBean |
| * @see org.apache.commons.beanutils2.expression.Resolver |
| */ |
| |
| public class PropertyUtils { |
| |
| |
| // ----------------------------------------------------- Manifest Constants |
| |
| |
| /** |
| * The delimiter that preceeds the zero-relative subscript for an |
| * indexed reference. |
| * |
| * @deprecated The notation used for property name expressions is now |
| * dependant on the {@link org.apache.commons.beanutils2.expression.Resolver} |
| * implementation being used. |
| */ |
| @Deprecated |
| public static final char INDEXED_DELIM = '['; |
| |
| |
| /** |
| * The delimiter that follows the zero-relative subscript for an |
| * indexed reference. |
| * |
| * @deprecated The notation used for property name expressions is now |
| * dependant on the {@link org.apache.commons.beanutils2.expression.Resolver} |
| * implementation being used. |
| */ |
| @Deprecated |
| public static final char INDEXED_DELIM2 = ']'; |
| |
| |
| /** |
| * The delimiter that preceeds the key of a mapped property. |
| * |
| * @deprecated The notation used for property name expressions is now |
| * dependant on the {@link org.apache.commons.beanutils2.expression.Resolver} |
| * implementation being used. |
| */ |
| @Deprecated |
| public static final char MAPPED_DELIM = '('; |
| |
| |
| /** |
| * The delimiter that follows the key of a mapped property. |
| * |
| * @deprecated The notation used for property name expressions is now |
| * dependant on the {@link org.apache.commons.beanutils2.expression.Resolver} |
| * implementation being used. |
| */ |
| @Deprecated |
| public static final char MAPPED_DELIM2 = ')'; |
| |
| |
| /** |
| * The delimiter that separates the components of a nested reference. |
| * |
| * @deprecated The notation used for property name expressions is now |
| * dependant on the {@link org.apache.commons.beanutils2.expression.Resolver} |
| * implementation being used. |
| */ |
| @Deprecated |
| public static final char NESTED_DELIM = '.'; |
| |
| |
| // ------------------------------------------------------- Static Variables |
| |
| |
| /** |
| * The debugging detail level for this component. |
| * |
| * Note that this static variable will have unexpected side-effects if |
| * this class is deployed in a shared classloader within a container. |
| * However as it is actually completely ignored by this class due to its |
| * deprecated status, it doesn't do any actual harm. |
| * |
| * @deprecated The <code>debug</code> static property is no longer used |
| */ |
| @Deprecated |
| private static int debug = 0; |
| |
| /** |
| * The <code>debug</code> static property is no longer used |
| * @return debug property |
| * @deprecated The <code>debug</code> static property is no longer used |
| */ |
| @Deprecated |
| public static int getDebug() { |
| return debug; |
| } |
| |
| /** |
| * The <code>debug</code> static property is no longer used |
| * @param newDebug debug property |
| * @deprecated The <code>debug</code> static property is no longer used |
| */ |
| @Deprecated |
| public static void setDebug(final int newDebug) { |
| debug = newDebug; |
| } |
| |
| // --------------------------------------------------------- Public Methods |
| |
| |
| /** |
| * Clear any cached property descriptors information for all classes |
| * loaded by any class loaders. This is useful in cases where class |
| * loaders are thrown away to implement class reloading. |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @see PropertyUtilsBean#clearDescriptors |
| */ |
| public static void clearDescriptors() { |
| |
| PropertyUtilsBean.getInstance().clearDescriptors(); |
| |
| } |
| |
| /** |
| * Resets the registered {@link BeanIntrospector} objects to the initial default |
| * state. |
| * |
| * @since 1.9 |
| */ |
| public static void resetBeanIntrospectors() { |
| PropertyUtilsBean.getInstance().resetBeanIntrospectors(); |
| } |
| |
| /** |
| * Adds a <code>BeanIntrospector</code>. This object is invoked when the |
| * property descriptors of a class need to be obtained. |
| * |
| * @param introspector the <code>BeanIntrospector</code> to be added (must |
| * not be <b>null</b> |
| * @throws IllegalArgumentException if the argument is <b>null</b> |
| * @since 1.9 |
| */ |
| public static void addBeanIntrospector(final BeanIntrospector introspector) { |
| PropertyUtilsBean.getInstance().addBeanIntrospector(introspector); |
| } |
| |
| /** |
| * Removes the specified <code>BeanIntrospector</code>. |
| * |
| * @param introspector the <code>BeanIntrospector</code> to be removed |
| * @return <b>true</b> if the <code>BeanIntrospector</code> existed and |
| * could be removed, <b>false</b> otherwise |
| * @since 1.9 |
| */ |
| public static boolean removeBeanIntrospector(final BeanIntrospector introspector) { |
| return PropertyUtilsBean.getInstance().removeBeanIntrospector( |
| introspector); |
| } |
| |
| /** |
| * <p>Copy property values from the "origin" bean to the "destination" bean |
| * for all cases where the property names are the same (even though the |
| * actual getter and setter methods might have been customized via |
| * <code>BeanInfo</code> classes).</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param dest Destination bean whose properties are modified |
| * @param orig Origin bean whose properties are retrieved |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if the <code>dest</code> or |
| * <code>orig</code> argument is null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#copyProperties |
| */ |
| public static void copyProperties(final Object dest, final Object orig) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| PropertyUtilsBean.getInstance().copyProperties(dest, orig); |
| } |
| |
| |
| /** |
| * <p>Return the entire set of properties for which the specified bean |
| * provides a read method.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose properties are to be extracted |
| * @return The set of properties for the bean |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> is null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#describe |
| */ |
| public static Map<String, Object> describe(final Object bean) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().describe(bean); |
| |
| } |
| |
| |
| /** |
| * <p>Return the value of the specified indexed property of the specified |
| * bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be extracted |
| * @param name <code>propertyname[index]</code> of the property value |
| * to be extracted |
| * @return the indexed property value |
| * |
| * @throws IndexOutOfBoundsException if the specified index |
| * is outside the valid range for the underlying property |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getIndexedProperty(Object,String) |
| */ |
| public static Object getIndexedProperty(final Object bean, final String name) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getIndexedProperty(bean, name); |
| |
| } |
| |
| |
| /** |
| * <p>Return the value of the specified indexed property of the specified |
| * bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @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 |
| * @return the indexed property value |
| * |
| * @throws IndexOutOfBoundsException if the specified index |
| * is outside the valid range for the underlying property |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getIndexedProperty(Object,String, int) |
| */ |
| public static Object getIndexedProperty(final Object bean, |
| final String name, final int index) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getIndexedProperty(bean, name, index); |
| } |
| |
| |
| /** |
| * <p>Return the value of the specified mapped property of the |
| * specified bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be extracted |
| * @param name <code>propertyname(key)</code> of the property value |
| * to be extracted |
| * @return the mapped property value |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getMappedProperty(Object,String) |
| */ |
| public static Object getMappedProperty(final Object bean, final String name) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getMappedProperty(bean, name); |
| |
| } |
| |
| |
| /** |
| * <p>Return the value of the specified mapped property of the specified |
| * bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be extracted |
| * @param name Mapped property name of the property value to be extracted |
| * @param key Key of the property value to be extracted |
| * @return the mapped property value |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getMappedProperty(Object,String, String) |
| */ |
| public static Object getMappedProperty(final Object bean, |
| final String name, final String key) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getMappedProperty(bean, name, key); |
| |
| } |
| |
| |
| /** |
| * <p>Return the mapped property descriptors for this bean class.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param beanClass Bean class to be introspected |
| * @return the mapped property descriptors |
| * @see PropertyUtilsBean#getMappedPropertyDescriptors(Class) |
| */ |
| static Map<Class<?>, Map> getMappedPropertyDescriptors(final Class<?> beanClass) { |
| |
| return PropertyUtilsBean.getInstance().getMappedPropertyDescriptors(beanClass); |
| |
| } |
| |
| |
| /** |
| * <p>Return the mapped property descriptors for this bean.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean to be introspected |
| * @return the mapped property descriptors |
| * @see PropertyUtilsBean#getMappedPropertyDescriptors(Object) |
| * @deprecated This method should not be exposed |
| */ |
| @Deprecated |
| public static Map<Class<?>, Map> getMappedPropertyDescriptors(final Object bean) { |
| |
| return PropertyUtilsBean.getInstance().getMappedPropertyDescriptors(bean); |
| |
| } |
| |
| |
| /** |
| * <p>Return the value of the (possibly nested) property of the specified |
| * name, for the specified bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be extracted |
| * @param name Possibly nested name of the property to be extracted |
| * @return the nested property value |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws NestedNullException if a nested reference to a |
| * property returns null |
| * @throws InvocationTargetException |
| * if the property accessor method throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getNestedProperty |
| */ |
| public static Object getNestedProperty(final Object bean, final String name) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getNestedProperty(bean, name); |
| |
| } |
| |
| |
| /** |
| * <p>Return the value of the specified property of the specified bean, |
| * no matter which property reference format is used, with no |
| * type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be extracted |
| * @param name Possibly indexed and/or nested name of the property |
| * to be extracted |
| * @return the property value |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getProperty |
| */ |
| public static Object getProperty(final Object bean, final String name) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getProperty(bean, name); |
| |
| } |
| |
| |
| /** |
| * <p>Retrieve the property descriptor for the specified property of the |
| * specified bean, or return <code>null</code> if there is no such |
| * descriptor.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean for which a property descriptor is requested |
| * @param name Possibly indexed and/or nested name of the property for |
| * which a property descriptor is requested |
| * @return the property descriptor |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws IllegalArgumentException if a nested reference to a |
| * property returns null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getPropertyDescriptor |
| */ |
| public static PropertyDescriptor getPropertyDescriptor(final Object bean, |
| final String name) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getPropertyDescriptor(bean, name); |
| |
| } |
| |
| |
| /** |
| * <p>Retrieve the property descriptors for the specified class, |
| * introspecting and caching them the first time a particular bean class |
| * is encountered.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param beanClass Bean class for which property descriptors are requested |
| * @return the property descriptors |
| * @throws IllegalArgumentException if <code>beanClass</code> is null |
| * @see PropertyUtilsBean#getPropertyDescriptors(Class) |
| */ |
| public static PropertyDescriptor[] |
| getPropertyDescriptors(final Class<?> beanClass) { |
| |
| return PropertyUtilsBean.getInstance().getPropertyDescriptors(beanClass); |
| |
| } |
| |
| |
| /** |
| * <p>Retrieve the property descriptors for the specified bean, |
| * introspecting and caching them the first time a particular bean class |
| * is encountered.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean for which property descriptors are requested |
| * @return the property descriptors |
| * @throws IllegalArgumentException if <code>bean</code> is null |
| * @see PropertyUtilsBean#getPropertyDescriptors(Object) |
| */ |
| public static PropertyDescriptor[] getPropertyDescriptors(final Object bean) { |
| |
| return PropertyUtilsBean.getInstance().getPropertyDescriptors(bean); |
| |
| } |
| |
| |
| /** |
| * <p>Return the Java Class repesenting the property editor class that has |
| * been registered for this property (if any).</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean for which a property descriptor is requested |
| * @param name Possibly indexed and/or nested name of the property for |
| * which a property descriptor is requested |
| * @return the property editor class |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws IllegalArgumentException if a nested reference to a |
| * property returns null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getPropertyEditorClass(Object,String) |
| */ |
| public static Class<?> getPropertyEditorClass(final Object bean, final String name) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getPropertyEditorClass(bean, name); |
| |
| } |
| |
| |
| /** |
| * <p>Return the Java Class representing the property type of the specified |
| * property, or <code>null</code> if there is no such property for the |
| * specified bean.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean for which a property descriptor is requested |
| * @param name Possibly indexed and/or nested name of the property for |
| * which a property descriptor is requested |
| * @return The property type |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws IllegalArgumentException if a nested reference to a |
| * property returns null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getPropertyType(Object, String) |
| */ |
| public static Class<?> getPropertyType(final Object bean, final String name) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getPropertyType(bean, name); |
| } |
| |
| |
| /** |
| * <p>Return an accessible property getter method for this property, |
| * if there is one; otherwise return <code>null</code>.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param descriptor Property descriptor to return a getter for |
| * @return The read method |
| * @see PropertyUtilsBean#getReadMethod(PropertyDescriptor) |
| */ |
| public static Method getReadMethod(final PropertyDescriptor descriptor) { |
| |
| return PropertyUtilsBean.getInstance().getReadMethod(descriptor); |
| |
| } |
| |
| |
| /** |
| * <p>Return the value of the specified simple property of the specified |
| * bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be extracted |
| * @param name Name of the property to be extracted |
| * @return The property value |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws IllegalArgumentException if the property name |
| * is nested or indexed |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#getSimpleProperty |
| */ |
| public static Object getSimpleProperty(final Object bean, final String name) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| return PropertyUtilsBean.getInstance().getSimpleProperty(bean, name); |
| |
| } |
| |
| |
| /** |
| * <p>Return an accessible property setter method for this property, |
| * if there is one; otherwise return <code>null</code>.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param descriptor Property descriptor to return a setter for |
| * @return The write method |
| * @see PropertyUtilsBean#getWriteMethod(PropertyDescriptor) |
| */ |
| public static Method getWriteMethod(final PropertyDescriptor descriptor) { |
| |
| return PropertyUtilsBean.getInstance().getWriteMethod(descriptor); |
| |
| } |
| |
| |
| /** |
| * <p>Return <code>true</code> if the specified property name identifies |
| * a readable property on the specified bean; otherwise, return |
| * <code>false</code>.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean to be examined (may be a {@link DynaBean} |
| * @param name Property name to be evaluated |
| * @return <code>true</code> if the property is readable, |
| * otherwise <code>false</code> |
| * |
| * @throws IllegalArgumentException if <code>bean</code> |
| * or <code>name</code> is <code>null</code> |
| * @see PropertyUtilsBean#isReadable |
| * @since BeanUtils 1.6 |
| */ |
| public static boolean isReadable(final Object bean, final String name) { |
| |
| return PropertyUtilsBean.getInstance().isReadable(bean, name); |
| } |
| |
| |
| /** |
| * <p>Return <code>true</code> if the specified property name identifies |
| * a writeable property on the specified bean; otherwise, return |
| * <code>false</code>.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean to be examined (may be a {@link DynaBean} |
| * @param name Property name to be evaluated |
| * @return <code>true</code> if the property is writeable, |
| * otherwise <code>false</code> |
| * |
| * @throws IllegalArgumentException if <code>bean</code> |
| * or <code>name</code> is <code>null</code> |
| * @see PropertyUtilsBean#isWriteable |
| * @since BeanUtils 1.6 |
| */ |
| public static boolean isWriteable(final Object bean, final String name) { |
| |
| return PropertyUtilsBean.getInstance().isWriteable(bean, name); |
| } |
| |
| |
| /** |
| * <p>Sets the value of the specified indexed property of the specified |
| * bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be modified |
| * @param name <code>propertyname[index]</code> of the property value |
| * to be modified |
| * @param value Value to which the specified property element |
| * should be set |
| * |
| * @throws IndexOutOfBoundsException if the specified index |
| * is outside the valid range for the underlying property |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#setIndexedProperty(Object, String, Object) |
| */ |
| public static void setIndexedProperty(final Object bean, final String name, |
| final Object value) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| PropertyUtilsBean.getInstance().setIndexedProperty(bean, name, value); |
| |
| } |
| |
| |
| /** |
| * <p>Sets the value of the specified indexed property of the specified |
| * bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be set |
| * @param name Simple property name of the property value to be set |
| * @param index Index of the property value to be set |
| * @param value Value to which the indexed property element is to be set |
| * |
| * @throws IndexOutOfBoundsException if the specified index |
| * is outside the valid range for the underlying property |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#setIndexedProperty(Object, String, Object) |
| */ |
| public static void setIndexedProperty(final Object bean, final String name, |
| final int index, final Object value) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| PropertyUtilsBean.getInstance().setIndexedProperty(bean, name, index, value); |
| } |
| |
| |
| /** |
| * <p>Sets the value of the specified mapped property of the |
| * specified bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be set |
| * @param name <code>propertyname(key)</code> of the property value |
| * to be set |
| * @param value The property value to be set |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#setMappedProperty(Object, String, Object) |
| */ |
| public static void setMappedProperty(final Object bean, final String name, |
| final Object value) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| PropertyUtilsBean.getInstance().setMappedProperty(bean, name, value); |
| } |
| |
| |
| /** |
| * <p>Sets the value of the specified mapped property of the specified |
| * bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be set |
| * @param name Mapped property name of the property value to be set |
| * @param key Key of the property value to be set |
| * @param value The property value to be set |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#setMappedProperty(Object, String, String, Object) |
| */ |
| public static void setMappedProperty(final Object bean, final String name, |
| final String key, final Object value) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| PropertyUtilsBean.getInstance().setMappedProperty(bean, name, key, value); |
| } |
| |
| |
| /** |
| * <p>Sets the value of the (possibly nested) property of the specified |
| * name, for the specified bean, with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be modified |
| * @param name Possibly nested name of the property to be modified |
| * @param value Value to which the property is to be set |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws IllegalArgumentException if a nested reference to a |
| * property returns null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#setNestedProperty |
| */ |
| public static void setNestedProperty(final Object bean, |
| final String name, final Object value) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| PropertyUtilsBean.getInstance().setNestedProperty(bean, name, value); |
| } |
| |
| |
| /** |
| * <p>Set the value of the specified property of the specified bean, |
| * no matter which property reference format is used, with no |
| * type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be modified |
| * @param name Possibly indexed and/or nested name of the property |
| * to be modified |
| * @param value Value to which this property is to be set |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#setProperty |
| */ |
| public static void setProperty(final Object bean, final String name, final Object value) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| PropertyUtilsBean.getInstance().setProperty(bean, name, value); |
| |
| } |
| |
| |
| /** |
| * <p>Set the value of the specified simple property of the specified bean, |
| * with no type conversions.</p> |
| * |
| * <p>For more details see <code>PropertyUtilsBean</code>.</p> |
| * |
| * @param bean Bean whose property is to be modified |
| * @param name Name of the property to be modified |
| * @param value Value to which the property should be set |
| * |
| * @throws IllegalAccessException if the caller does not have |
| * access to the property accessor method |
| * @throws IllegalArgumentException if <code>bean</code> or |
| * <code>name</code> is null |
| * @throws IllegalArgumentException if the property name is |
| * nested or indexed |
| * @throws InvocationTargetException if the property accessor method |
| * throws an exception |
| * @throws NoSuchMethodException if an accessor method for this |
| * propety cannot be found |
| * @see PropertyUtilsBean#setSimpleProperty |
| */ |
| public static void setSimpleProperty(final Object bean, |
| final String name, final Object value) |
| throws IllegalAccessException, InvocationTargetException, |
| NoSuchMethodException { |
| |
| PropertyUtilsBean.getInstance().setSimpleProperty(bean, name, value); |
| } |
| |
| |
| } |
