JSONWriter provides a quick and convenient way of producing JSON text. The texts produced strictly conform to JSON syntax rules. No whitespace is added, so the results are ready for transmission or storage. Each instance of JSONWriter can produce one JSON text.
A JSONWriter instance provides a
value
method for appending values to the text, and a
key
method for adding keys before values in objects. There are
array
and
endArray
methods that make and bound array values, and
object
and
endObject
methods which make and bound object values. All of these methods return the JSONWriter instance, permitting a cascade style. For example,
new JSONWriter(myWriter).object().key("JSON").value("Hello, World!").endObject();
which writes
{"JSON":"Hello, World!"}
The first method called must be
array
or
object
. There are no methods for adding commas or colons. JSONWriter adds them for you. Objects and arrays can be nested up to 20 levels deep.
This can sometimes be easier than using a JSONObject to build a string.
@author JSON.org
@version 2