Merge branch '2.15' into 2.16

Author: cowtowncoder

src/main/java/com/fasterxml/jackson/core/base/GeneratorBase.java

@@ -1,16 +1,16 @@
 package com.fasterxml.jackson.core.base;
 
+import java.io.IOException;
+import java.io.InputStream;
+import java.math.BigDecimal;
+
 import com.fasterxml.jackson.core.*;
 import com.fasterxml.jackson.core.io.IOContext;
 import com.fasterxml.jackson.core.json.DupDetector;
 import com.fasterxml.jackson.core.json.JsonWriteContext;
 import com.fasterxml.jackson.core.json.PackageVersion;
 import com.fasterxml.jackson.core.util.DefaultPrettyPrinter;
 
-import java.io.IOException;
-import java.io.InputStream;
-import java.math.BigDecimal;
-
 /**
  * This base class implements part of API that a JSON generator exposes
  * to applications, adds shared internal methods that sub-classes

src/main/java/com/fasterxml/jackson/core/io/BigDecimalParser.java

@@ -12,12 +12,20 @@
 // https://github.com/eobermuhlner/big-math/commit/7a5419aac8b2adba2aa700ccf00197f97b2ad89f
 
 /**
- * Helper class used to implement more optimized parsing of {@link BigDecimal} for REALLY
- * big values (over 500 characters)
+ * Internal Jackson Helper class used to implement more optimized parsing of {@link BigDecimal} for REALLY
+ * big values (over 500 characters).
+ *<p>
+ * This class is not meant to be used directly. It is designed to be used by Jackson JSON parsers (and parsers
+ * for other Jackson supported data formats). The parsers check for invalid characters and the length of the number.
+ * Without these checks, this parser is susceptible to performing badly with invalid inputs. If you need to parse
+ * numbers directly, please use JavaBigDecimalParser in <a href="https://github.com/wrandelshofer/FastDoubleParser">fastdoubleparser</a>
+ * instead.
+ *</p>
  *<p>
  * Based on ideas from this
  * <a href="https://github.com/eobermuhlner/big-math/commit/7a5419aac8b2adba2aa700ccf00197f97b2ad89f">this
  * git commit</a>.
+ *</p>
  *
  * @since 2.13
  */
@@ -27,10 +35,23 @@ public final class BigDecimalParser
 
     private BigDecimalParser() {}
 
+    /**
+     * Internal Jackson method. Please do not use.
+     *
+     * @param valueStr
+     * @return BigDecimal value
+     * @throws NumberFormatException
+     */
     public static BigDecimal parse(String valueStr) {
         return parse(valueStr.toCharArray());
     }
 
+    /**
+     * Internal Jackson method. Please do not use.
+     *
+     * @return BigDecimal value
+     * @throws NumberFormatException
+     */
     public static BigDecimal parse(final char[] chars, final int off, final int len) {
         try {
             if (len < 500) {
@@ -58,6 +79,13 @@ public static BigDecimal parse(final char[] chars, final int off, final int len)
         }
     }
 
+    /**
+     * Internal Jackson method. Please do not use.
+     *
+     * @param chars
+     * @return BigDecimal value
+     * @throws NumberFormatException
+     */
     public static BigDecimal parse(char[] chars) {
         return parse(chars, 0, chars.length);
     }