Add error message constructor to all converters which can fail

Change-Id: I3ec60effc75e22765d21e0223ee1537ffbdb29e7

server/src/main/java/com/vaadin/data/util/converter/AbstractStringToNumberConverter.java

@@ -20,6 +20,8 @@
 import java.text.ParsePosition;
 import java.util.Locale;
 
+import com.vaadin.data.Result;
+
 /**
  * A converter that converts from the number type T to {@link String} and back.
  * Uses the given locale and {@link NumberFormat} for formatting and parsing.
@@ -35,6 +37,18 @@
 public abstract class AbstractStringToNumberConverter<T>
         implements Converter<String, T> {
 
+    private final String errorMessage;
+
+    /**
+     * Creates a new converter instance with the given error message.
+     *
+     * @param errorMessage
+     *            the error message to use if conversion fails
+     */
+    protected AbstractStringToNumberConverter(String errorMessage) {
+        this.errorMessage = errorMessage;
+    }
+
     /**
      * Returns the format used by {@link #convertToPresentation(Object, Locale)}
      * and {@link #convertToModel(Object, Locale)}.
@@ -61,9 +75,9 @@ protected NumberFormat getFormat(Locale locale) {
      *            The locale to use for conversion
      * @return The converted value
      */
-    protected Number convertToNumber(String value, Locale locale) {
+    protected Result<Number> convertToNumber(String value, Locale locale) {
         if (value == null) {
-            return null;
+            return Result.ok(null);
         }
 
         // Remove leading and trailing white space
@@ -74,16 +88,24 @@ protected Number convertToNumber(String value, Locale locale) {
         ParsePosition parsePosition = new ParsePosition(0);
         Number parsedValue = getFormat(locale).parse(value, parsePosition);
         if (parsePosition.getIndex() != value.length()) {
-            throw new IllegalArgumentException(
-                    "Could not convert '" + value + "'");
+            return Result.error(getErrorMessage());
         }
 
         if (parsedValue == null) {
             // Convert "" to null
-            return null;
+            return Result.ok(null);
         }
 
-        return parsedValue;
+        return Result.ok(parsedValue);
+    }
+
+    /**
+     * Gets the error message to use when conversion fails.
+     *
+     * @return the error message
+     */
+    protected String getErrorMessage() {
+        return errorMessage;
     }
 
     @Override

server/src/main/java/com/vaadin/data/util/converter/StringToBigDecimalConverter.java

@@ -38,6 +38,17 @@
  */
 public class StringToBigDecimalConverter
         extends AbstractStringToNumberConverter<BigDecimal> {
+
+    /**
+     * Creates a new converter instance with the given error message.
+     *
+     * @param errorMessage
+     *            the error message to use if conversion fails
+     */
+    public StringToBigDecimalConverter(String errorMessage) {
+        super(errorMessage);
+    }
+
     @Override
     protected NumberFormat getFormat(Locale locale) {
         NumberFormat numberFormat = super.getFormat(locale);
@@ -50,7 +61,8 @@ protected NumberFormat getFormat(Locale locale) {
 
     @Override
     public Result<BigDecimal> convertToModel(String value, Locale locale) {
-        return Result.ok((BigDecimal) convertToNumber(value, locale));
+        return convertToNumber(value, locale)
+                .map(number -> (BigDecimal) number);
     }
 
 }

server/src/main/java/com/vaadin/data/util/converter/StringToBigIntegerConverter.java

@@ -39,6 +39,15 @@
  */
 public class StringToBigIntegerConverter
         extends AbstractStringToNumberConverter<BigInteger> {
+    /**
+     * Creates a new converter instance with the given error message.
+     *
+     * @param errorMessage
+     *            the error message to use if conversion fails
+     */
+    public StringToBigIntegerConverter(String errorMessage) {
+        super(errorMessage);
+    }
 
     @Override
     protected NumberFormat getFormat(Locale locale) {
@@ -52,12 +61,13 @@ protected NumberFormat getFormat(Locale locale) {
 
     @Override
     public Result<BigInteger> convertToModel(String value, Locale locale) {
-
-        BigDecimal bigDecimalValue = (BigDecimal) convertToNumber(value,
-                locale);
-
-        return (bigDecimalValue != null)
-                ? Result.ok(bigDecimalValue.toBigInteger()) : Result.ok(null);
+        return convertToNumber(value, locale).map(number -> {
+            if (number == null) {
+                return null;
+            } else {
+                return ((BigDecimal) number).toBigInteger();
+            }
+        });
     }
 
 }

server/src/main/java/com/vaadin/data/util/converter/StringToBooleanConverter.java

@@ -41,31 +41,39 @@ public class StringToBooleanConverter implements Converter<String, Boolean> {
 
     private final String falseString;
 
+    private String errorMessage;
+
     /**
      * Creates converter with default string representations - "true" and
      * "false".
      *
+     * @param errorMessage
+     *            the error message to use if conversion fails
      */
-    public StringToBooleanConverter() {
-        this(Boolean.TRUE.toString(), Boolean.FALSE.toString());
+    public StringToBooleanConverter(String errorMessage) {
+        this(errorMessage, Boolean.TRUE.toString(), Boolean.FALSE.toString());
     }
 
     /**
      * Creates converter with custom string representation.
      *
+     * @param errorMessage
+     *            the error message to use if conversion fails
      * @param falseString
      *            string representation for <code>false</code>
      * @param trueString
      *            string representation for <code>true</code>
      */
-    public StringToBooleanConverter(String trueString, String falseString) {
+    public StringToBooleanConverter(String errorMessage, String trueString,
+            String falseString) {
+        this.errorMessage = errorMessage;
         this.trueString = trueString;
         this.falseString = falseString;
     }
 
     @Override
     public Result<Boolean> convertToModel(String value, Locale locale) {
-        if (value == null || value.isEmpty()) {
+        if (value == null) {
             return Result.ok(null);
         }
 
@@ -76,8 +84,10 @@ public Result<Boolean> convertToModel(String value, Locale locale) {
             return Result.ok(true);
         } else if (getFalseString(locale).equals(value)) {
             return Result.ok(false);
+        } else if (value.isEmpty()) {
+            return Result.ok(null);
         } else {
-            throw new IllegalArgumentException("Cannot convert " + value);
+            return Result.error(errorMessage);
         }
     }
 

server/src/main/java/com/vaadin/data/util/converter/StringToDoubleConverter.java

@@ -38,10 +38,27 @@
 public class StringToDoubleConverter
         extends AbstractStringToNumberConverter<Double> {
 
+    /**
+     * Creates a new converter instance with the given error message.
+     *
+     * @param errorMessage
+     *            the error message to use if conversion fails
+     */
+    public StringToDoubleConverter(String errorMessage) {
+        super(errorMessage);
+    }
+
     @Override
     public Result<Double> convertToModel(String value, Locale locale) {
-        Number n = convertToNumber(value, locale);
-        return n == null ? Result.ok(null) : Result.ok(n.doubleValue());
+        Result<Number> n = convertToNumber(value, locale);
+
+        return n.map(number -> {
+            if (number == null) {
+                return null;
+            } else {
+                return number.doubleValue();
+            }
+        });
     }
 
 }

server/src/main/java/com/vaadin/data/util/converter/StringToFloatConverter.java

@@ -27,21 +27,36 @@
  * parsing.
  * <p>
  * Leading and trailing white spaces are ignored when converting from a String.
- * </p>
  * <p>
  * Override and overwrite {@link #getFormat(Locale)} to use a different format.
- * </p>
  *
  * @author Vaadin Ltd
  * @since 8.0
  */
 public class StringToFloatConverter
         extends AbstractStringToNumberConverter<Float> {
 
+    /**
+     * Creates a new converter instance with the given error message.
+     *
+     * @param errorMessage
+     *            the error message to use if conversion fails
+     */
+    public StringToFloatConverter(String errorMessage) {
+        super(errorMessage);
+    }
+
     @Override
     public Result<Float> convertToModel(String value, Locale locale) {
-        Number n = convertToNumber(value, locale);
-        return n == null ? Result.ok(null) : Result.ok(n.floatValue());
+        Result<Number> n = convertToNumber(value, locale);
+
+        return n.map(number -> {
+            if (number == null) {
+                return null;
+            } else {
+                return number.floatValue();
+            }
+        });
     }
 
 }

server/src/main/java/com/vaadin/data/util/converter/StringToIntegerConverter.java

@@ -35,16 +35,14 @@
 public class StringToIntegerConverter
         extends AbstractStringToNumberConverter<Integer> {
 
-    private final String errorMessage;
-
     /**
      * Creates a new converter instance with the given error message.
      *
      * @param errorMessage
      *            the error message to use if conversion fails
      */
     public StringToIntegerConverter(String errorMessage) {
-        this.errorMessage = errorMessage;
+        super(errorMessage);
     }
 
     /**
@@ -66,22 +64,23 @@ protected NumberFormat getFormat(Locale locale) {
 
     @Override
     public Result<Integer> convertToModel(String value, Locale locale) {
-        Number n = convertToNumber(value, locale);
-
-        if (n == null) {
-            return Result.ok(null);
-        }
-
-        int intValue = n.intValue();
-        if (intValue == n.longValue()) {
-            // If the value of n is outside the range of long, the return value
-            // of longValue() is either Long.MIN_VALUE or Long.MAX_VALUE. The
-            // above comparison promotes int to long and thus does not need to
-            // consider wrap-around.
-            return Result.ok(intValue);
-        } else {
-            return Result.error(errorMessage);
-        }
+        Result<Number> n = convertToNumber(value, locale);
+        return n.flatMap(number -> {
+            if (number == null) {
+                return Result.ok(null);
+            } else {
+                int intValue = number.intValue();
+                if (intValue == number.longValue()) {
+                    // If the value of n is outside the range of long, the
+                    // return value of longValue() is either Long.MIN_VALUE or
+                    // Long.MAX_VALUE. The/ above comparison promotes int to
+                    // long and thus does not need to consider wrap-around.
+                    return Result.ok(intValue);
+                } else {
+                    return Result.error(getErrorMessage());
+                }
+            }
+        });
     }
 
 }

server/src/main/java/com/vaadin/data/util/converter/StringToLongConverter.java

@@ -35,6 +35,16 @@
 public class StringToLongConverter
         extends AbstractStringToNumberConverter<Long> {
 
+    /**
+     * Creates a new converter instance with the given error message.
+     *
+     * @param errorMessage
+     *            the error message to use if conversion fails
+     */
+    public StringToLongConverter(String errorMessage) {
+        super(errorMessage);
+    }
+
     /**
      * Returns the format used by {@link #convertToPresentation(Long, Locale)}
      * and {@link #convertToModel(String, Locale)}.
@@ -53,9 +63,14 @@ protected NumberFormat getFormat(Locale locale) {
 
     @Override
     public Result<Long> convertToModel(String value, Locale locale) {
-        Number n = convertToNumber(value, locale);
-        return n == null ? Result.ok(null) : Result.ok(n.longValue());
-
+        Result<Number> n = convertToNumber(value, locale);
+        return n.map(number -> {
+            if (number == null) {
+                return null;
+            } else {
+                return number.longValue();
+            }
+        });
     }
 
 }

server/src/main/java/com/vaadin/ui/declarative/DesignFormatter.java

@@ -109,7 +109,8 @@ public String convertToPresentation(Boolean value, Locale locale) {
         final DecimalFormat fmt = new DecimalFormat("0.###", symbols);
         fmt.setGroupingUsed(false);
 
-        Converter<String, ?> floatConverter = new StringToFloatConverter() {
+        Converter<String, ?> floatConverter = new StringToFloatConverter(
+                "Error converting value") {
             @Override
             protected NumberFormat getFormat(Locale locale) {
                 return fmt;
@@ -118,7 +119,8 @@ protected NumberFormat getFormat(Locale locale) {
         converterMap.put(Float.class, floatConverter);
         converterMap.put(float.class, floatConverter);
 
-        Converter<String, ?> doubleConverter = new StringToDoubleConverter() {
+        Converter<String, ?> doubleConverter = new StringToDoubleConverter(
+                "Error converting value") {
             @Override
             protected NumberFormat getFormat(Locale locale) {
                 return fmt;
@@ -130,12 +132,13 @@ protected NumberFormat getFormat(Locale locale) {
         final DecimalFormat bigDecimalFmt = new DecimalFormat("0.###", symbols);
         bigDecimalFmt.setGroupingUsed(false);
         bigDecimalFmt.setParseBigDecimal(true);
-        converterMap.put(BigDecimal.class, new StringToBigDecimalConverter() {
-            @Override
-            protected NumberFormat getFormat(Locale locale) {
-                return bigDecimalFmt;
-            };
-        });
+        converterMap.put(BigDecimal.class,
+                new StringToBigDecimalConverter("Error converting value") {
+                    @Override
+                    protected NumberFormat getFormat(Locale locale) {
+                        return bigDecimalFmt;
+                    };
+                });
 
         // strings do nothing
         converterMap.put(String.class, new Converter<String, String>() {