uk.ac.ed.epcc.webapp.content

Class JsonBuilder

java.lang.Object

uk.ac.ed.epcc.webapp.content.JsonBuilder

All Implemented Interfaces:

SimpleXMLBuilder

public class JsonBuilder
extends java.lang.Object
implements SimpleXMLBuilder

An implementation of SimpleXMLBuilder that builds an equivalent JSON document. This version has no external dependencies so has to do its own escaping etc. A reconfigurable factory method is provided so that alternate implementations can be included in projects that use a 3rd party JSON library.

Constructor Summary

Constructors

Modifier	Constructor and Description
	JsonBuilder()
protected	JsonBuilder(JsonBuilder parent)

Method Summary

Modifier and Type	Method and Description
SimpleXMLBuilder	appendParent() Append the contents of this builder to the parent (if any).
SimpleXMLBuilder	attr(java.lang.String name, java.lang.CharSequence s) Add an attribute.
SimpleXMLBuilder	clean(char c)
SimpleXMLBuilder	clean(java.lang.CharSequence s) append text to the document escaping any characters that might be interpreted as XML markup.
SimpleXMLBuilder	clean(java.lang.Number i) Append text representation of the number
SimpleXMLBuilder	close() close the last opened tag.
static SimpleXMLBuilder	getJsonBuilder(AppContext conn) static factory method to allow implementations to be replaced.
SimpleXMLBuilder	getNested() Get a new SimpleXMLBuilder of the same type as this object.
SimpleXMLBuilder	getParent() Get the parent object.
SimpleXMLBuilder	open(java.lang.String tag) open a tag
SimpleXMLBuilder	open(java.lang.String tag, java.lang.String[][] a) open a tag with attributes.
protected void	prefix()
boolean	setEscapeUnicode(boolean escape_unicode) Should high code-point unicode characters be escaped to avoid charset problems.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface uk.ac.ed.epcc.webapp.content.SimpleXMLBuilder

addObject, attr

Constructor Detail

JsonBuilder

public JsonBuilder()

JsonBuilder

protected JsonBuilder(JsonBuilder parent)

Method Detail

getJsonBuilder

public static SimpleXMLBuilder getJsonBuilder(AppContext conn)

static factory method to allow implementations to be replaced.

Parameters:

conn -

Returns:

getNested

public SimpleXMLBuilder getNested()
                           throws java.lang.UnsupportedOperationException

Description copied from interface: SimpleXMLBuilder

Get a new SimpleXMLBuilder of the same type as this object. This is to build un-commited content that is appended to this object using the SimpleXMLBuilder.appendParent() method. The calling code need only hold a reference to the current builder as the SimpleXMLBuilder.appendParent() method returns the parent.

Specified by:

getNested in interface SimpleXMLBuilder

Returns:

SimpleXMLBuilder

Throws:

java.lang.UnsupportedOperationException

appendParent

public SimpleXMLBuilder appendParent()
                              throws java.lang.UnsupportedOperationException

Description copied from interface: SimpleXMLBuilder

Append the contents of this builder to the parent (if any).

Specified by:

appendParent in interface SimpleXMLBuilder

Returns:

the parent

Throws:

java.lang.UnsupportedOperationException

getParent

public SimpleXMLBuilder getParent()

Description copied from interface: SimpleXMLBuilder

Get the parent object.

Specified by:

getParent in interface SimpleXMLBuilder

Returns:

parent

clean

public SimpleXMLBuilder clean(java.lang.CharSequence s)

Description copied from interface: SimpleXMLBuilder

append text to the document escaping any characters that might be interpreted as XML markup.

Specified by:

clean in interface SimpleXMLBuilder

Returns:

reference to self.

clean

public SimpleXMLBuilder clean(char c)

Specified by:

clean in interface SimpleXMLBuilder

clean

public SimpleXMLBuilder clean(java.lang.Number i)

Description copied from interface: SimpleXMLBuilder

Append text representation of the number

Specified by:

clean in interface SimpleXMLBuilder

Parameters:

i - Number to format

Returns:

reference to self

open

public SimpleXMLBuilder open(java.lang.String tag)

Description copied from interface: SimpleXMLBuilder

open a tag

Specified by:

open in interface SimpleXMLBuilder

Returns:

reference to self

prefix

protected void prefix()

open

public SimpleXMLBuilder open(java.lang.String tag,
                             java.lang.String[][] a)

Description copied from interface: SimpleXMLBuilder

open a tag with attributes. attribute values are escaped

Specified by:

open in interface SimpleXMLBuilder

Parameters:

tag - tag to open

a - array of name,value pairs

Returns:

reference to self

attr

public SimpleXMLBuilder attr(java.lang.String name,
                             java.lang.CharSequence s)

Description copied from interface: SimpleXMLBuilder

Add an attribute. It is only legal to call this after a call to open and before close or clean.

Specified by:

attr in interface SimpleXMLBuilder

Parameters:

name - String attribute name

s - CharSequence attribute value or null for no value

Returns:

reference to self

close

public SimpleXMLBuilder close()

Description copied from interface: SimpleXMLBuilder

close the last opened tag.

Specified by:

close in interface SimpleXMLBuilder

Returns:

reference to self

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

setEscapeUnicode

public boolean setEscapeUnicode(boolean escape_unicode)

Description copied from interface: SimpleXMLBuilder

Should high code-point unicode characters be escaped to avoid charset problems. This is advisory only the implementation is free to ignore this call and return false in all cases.

Specified by:

setEscapeUnicode in interface SimpleXMLBuilder

Returns:

previous setting.