public interface JsonWriter
extends java.io.Closeable
object
or array
structure
to an output source.
The class Json
contains methods to create writers from
output sources (OutputStream
and Writer
).
The following example demonstrates how write an empty JSON object:
JsonWriter jsonWriter = Json.createWriter(...);
jsonWriter.writeObject(Json.createObjectBuilder().build());
jsonWriter.close();
The class JsonWriterFactory
also contains methods to create
JsonWriter
instances. A factory instance can be used to create
multiple writer instances with the same configuration. This the preferred
way to create multiple instances. A sample usage is shown in the following
example:
JsonWriterFactory factory = Json.createWriterFactory(config);
JsonWriter writer1 = factory.createWriter(...);
JsonWriter writer2 = factory.createWriter(...);
Modifier and Type | Method and Description |
---|---|
void |
close() |
void |
write(JsonStructure value)
|
default void |
write(JsonValue value)
Writes the specified
JsonValue to the output source. |
void |
writeArray(JsonArray array)
Writes the specified JSON
array to the output
source. |
void |
writeObject(JsonObject object)
Writes the specified JSON
object to the output
source. |
void writeArray(JsonArray array)
array
to the output
source. This method needs to be called only once for a writer instance.array
- JSON array that is to be written to the output sourceJsonException
- if the specified JSON object cannot be
written due to i/o error (IOException would be cause of
JsonException)java.lang.IllegalStateException
- if writeArray, writeObject, write or close
method is already calledvoid writeObject(JsonObject object)
object
to the output
source. This method needs to be called only once for a writer instance.object
- JSON object that is to be written to the output sourceJsonException
- if the specified JSON object cannot be
written due to i/o error (IOException would be cause of JsonException)java.lang.IllegalStateException
- if writeArray, writeObject, write or close
method is already calledvoid write(JsonStructure value)
object
or
array
to the output source. This method needs
to be called only once for a writer instance.value
- JSON array or object that is to be written to the output
sourceJsonException
- if the specified JSON object cannot be
written due to i/o error (IOException would be cause of
JsonException)java.lang.IllegalStateException
- if writeArray, writeObject, write
or close method is already calleddefault void write(JsonValue value)
JsonValue
to the output source.
method needs to be called only once for a write instance.value
- a JsonValue
to be written to the output
sourceJsonException
- if the specified JSON object cannot be
written due to i/o error (IOException would be cause of
JsonException)java.lang.IllegalStateException
- if writeArray, writeObject, write
or close method is already calledvoid close()
close
in interface java.lang.AutoCloseable
close
in interface java.io.Closeable