public interface JsonBuilderFactory
JsonObjectBuilder
and JsonArrayBuilder
instances. If a factory instance is configured with some configuration,
that would be used to configure the created builder instances.
JsonObjectBuilder
and JsonArrayBuilder
can also be created
using Json
's methods. If multiple builder instances are created,
then creating them using a builder factory is preferred.
For example:
JsonBuilderFactory factory = Json.createBuilderFactory(...);
JsonArray value = factory.createArrayBuilder()
.add(factory.createObjectBuilder()
.add("type", "home")
.add("number", "212 555-1234"))
.add(factory.createObjectBuilder()
.add("type", "fax")
.add("number", "646 555-4567"))
.build();
All the methods in this class are safe for use by multiple concurrent threads.
Modifier and Type | Method and Description |
---|---|
JsonArrayBuilder |
createArrayBuilder()
Creates a
JsonArrayBuilder instance that is used to build
JsonArray |
default JsonArrayBuilder |
createArrayBuilder(java.util.Collection<?> collection)
Creates a
JsonArrayBuilder instance,
initialized with the content of specified collection. |
default JsonArrayBuilder |
createArrayBuilder(JsonArray array)
Creates a
JsonArrayBuilder instance, initialized with an array. |
JsonObjectBuilder |
createObjectBuilder()
Creates a
JsonObjectBuilder instance that is used to build
JsonObject . |
default JsonObjectBuilder |
createObjectBuilder(JsonObject object)
Creates a
JsonObjectBuilder instance, initialized with an object. |
default JsonObjectBuilder |
createObjectBuilder(java.util.Map<java.lang.String,java.lang.Object> object)
Creates a
JsonObjectBuilder instance, initialized with the specified object. |
java.util.Map<java.lang.String,?> |
getConfigInUse()
Returns read-only map of supported provider specific configuration
properties that are used to configure the created JSON builders.
|
JsonObjectBuilder createObjectBuilder()
JsonObjectBuilder
instance that is used to build
JsonObject
.default JsonObjectBuilder createObjectBuilder(JsonObject object)
JsonObjectBuilder
instance, initialized with an object.object
- the initial object in the builderjava.lang.NullPointerException
- if specified object is null
default JsonObjectBuilder createObjectBuilder(java.util.Map<java.lang.String,java.lang.Object> object)
JsonObjectBuilder
instance, initialized with the specified object.object
- the initial object in the builderjava.lang.NullPointerException
- if specified object is null
JsonArrayBuilder createArrayBuilder()
JsonArrayBuilder
instance that is used to build
JsonArray
default JsonArrayBuilder createArrayBuilder(JsonArray array)
JsonArrayBuilder
instance, initialized with an array.array
- the initial array in the builderjava.lang.NullPointerException
- if specified array is null
default JsonArrayBuilder createArrayBuilder(java.util.Collection<?> collection)
JsonArrayBuilder
instance,
initialized with the content of specified collection.collection
- the initial data for the builderjava.lang.NullPointerException
- if specified collection is null
java.util.Map<java.lang.String,?> getConfigInUse()