introduce null-save JsonObjectBuilder.add and JsonGenerator.write methods #213

Signed-off-by: Jorge Bescos Gascon <jorge.bescos.gascon@oracle.com>

Author: jbescos

api/src/main/java/jakarta/json/JsonConfig.java

@@ -23,6 +23,12 @@
  */
 public final class JsonConfig {
 
+    /**
+     * Configuration property to ignore null values. All providers
+     * must support this property. The value of the property is boolean.
+     */
+    public static final String IGNORE_NULL = "jakarta.json.JsonConfig.ignoreNull";
+
     /**
      * Configuration property to define the strategy for handling duplicate keys.
      *

api/src/main/java/jakarta/json/JsonObjectBuilder.java

@@ -86,8 +86,9 @@
  * </code>
  * </pre>
  *
- * <p>This class does <em>not</em> allow <code>null</code> to be used as a name or
- * value while building the JSON object
+ * <p>By default, this class does <em>not</em> allow <code>null</code> to be used as a name or
+ * value while building the JSON object. It is possible to change this behavior with configuration
+ * {@link JsonConfig#IGNORE_NULL}
  *
  * @see JsonArrayBuilder
  */