/**
 * Interface for handling JavaBeans metadata.
 * <p>
 * Instances of {@link BeanDesc} are obtained from {@link BeanDescFactory}.
 * </p>
 *
 * <pre>
 * BeanDesc beanDesc = BeanDescFactory.getBeanDesc(Foo.class);
 * </pre>
 * <p>
 * From the obtained {@link BeanDesc}, you can retrieve metadata of the properties, fields, constructors, and methods of the target JavaBeans.
 * </p>
 *
 * <pre>

     * @throws Exception
     */
    @Test
    public void testBar() throws Exception {
        final BeanDesc beanDesc = new BeanDescImpl(MyBean.class);
        final MethodDesc bar = beanDesc.getMethodDesc("bar", String.class);
        assertThat(bar, is(notNullValue()));
        assertThat(bar.getBeanDesc(), is(sameInstance(beanDesc)));
        assertThat(bar.getMethod(), is(MyBean.class.getDeclaredMethod("bar", String.class)));

     * Constructs an instance.
     *
     * @param beanDesc
     *            The {@link BeanDesc} of the class that owns this method. Must not be {@literal null}.
     * @param constructor
     *            The constructor. Must not be {@literal null}.
     */
    public ConstructorDescImpl(final BeanDesc beanDesc, final Constructor<?> constructor) {
        assertArgumentNotNull("beanDesc", beanDesc);

     *
     * @param beanDesc the {@link BeanDesc} representing the annotation
     * @param annotation the annotation
     * @param name the name of the element
     * @return the value of the annotation element
     */
    protected static Object getProperty(final BeanDesc beanDesc, final Annotation annotation, final String name) {
        final MethodDesc methodDesc = beanDesc.getMethodDescNoException(name);

    @Test
    public void test1ArgConstructor() throws Exception {
        final BeanDesc beanDesc = new BeanDescImpl(MyBean.class);
        final ConstructorDesc ctor = beanDesc.getConstructorDesc(String.class);
        assertThat(ctor, is(notNullValue()));
        assertThat(ctor.getBeanDesc(), is(sameInstance(beanDesc)));
        assertThat(ctor.getConstructor(), is((Constructor) MyBean.class.getConstructor(String.class)));

    /**
     * Constructs an instance.
     *
     * @param beanDesc
     *            The {@link BeanDesc} of the class that owns this field. Must not be {@literal null}.
     * @param field
     *            The field. Must not be {@literal null}.
     */
    public FieldDescImpl(final BeanDesc beanDesc, final Field field) {
        assertArgumentNotNull("beanDesc", beanDesc);
        assertArgumentNotNull("field", field);

/**
 * Interface for handling constructors.
 *
 * @author koichik
 */
public interface ConstructorDesc {

    /**
     * Returns the {@link BeanDesc} of the class that owns this constructor.
     *
     * @return {@link BeanDesc}
     */
    BeanDesc getBeanDesc();

    /**
     * Returns the constructor.
     *
     * @param <T>
     *            The type of the Bean
     * @return The constructor

import java.util.Map;

/**
 * Interface for handling fields.
 *
 * @author koichik
 */
public interface FieldDesc {

    /**
     * Returns the {@link BeanDesc} of the class that owns this field.
     *
     * @return {@link BeanDesc}
     */
    BeanDesc getBeanDesc();

    /**
     * Returns the field.
     *
     * @return the field
     */
    Field getField();

    /**

     *            the value to be converted
     * @return the converted value
     */
    <T> T convertIfNeed(Object value);

    /**
     * Returns the {@link BeanDesc}.
     *
     * @return the {@link BeanDesc}
     */
    BeanDesc getBeanDesc();

    /**
     * Returns {@literal true} if this property is parameterized.
     *
     * @return {@literal true} if this property is parameterized
     */

 * <p>
 * This class does not cache instances of {@link ParameterizedClassDesc}. Please obtain {@link ParameterizedClassDesc} via {@link BeanDesc}.
 * </p>
 *
 * @author koichik
 * @see BeanDesc#getTypeVariables()
 * @see PropertyDesc#getParameterizedClassDesc()
 * @see FieldDesc#getParameterizedClassDesc()
 * @see ConstructorDesc#getParameterizedClassDescs()