provide NaN and Infinity when (de)serializing Java Numbers

Signed-off-by: Jorge Bescos Gascon <[email protected]>

Author: jbescos

api/src/main/java/jakarta/json/stream/JsonGenerator.java

@@ -145,6 +145,20 @@ public interface JsonGenerator extends Flushable, /*Auto*/Closeable {
      */
     String PRETTY_PRINTING = "jakarta.json.stream.JsonGenerator.prettyPrinting" ;
 
+    /**
+     * Configuration property to generate NaN, +Infinity and -Infinity as nulls.
+     *
+     * @since 2.1
+     */
+    String WRITE_NAN_AS_NULLS = "jakarta.json.stream.JsonGenerator.writeNanAsNulls";
+
+    /**
+     * Configuration property to generate NaN, +Infinity and -Infinity as Strings.
+     *
+     * @since 2.1
+     */
+    String WRITE_NAN_AS_STRINGS = "jakarta.json.stream.JsonGenerator.writeNanAsStrings";
+
     /**
      * Writes the JSON start object character. It starts a new child object
      * context within which JSON name/value pairs can be written to the object.
@@ -336,9 +350,14 @@ public interface JsonGenerator extends Flushable, /*Auto*/Closeable {
      * @return this generator
      * @throws jakarta.json.JsonException if an i/o error occurs (IOException
      * would be cause of JsonException)
-     * @throws NumberFormatException if the value is Not-a-Number (NaN) or infinity.
+     * @throws NumberFormatException if the value is Not-a-Number (NaN) or infinity
+     * when {@link JsonGenerator#WRITE_NAN_AS_NULLS} and/or {@link JsonGenerator#WRITE_NAN_AS_STRINGS}
+     * is not set.
+     *
      * @throws JsonGenerationException if this method is not called within an
      *      object context
+     *
+     * @see {@link JsonGenerator#WRITE_NAN_AS_NULLS}, {@link JsonGenerator#WRITE_NAN_AS_STRINGS}
      */
     JsonGenerator write(String name, double value);
 
@@ -485,7 +504,11 @@ public interface JsonGenerator extends Flushable, /*Auto*/Closeable {
      * would be cause of JsonException)
      * @throws JsonGenerationException if this method is not called within an
      *      array or root context.
-     * @throws NumberFormatException if the value is Not-a-Number (NaN) or infinity.
+     * @throws NumberFormatException if the value is Not-a-Number (NaN) or infinity
+     * when {@link JsonGenerator#WRITE_NAN_AS_NULLS} and/or {@link JsonGenerator#WRITE_NAN_AS_STRINGS}
+     * is not set.
+     *
+     * @see {@link JsonGenerator#WRITE_NAN_AS_NULLS}, {@link JsonGenerator#WRITE_NAN_AS_STRINGS}
      */
     JsonGenerator write(double value);