/*
 * 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.PropertyDescriptor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.Map;

import org.apache.commons.collections.FastHashMap;


Utility methods for using Java Reflection APIs to facilitate generic
property getter and setter operations on Java objects.
The implementations for these methods are provided by PropertyUtilsBean. For more details see PropertyUtilsBean.
See Also:
PropertyUtilsBean
Resolver
Version:
$Id$/**
 * <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.beanutils.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 Resolver implementation being used./**
     * 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.beanutils.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 Resolver implementation being used./**
     * 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.beanutils.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 Resolver implementation being used./**
     * 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.beanutils.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 Resolver implementation being used./**
     * 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.beanutils.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 Resolver implementation being used./**
     * 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.beanutils.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 debug static property is no longer used/**
     * 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 debug static property is no longer used
Returns:
debug property
Deprecated:
The debug static property is no longer used/**
     * 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 debug static property is no longer used
Params:
newDebug – debug property
Deprecated:
The debug static property is no longer used/**
     * 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.
For more details see PropertyUtilsBean.
See Also:
clearDescriptors.clearDescriptors/**
     * 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 BeanIntrospector objects to the initial default state. 
Since:
1.9/**
     * Resets the registered {@link BeanIntrospector} objects to the initial default
     * state.
     *
     * @since 1.9
     */
    public static void resetBeanIntrospectors() {
        PropertyUtilsBean.getInstance().resetBeanIntrospectors();
    }

    
