net.axyana.qizxopen.dm
Class XMLEventHandlerBase

java.lang.Object
  net.axyana.qizxopen.dm.XMLEventHandlerBase

All Implemented Interfaces:

XMLEventHandler

Direct Known Subclasses:

CoreEventBuilder, DOMEventBuilder, SAXEventHandler, XMLSerializer, XQCoreEventBuilder

public abstract class XMLEventHandlerBase

extends java.lang.Object

implements XMLEventHandler

An abstract handler of SAX-like events.

Manages namespaces. Used as a base for serialization and SAX output.

Constructor Summary

XMLEventHandlerBase()

Method Summary

void	abort() Signals an error in the event flow.
void	definePrefixHints(NSPrefixMapping prefixes) Optional: defines a preferred prefix/namespace mapping for serialization.
void	evAtom(java.lang.Object value) A special atom with any value (serializable).
void	evAtomText(java.lang.String value) Text of an atom.
void	evAttribute(QName name, java.lang.String value) Adds an attribute on the current element.
void	evDocumentEnd() Ends a document.
boolean	evDocumentStart() Starts a document.
void	evDTD(java.lang.String name, java.lang.String publicID, java.lang.String systemID) DTD definition.
void	evElementEnd(QName name) Ends an element.
void	evElementStart(QName name) Starts an element.
void	evNamespace(java.lang.String prefix, java.lang.String uri) Adds a namespace node on the current element.
boolean	maxVolumeReached()
void	noSpace() Indicates when evAtomText() must not insert space.
void	reset() Resets the state prior to use startDocument() or startElement().
java.lang.String	resolvePrefix(java.lang.String prefix) Resolves a prefix to an URI in the context of the current node.
void	setMaxVolume(int volume)
void	setTrace(boolean value)
void	terminate() Terminates a document or simple subtree.
void	traverse(int flags, FONIDocument dm, int nodeId) Convenience method: traverses and generates a FONI document using this receiver.
void	traverse(int flags, Node node) Traverse and generate a subtree.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.axyana.qizxopen.dm.XMLEventHandler

evComment, evPI, evText

Constructor Detail

XMLEventHandlerBase

public XMLEventHandlerBase()

Method Detail

definePrefixHints

public void definePrefixHints(NSPrefixMapping prefixes)

Description copied from interface: XMLEventHandler

Optional: defines a preferred prefix/namespace mapping for serialization. This table is used when no mapping is in scope in the current context.

Specified by:

definePrefixHints in interface XMLEventHandler

setTrace

public void setTrace(boolean value)

setMaxVolume

public void setMaxVolume(int volume)

maxVolumeReached

public boolean maxVolumeReached()

reset

public void reset()

Description copied from interface: XMLEventHandler

Resets the state prior to use startDocument() or startElement().

The general contract is to put the handler in a clean state before event generation, for example clearing the previously built tree in a DOMBuilder.

Specified by:

reset in interface XMLEventHandler

terminate

public void terminate()
               throws DataModelException

Description copied from interface: XMLEventHandler

Terminates a document or simple subtree. May perform consistency checks.

Specified by:

terminate in interface XMLEventHandler

Throws:

DataModelException

abort

public void abort()
           throws DataModelException

Description copied from interface: XMLEventHandler

Signals an error in the event flow.

Specified by:

abort in interface XMLEventHandler

Throws:

DataModelException

evDocumentStart

public boolean evDocumentStart()
                        throws DataModelException

Description copied from interface: XMLEventHandler

Starts a document.

Not called when only a fragment is generated.

Specified by:

evDocumentStart in interface XMLEventHandler

Returns:

true if not inside another node (in which case it should be discarded)

Throws:

DataModelException

evDocumentEnd

public void evDocumentEnd()
                   throws DataModelException

Description copied from interface: XMLEventHandler

Ends a document. Must be balanced by a matching startDocument().

Specified by:

evDocumentEnd in interface XMLEventHandler

Throws:

DataModelException

evElementStart

public void evElementStart(QName name)
                    throws DataModelException

Description copied from interface: XMLEventHandler

Starts an element. Must be balanced by a matching endElement().

Specified by:

evElementStart in interface XMLEventHandler

Throws:

DataModelException

evNamespace

public void evNamespace(java.lang.String prefix,
                        java.lang.String uri)
                 throws DataModelException

Description copied from interface: XMLEventHandler

Adds a namespace node on the current element. Must follow startElement and precede any child. May be interleaved with attribute().

Specified by:

evNamespace in interface XMLEventHandler

Throws:

DataModelException

evAttribute

public void evAttribute(QName name,
                        java.lang.String value)
                 throws DataModelException

Description copied from interface: XMLEventHandler

Adds an attribute on the current element. Must follow startElement and precede any child. May be interleaved with namespace(). Supposed to throw an exception if attribute is duplicated.

Specified by:

evAttribute in interface XMLEventHandler

Throws:

DataModelException

evElementEnd

public void evElementEnd(QName name)
                  throws DataModelException

Description copied from interface: XMLEventHandler

Ends an element. Discards prefix/namespace mappings possibly defined by the element.

Specified by:

evElementEnd in interface XMLEventHandler

Throws:

DataModelException

resolvePrefix

public java.lang.String resolvePrefix(java.lang.String prefix)

Description copied from interface: XMLEventHandler

Resolves a prefix to an URI in the context of the current node.

Specified by:

resolvePrefix in interface XMLEventHandler

Returns:

null if the prefix cannot be resolved.

evDTD

public void evDTD(java.lang.String name,
                  java.lang.String publicID,
                  java.lang.String systemID)
           throws DataModelException

Description copied from interface: XMLEventHandler

DTD definition.

Specified by:

evDTD in interface XMLEventHandler

Throws:

DataModelException

evAtom

public void evAtom(java.lang.Object value)
            throws DataModelException

Description copied from interface: XMLEventHandler

A special atom with any value (serializable).

Specified by:

evAtom in interface XMLEventHandler

Throws:

DataModelException

evAtomText

public void evAtomText(java.lang.String value)
                throws DataModelException

Description copied from interface: XMLEventHandler

Text of an atom. The difference with text() is that a space in requested between two atoms. Hence the argument 'first'.

Specified by:

evAtomText in interface XMLEventHandler

Throws:

DataModelException

noSpace

public void noSpace()

Description copied from interface: XMLEventHandler

Indicates when evAtomText() must not insert space.

Specified by:

noSpace in interface XMLEventHandler

traverse

public void traverse(int flags,
                     Node node)
              throws DataModelException

Traverse and generate a subtree.

Specified by:

traverse in interface XMLEventHandler

Parameters:

flags - a combination of flags of StaticContext if true, copy all in-scope namespace nodes (not only those defined on the node itself). A false value is generally used.

Throws:

DataModelException

traverse

public void traverse(int flags,
                     FONIDocument dm,
                     int nodeId)
              throws DataModelException

Description copied from interface: XMLEventHandler

Convenience method: traverses and generates a FONI document using this receiver.

Specified by:

traverse in interface XMLEventHandler

Throws:

DataModelException