/**
 * 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>

    @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)));

         * and the destroyer function if present.
         */
        protected void destroy() {
            final BeanDesc beanDesc = BeanDescFactory.getBeanDesc(instance.getClass());
            for (final String methodName : beanDesc.getMethodNames()) {
                final MethodDesc methodDesc = beanDesc.getMethodDescNoException(methodName);
                if (methodDesc != null) {

     * @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)));

     *
     * @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);

    /**
     * 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);

        final BeanDesc beanDesc = new BeanDescImpl(MyBean.class);
        final PropertyDesc propDesc = beanDesc.getPropertyDesc("jjj");
        propDesc.setValue(myBean, null);
    }

    /**
     * @throws Exception
     */
    @Test(expected = IllegalPropertyRuntimeException.class)
    public void testSetValue_invalidType() throws Exception {
        final MyBean myBean = new MyBean();

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

     *            The setter method.
     * @param beanDesc
     *            The {@link BeanDesc}. Must not be {@literal null}.
     */
    public PropertyDescImpl(final String propertyName, final Class<?> propertyType, final Method readMethod, final Method writeMethod,
            final BeanDesc beanDesc) {
        this(propertyName, propertyType, readMethod, writeMethod, null, beanDesc);
    }

    /**

        final BeanDesc beanDesc = new BeanDescImpl(Integer.class);
        assertThat((Integer) beanDesc.newInstance(10), is(10));
        assertThat((Integer) beanDesc.newInstance("10"), is(10));
    }

    /**
     * @throws Exception
     */
    @Test
    public void testNewInstance2() throws Exception {
        final BeanDesc beanDesc = new BeanDescImpl(Integer.class);