public interface JsonWriter extends 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()
Closes this JSON writer and frees any resources associated with the
writer.
|
void |
write(JsonStructure value)
|
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)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)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)IllegalStateException
- if writeArray, writeObject, write
or close method is already calledvoid close()
close
in interface AutoCloseable
close
in interface Closeable
JsonException
- if an i/o error occurs (IOException would be
cause of JsonException)Copyright © 1996-2013, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.