jsimple.json.readerwriter

Class JsonArrayWriter

java.lang.Object

jsimple.lang.AutoCloseable

jsimple.json.readerwriter.JsonArrayWriter

All Implemented Interfaces:

java.lang.AutoCloseable

public class JsonArrayWriter
extends AutoCloseable

JsonArrayWriter lets the caller serialize the items in an array one by one, iterating through them & serializing each in turn. If the array is big--often true when it's the outermost object in a JSON text--then this method is more memory efficient than creating JSON objects for the entire array in memory at once.

The array is also formatted a little differently when serialized this way, optimized for a large array that's at the outermost level in a file. Here each value in the array is on a separate line, preceded by a blank line to make the individual values a bit easier to grep. The normal array serializer will sometimes put values all on one line in certain simple cases, but that never happens here.

Since:

7/29/12 3:08 PM

Constructor Summary

Constructors

Constructor and Description
JsonArrayWriter(Serializer serializer)
JsonArrayWriter(Serializer serializer, boolean flushWhenDone)

Method Summary

Modifier and Type	Method and Description
void	close() Finish the serialization, outputting the closing bracket and returning the resulting string.
boolean	isSingleLine()
void	setSingleLine(boolean singleLine)
JsonArrayWriter	writeArray()
JsonObjectWriter	writeObject()
void	writeValue(java.lang.Object value) Add a value to the array, serializing it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JsonArrayWriter

public JsonArrayWriter(Serializer serializer)

JsonArrayWriter

public JsonArrayWriter(Serializer serializer,
                       boolean flushWhenDone)

Method Detail

isSingleLine

public boolean isSingleLine()

setSingleLine

public void setSingleLine(boolean singleLine)

writeValue

public void writeValue(java.lang.Object value)

Add a value to the array, serializing it. value can be any valid JSON value class (JsonObject, JsonArray, String, Integer, Long, Boolean, or JsonNull).

Parameters:

value - JSON value for array item

writeObject

public JsonObjectWriter writeObject()

writeArray

public JsonArrayWriter writeArray()

close

public void close()

Finish the serialization, outputting the closing bracket and returning the resulting string.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class AutoCloseable