#22 - Add Builder for JsonStream

Author: rbygrave

jsonb/src/main/java/io/avaje/jsonb/stream/JsonStream.java

@@ -12,6 +12,47 @@
  */
 public final class JsonStream implements JsonStreamAdapter {
 
+  /**
+   * Used to build JsonStream with custom settings.
+   */
+  public static final class Builder {
+
+    private boolean serializeNulls;
+    private boolean serializeEmpty;
+    private boolean failOnUnknown;
+
+    /**
+     * Set to true to serialize nulls. Defaults to false.
+     */
+    public Builder serializeNulls(boolean serializeNulls) {
+      this.serializeNulls = serializeNulls;
+      return this;
+    }
+
+    /**
+     * Set to true to serialize empty collections. Defaults to false.
+     */
+    public Builder serializeEmpty(boolean serializeEmpty) {
+      this.serializeEmpty = serializeEmpty;
+      return this;
+    }
+
+    /**
+     * Set to true to fail on unknown properties. Defaults to false.
+     */
+    public Builder failOnUnknown(boolean failOnUnknown) {
+      this.failOnUnknown = failOnUnknown;
+      return this;
+    }
+
+    /**
+     * Build and return the JsonStream.
+     */
+    public JsonStream build() {
+      return new JsonStream(serializeNulls, serializeEmpty, failOnUnknown);
+    }
+  }
+
   private final boolean serializeNulls;
   private final boolean serializeEmpty;
   private final boolean failOnUnknown;
@@ -32,6 +73,21 @@ public JsonStream(boolean serializeNulls, boolean serializeEmpty, boolean failOn
     this.failOnUnknown = failOnUnknown;
   }
 
+  /**
+   * Return a new builder to create a JsonStream with custom configuration.
+   *
+   * <pre>{@code
+   *
+   * var jsonStream = JsonStream.newBuilder()
+   *   .serializeNulls(true)
+   *   .build();
+   *
+   * }</pre>
+   */
+  public static Builder newBuilder() {
+    return new Builder();
+  }
+
   @Override
   public PropertyNames properties(String... names) {
     return JsonNames.of(names);

jsonb/src/test/java/io/avaje/jsonb/stream/DieselAdapterTest.java

@@ -13,7 +13,7 @@
 
 class DieselAdapterTest {
 
-  final JsonStream adapter = new JsonStream(true, true, false);
+  final JsonStream adapter = JsonStream.newBuilder().serializeNulls(true).serializeEmpty(true).failOnUnknown(false).build();
 
   @Test
   void readArray() {

jsonb/src/test/java/io/avaje/jsonb/stream/JsonReadAdapterTest.java

@@ -67,7 +67,7 @@ private void readExampleWithAsserts(JsonReader reader) {
   void bigInt() {
     String input = "{\"name\":\"roberto\", \"val0\": 123, \"val1\": \"1234567890123456789\", \"val2\": 1234567890123456789 , \"notes\" :\"end\"}";
 
-    JsonStream adapter = new JsonStream(false, false, false);
+    JsonStream adapter = JsonStream.newBuilder().failOnUnknown(true).build();
     try (JsonReader reader = adapter.reader(input)) {
       reader.beginObject();
       assertTrue(reader.hasNextField());