org.apache.tapestry.json
Class XMLTokener

java.lang.Object
  org.apache.tapestry.json.JSONTokener
      org.apache.tapestry.json.XMLTokener

public class XMLTokener
extends JSONTokener

The XMLTokener extends the JSONTokener to provide additional methods for the parsing of XML texts.

Version:

0.1

Author:

JSON.org

Field Summary

static HashMap

entity The table of entity values.

Constructor Summary

XMLTokener(String s)
Construct an XMLTokener from a string.

Method Summary

Object	nextContent() Get the next XML outer token, trimming whitespace.
Object	nextEntity(char a) Return the next entity.
Object	nextMeta() Returns the next XML meta token.
Object	nextToken() Get the next XML Token.

Methods inherited from class org.apache.tapestry.json.JSONTokener

back, dehexchar, more, next, next, next, nextClean, nextString, nextTo, nextTo, nextValue, skipPast, skipTo, syntaxError, toString, unescape

Methods inherited from class java.lang.Object

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

Field Detail

entity

public static final HashMap entity

The table of entity values. It initially contains Character values for amp, apos, gt, lt, quot.

Constructor Detail

XMLTokener

public XMLTokener(String s)

Construct an XMLTokener from a string.

Parameters:

s - A source string.

Method Detail

nextContent

public Object nextContent()
                   throws ParseException

Get the next XML outer token, trimming whitespace. There are two kinds of tokens: the '<' character which begins a markup tag, and the content text between markup tags.

Returns:

A string, or a '<' Character, or null if there is no more source text.

Throws:

ParseException

nextEntity

public Object nextEntity(char a)
                  throws ParseException

Return the next entity. These entities are translated to Characters: & ' > < "

Parameters:

a - An ampersand character.

Returns:

A Character or an entity String if the entity is not recognized.

Throws:

ParseException - Missing ';' in XML entity

nextMeta

public Object nextMeta()
                throws ParseException

Returns the next XML meta token. This is used for skipping over and structures.

Returns:

Syntax characters (< > / = ! ?) are returned as Character, and strings and names are returned as Boolean. We don't care what the values actually are.

Throws:

ParseException

nextToken

public Object nextToken()
                 throws ParseException

Get the next XML Token. These tokens are found inside of angle brackets. It may be one of these characters: / > = ! ? or it may be a string wrapped in single quotes or double quotes, or it may be a name.

Returns:

a String or a Character.

Throws:

ParseException