Adds a BeanIntrospector. This object is invoked when the
property descriptors of a class need to be obtained.
Params:
introspector – the BeanIntrospector to be added (must
       not be null
Throws:
IllegalArgumentException – if the argument is null
Since:
1.9/**
     * 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 BeanIntrospector.
Params:
introspector – the BeanIntrospector to be removed
Returns:
true if the BeanIntrospector existed and
        could be removed, false otherwise
Since:
1.9/**
     * 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);
    }

    
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
BeanInfo classes).
For more details see PropertyUtilsBean.
Params:
dest – Destination bean whose properties are modified
orig – Origin bean whose properties are retrieved
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if the dest or
 orig argument is null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.copyProperties/**
     * <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);
    }


    
Return the entire set of properties for which the specified bean
provides a read method.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose properties are to be extracted
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean is null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.describe
Returns:
The set of properties for the bean/**
     * <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));

    }


    
Return the value of the specified indexed property of the specified
bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be extracted
name – propertyname[index] of the property value
 to be extracted
Throws:
IndexOutOfBoundsException – if the specified index
 is outside the valid range for the underlying property
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getIndexedProperty(Object, String)
Returns:
the indexed property value/**
     * <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));

    }


    
Return the value of the specified indexed property of the specified
bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be extracted
name – Simple property name of the property value to be extracted
index – Index of the property value to be extracted
Throws:
IndexOutOfBoundsException – if the specified index
 is outside the valid range for the underlying property
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getIndexedProperty(Object, String, int)
Returns:
the indexed property value/**
     * <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));
    }


    
Return the value of the specified mapped property of the
specified bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be extracted
name – propertyname(key) of the property value
 to be extracted
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getMappedProperty(Object, String)
Returns:
the mapped property value/**
     * <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));

    }


    
Return the value of the specified mapped property of the specified
bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be extracted
name – Mapped property name of the property value to be extracted
key – Key of the property value to be extracted
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getMappedProperty(Object, String, String)
Returns:
the mapped property value/**
     * <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);

    }


    
Return the mapped property descriptors for this bean class.
For more details see PropertyUtilsBean.
Params:
beanClass – Bean class to be introspected
See Also:
PropertyUtilsBean.getMappedPropertyDescriptors(Class<?>)
Returns:
the mapped property descriptors
Deprecated:
This method should not be exposed/**
     * <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)
     * @deprecated This method should not be exposed
     */
    @Deprecated
    public static FastHashMap getMappedPropertyDescriptors(final Class<?> beanClass) {

        return PropertyUtilsBean.getInstance().getMappedPropertyDescriptors(beanClass);

    }


    
Return the mapped property descriptors for this bean.
For more details see PropertyUtilsBean.
Params:
bean – Bean to be introspected
See Also:
PropertyUtilsBean.getMappedPropertyDescriptors(Object)
Returns:
the mapped property descriptors
Deprecated:
This method should not be exposed/**
     * <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 FastHashMap getMappedPropertyDescriptors(final Object bean) {

        return PropertyUtilsBean.getInstance().getMappedPropertyDescriptors(bean);

    }


    
Return the value of the (possibly nested) property of the specified
name, for the specified bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be extracted
name – Possibly nested name of the property to be extracted
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
NestedNullException – if a nested reference to a
 property returns null
InvocationTargetException – 
if the property accessor method throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getNestedProperty
Returns:
the nested property value/**
     * <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);

    }


    
Return the value of the specified property of the specified bean,
no matter which property reference format is used, with no
type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be extracted
name – Possibly indexed and/or nested name of the property
 to be extracted
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getProperty
Returns:
the property value/**
     * <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));

    }


    
Retrieve the property descriptor for the specified property of the
specified bean, or return null if there is no such
descriptor.
For more details see PropertyUtilsBean.
Params:
bean – Bean for which a property descriptor is requested
name – Possibly indexed and/or nested name of the property for
 which a property descriptor is requested
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
IllegalArgumentException – if a nested reference to a
 property returns null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getPropertyDescriptor
Returns:
the property descriptor/**
     * <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);

    }


    
Retrieve the property descriptors for the specified class,
introspecting and caching them the first time a particular bean class
is encountered.
For more details see PropertyUtilsBean.
Params:
beanClass – Bean class for which property descriptors are requested
Throws:
IllegalArgumentException – if beanClass is null
See Also:
PropertyUtilsBean.getPropertyDescriptors(Class<?>)
Returns:
the property descriptors/**
     * <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);

    }


    
Retrieve the property descriptors for the specified bean,
introspecting and caching them the first time a particular bean class
is encountered.
For more details see PropertyUtilsBean.
Params:
bean – Bean for which property descriptors are requested
Throws:
IllegalArgumentException – if bean is null
See Also:
PropertyUtilsBean.getPropertyDescriptors(Object)
Returns:
the property descriptors/**
     * <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);

    }


    
Return the Java Class repesenting the property editor class that has
been registered for this property (if any).
For more details see PropertyUtilsBean.
Params:
bean – Bean for which a property descriptor is requested
name – Possibly indexed and/or nested name of the property for
 which a property descriptor is requested
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
IllegalArgumentException – if a nested reference to a
 property returns null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getPropertyEditorClass(Object, String)
Returns:
the property editor class/**
     * <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);

    }


    
Return the Java Class representing the property type of the specified
property, or null if there is no such property for the
specified bean.
For more details see PropertyUtilsBean.
Params:
bean – Bean for which a property descriptor is requested
name – Possibly indexed and/or nested name of the property for
 which a property descriptor is requested
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
IllegalArgumentException – if a nested reference to a
 property returns null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getPropertyType(Object, String)
Returns:
The property type/**
     * <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);
    }


    
Return an accessible property getter method for this property,
if there is one; otherwise return null.
For more details see PropertyUtilsBean.
Params:
descriptor – Property descriptor to return a getter for
See Also:
PropertyUtilsBean.getReadMethod(PropertyDescriptor)
Returns:
The read method/**
     * <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));

    }


    
Return the value of the specified simple property of the specified
bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be extracted
name – Name of the property to be extracted
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
IllegalArgumentException – if the property name
 is nested or indexed
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.getSimpleProperty
Returns:
The property value/**
     * <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);

    }


    
Return an accessible property setter method for this property,
if there is one; otherwise return null.
For more details see PropertyUtilsBean.
Params:
descriptor – Property descriptor to return a setter for
See Also:
PropertyUtilsBean.getWriteMethod(PropertyDescriptor)
Returns:
The write method/**
     * <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);

    }


    
Return true if the specified property name identifies
a readable property on the specified bean; otherwise, return
false.
For more details see PropertyUtilsBean.
Params:
bean – Bean to be examined (may be a DynaBean
name – Property name to be evaluated
Throws:
IllegalArgumentException – if bean
 or name is null
See Also:
PropertyUtilsBean.isReadable
Returns:
true if the property is readable,
otherwise false
Since:
BeanUtils 1.6/**
     * <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);
    }


    
Return true if the specified property name identifies
a writeable property on the specified bean; otherwise, return
false.
For more details see PropertyUtilsBean.
Params:
bean – Bean to be examined (may be a DynaBean
name – Property name to be evaluated
Throws:
IllegalArgumentException – if bean
 or name is null
See Also:
PropertyUtilsBean.isWriteable
Returns:
true if the property is writeable,
otherwise false
Since:
BeanUtils 1.6/**
     * <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);
    }


    
Sets the value of the specified indexed property of the specified
bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be modified
name – propertyname[index] of the property value
 to be modified
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
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.setIndexedProperty(Object, String, Object)/**
     * <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);

    }


    
Sets the value of the specified indexed property of the specified
bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be set
name – Simple property name of the property value to be set
index – Index of the property value to be set
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
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.setIndexedProperty(Object, String, Object)/**
     * <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);
    }


    
Sets the value of the specified mapped property of the
specified bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be set
name – propertyname(key) of the property value
 to be set
value – The property value to be set
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.setMappedProperty(Object, String, Object)/**
     * <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);
    }


    
Sets the value of the specified mapped property of the specified
bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be set
name – Mapped property name of the property value to be set
key – Key of the property value to be set
value – The property value to be set
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.setMappedProperty(Object, String, String, Object)/**
     * <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);
    }


    
Sets the value of the (possibly nested) property of the specified
name, for the specified bean, with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be modified
name – Possibly nested name of the property to be modified
value – Value to which the property is to be set
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
IllegalArgumentException – if a nested reference to a
 property returns null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.setNestedProperty/**
     * <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);
    }


    
Set the value of the specified property of the specified bean,
no matter which property reference format is used, with no
type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be modified
name – Possibly indexed and/or nested name of the property
 to be modified
value – Value to which this property is to be set
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.setProperty/**
     * <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);

    }


    
Set the value of the specified simple property of the specified bean,
with no type conversions.
For more details see PropertyUtilsBean.
Params:
bean – Bean whose property is to be modified
name – Name of the property to be modified
value – Value to which the property should be set
Throws:
IllegalAccessException – if the caller does not have
 access to the property accessor method
IllegalArgumentException – if bean or
 name is null
IllegalArgumentException – if the property name is
 nested or indexed
InvocationTargetException – if the property accessor method
 throws an exception
NoSuchMethodException – if an accessor method for this
 propety cannot be found
See Also:
PropertyUtilsBean.setSimpleProperty/**
     * <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);
    }


}