Added value alias for @BeanProperty

@BeanProperty could only be used with a `name` property. Adding a
`value` alias allows this annotation to be used without any prefix and
just the name of the property.

Also corrected all warnings about javadoc (missing returns).

Fixes #122

src/main/java/io/beanmapper/BeanMapper.java

@@ -110,13 +110,15 @@ public final Configuration getConfiguration() {
 
     /**
      * @deprecated use wrap() instead
+     * @return BeanMapperBuilder
      */
     public BeanMapperBuilder config() {
         return wrap();
     }
 
     /**
      * @deprecated use wrap() instead
+     * @return BeanMapperBuilder
      */
     public BeanMapperBuilder wrapConfig() {
         return wrap();

src/main/java/io/beanmapper/annotations/BeanCollection.java

@@ -51,6 +51,7 @@
      * functionality in combination with Lazy to make sure BeanMapper operates within the
      * transaction scope. If you do, the flush action can be rolled back, resulting in the
      * original state being preserved.
+     * @return Whether to flush the collection after clearing or not.
      */
     boolean flushAfterClear() default true;
 

src/main/java/io/beanmapper/annotations/BeanProperty.java

@@ -13,6 +13,8 @@
 @Retention(RetentionPolicy.RUNTIME)
 public @interface BeanProperty {
 
-    String name();
+    String name() default "";
+
+    String value() default "";
 
 }

src/main/java/io/beanmapper/annotations/BeanRoleSecured.java

@@ -15,6 +15,7 @@
 
     /**
      * The role the Principal must have to be allowed access to the field or method
+     * @return Role required to access the field or method
      */
     String[] value();
 

src/main/java/io/beanmapper/core/BeanMatchStore.java

@@ -259,7 +259,7 @@ private BeanPropertyWrapper dealWithBeanProperty(
         BeanPropertyWrapper wrapper = new BeanPropertyWrapper(accessor.getName());
         if (accessor.findAnnotation(io.beanmapper.annotations.BeanProperty.class) != null) {
             wrapper.setMustMatch();
-            wrapper.setName(accessor.findAnnotation(io.beanmapper.annotations.BeanProperty.class).name());
+            wrapper.setName(getBeanPropertyName(accessor.findAnnotation(io.beanmapper.annotations.BeanProperty.class)));
             // Get the other field from the location that is specified in the beanProperty annotation.
             // If the field is referred to by a path, store the custom field in the other map
             try {
@@ -274,4 +274,14 @@ private BeanPropertyWrapper dealWithBeanProperty(
         return wrapper;
     }
 
+    private String getBeanPropertyName(io.beanmapper.annotations.BeanProperty annotation) {
+        String beanPropertyName = annotation.value();
+
+        if (beanPropertyName.isEmpty()) {
+            beanPropertyName = annotation.name();
+        }
+
+        return beanPropertyName;
+    }
+
 }

src/main/java/io/beanmapper/core/collections/AbstractCollectionHandler.java

@@ -24,7 +24,7 @@ public AbstractCollectionHandler() {
 
     /**
      * Creates a new instance of the collection class
-     * @return
+     * @return new instance of the collection class
      */
     abstract protected C create();
 

src/test/java/io/beanmapper/testmodel/othername/SourceWithOtherName.java

@@ -4,7 +4,7 @@
 
 public class SourceWithOtherName {
 
-    @BeanProperty(name = "bothOtherName")
+    @BeanProperty("bothOtherName")
     private String bothOtherName1;
     @BeanProperty(name = "sourceOtherName")
     private String sourceOtherName1;