Add last missing docs

Author: juliarn

ultralight-java-databind-generated-callers/src/main/java/com/labymedia/ultralight/databind/call/property/generated/PropertyCallerGenerator.java

@@ -37,6 +37,9 @@
 import java.util.UUID;
 import java.util.function.Consumer;
 
+/**
+ * Generates certain {@link SingleGeneratedPropertyCaller}s.
+ */
 public class PropertyCallerGenerator {
 
     private static final Class<?> GENERATION_INTERFACE = SingleGeneratedPropertyCaller.class;
@@ -121,6 +124,7 @@ public SingleGeneratedPropertyCaller generateConstructorCaller(Constructor<?> co
     public SingleGeneratedPropertyCaller generateFieldCaller(Field field) throws NotFoundException, CannotCompileException, IOException, InvocationTargetException, NoSuchMethodException, InstantiationException, IllegalAccessException {
         Class<?> type = field.getType();
 
+        // when the caller is called with arguments, the field value will be set to the first argument
         StringBuilder methodContentBuilder = new StringBuilder("if (")
                 .append(PARAMETERS_PARAMETER_NAME)
                 .append(" != null && ")
@@ -136,6 +140,7 @@ public SingleGeneratedPropertyCaller generateFieldCaller(Field field) throws Not
                 .append(";")
                 .append(" return null; } return ");
 
+        // when no arguments are present, just return the field value
         this.wrapPrimitiveType(methodContentBuilder, type, builder ->
                 this.castInstance(builder, field.getDeclaringClass(), field.getModifiers())
                         .append(".")
@@ -211,6 +216,9 @@ private StringBuilder castParameter(StringBuilder builder, Class<?> type, int in
                 .append(")");
 
         if (isWrapped) {
+            // unwrapping the wrapper type to its primitive
+            // this is necessary to avoid verify errors,
+            // the javassist compiler has some issues with primitives and their wrappers
             builder.append(".")
                     .append(type.getName())
                     .append("Value()");
@@ -250,6 +258,9 @@ private StringBuilder wrapPrimitiveType(StringBuilder builder, Class<?> type, Co
         boolean isWrapped = wrappedType != null;
 
         if (isWrapped) {
+            // wrapping primitive type to its wrapper
+            // this is necessary to avoid verify errors,
+            // the javassist compiler has some issues with primitives and their wrappers
             builder.append(wrappedType.getName())
                     .append(".valueOf(");
         }

ultralight-java-databind/src/main/java/com/labymedia/ultralight/databind/DatabindConfiguration.java

@@ -43,7 +43,7 @@ public final class DatabindConfiguration {
      *
      * @param classCache             The class cache used by this configuration
      * @param methodChooser          The method chooser used by this configuration
-     * @param propertyCallerFactory
+     * @param propertyCallerFactory  The factory creating the property caller used for calling properties on java objects and classes
      * @param automaticPrototype     If {@code true}, automatic prototyping is enabled
      * @param contextProviderFactory The factory for binding context providers, or {@code null}, if this feature
      */
@@ -79,6 +79,11 @@ public MethodChooser methodChooser() {
         return methodChooser;
     }
 
+    /**
+     * Retrieves the property caller used for calling properties on java objects and classes.
+     *
+     * @return The property caller used for calling properties on java objects and classes
+     */
     public PropertyCaller.Factory propertyCallerFactory() {
         return propertyCallerFactory;
     }
@@ -153,6 +158,12 @@ public Builder methodChooser(MethodChooser methodChooser) {
             return this;
         }
 
+        /**
+         * Sets the property caller used for calling properties on java objects and classes.
+         *
+         * @param propertyCallerFactory The property caller to use
+         * @return this
+         */
         public Builder propertyCallerFactory(PropertyCaller.Factory propertyCallerFactory) {
             this.propertyCallerFactory = propertyCallerFactory;
             return this;

ultralight-java-databind/src/main/java/com/labymedia/ultralight/databind/DatabindJavascriptMethodHandler.java

@@ -54,7 +54,7 @@ public final class DatabindJavascriptMethodHandler {
      *
      * @param configuration   The configuration to use
      * @param conversionUtils The conversion utilities to use for converting objects
-     * @param propertyCaller
+     * @param propertyCaller  The property caller used for calling properties on java objects and classes
      * @param methodSet       The methods which can be invoked by this handler
      * @param name            The name of this handler class
      */
@@ -164,7 +164,7 @@ public JavascriptClass bake() {
      *
      * @param configuration   The configuration to use
      * @param conversionUtils The conversion utilities to user for converting objects
-     * @param propertyCaller
+     * @param propertyCaller  The property caller used for calling properties on java objects and classes
      * @param methodSet       The sets of methods invocable by this handler
      * @param name            The name of this handler class
      * @return The created handler