com.sun.msv.reader
Class State
- ContentHandler
public abstract class State
implements ContentHandler
base interface of 'parsing state'.
parsing of XML representation of a grammar is done by
using various states.
Each State-derived class is responsible for a particular type of
declaration of the grammar. For example, SequenceState is responsible
for parsing <sequence> element of RELAX module.
State objects interact each other. There are two ways of interaction.
- from parent to child
- from child to parent
The first type of communication occurs only when a child state object is
created. The last type of communication occurs usually (but not limited to)
when a child state sees its end tag.
In this level of inheritance, contract is somewhat abstract.
- When a State object is created, its init method is called
and various information is set. Particularly, start tag
information (if any) and the parent state is set.
This process should only be initiated by GrammarReader.
- After that, startSelf method is called. Usually,
this is the place to do something useful.
- State object is registered as a ContentHandler, and
therefore will receive SAX events from now on.
- Derived classes are expected to do something useful
by receiving SAX events.
- When a State object finishes its own part, it should
call GrammarReader.popState method. It will remove
the current State object and registers the parent state
as a ContentHandler again.
Of course some derived classes introduce more restricted
contract. See
SimpleState
.
this class also provides:
- access to the parent state
- default implementations for all ContentHandler callbacks
except startElement and endElement
reader
public GrammarReader reader
reader object who is the owner of this object.
This information is avaiable after init method is called.
_assert
public static void _assert(boolean b)
characters
public void characters(char[] buffer,
int from,
int len)
throws SAXException
endPrefixMapping
public void endPrefixMapping(String prefix)
throws SAXException
getBaseURI
public String getBaseURI()
getLocation
public Locator getLocation()
getParentState
public final State getParentState()
ignorableWhitespace
public void ignorableWhitespace(char[] buffer,
int from,
int len)
throws SAXException
processingInstruction
public void processingInstruction(String target,
String data)
throws SAXException
setDocumentLocator
public void setDocumentLocator(Locator loc)
skippedEntity
public void skippedEntity(String name)
throws SAXException
startDocument
public final void startDocument()
throws SAXException
startPrefixMapping
public void startPrefixMapping(String prefix,
String uri)
throws SAXException