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/JsonBuilderFactory.java

@@ -50,6 +50,12 @@
  */
 public interface JsonBuilderFactory {
 
+    /**
+     * Configuration property to ignore null values. All providers
+     * must support this property. The value of the property is boolean.
+     */
+    public static final String IGNORE_ADDING_IF_NULL = "jakarta.json.JsonBuilderFactory.ignoreAddingIfNull";
+
     /**
      * Creates a {@code JsonObjectBuilder} instance that is used to build
      * {@link JsonObject}.

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 JsonBuilderFactory#IGNORE_ADDING_IF_NULL}
  *
  * @see JsonArrayBuilder
  */