introduce null-save JsonObjectBuilder.add and JsonGenerator.write met…

…hods jakartaee#213 Signed-off-by: Jorge Bescos Gascon <[email protected]>
jbescos · Oct 4, 2021 · d9df212 · d9df212
1 parent d166d5d
commit d9df212
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 2 deletions.
diff --git a/api/src/main/java/jakarta/json/JsonBuilderFactory.java b/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}.

diff --git a/api/src/main/java/jakarta/json/JsonObjectBuilder.java b/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
  */