XMLEvent Types

<< Iterator Event Types | Sample Event Mapping >>

TREAMING

API

FOR

XML

Note that the

DTD

EntityDeclaration

EntityReference

NotationDeclara-

tion

, and

ProcessingInstruction

events are only created if the document

being processed contains a DTD.

Characters

Corresponds to XML

CData sections and CharacterData entities.

Note that ignorable whitespace and significant whitespace are also
reported as

Character events.

EntityRef-
erence

Character entities can be reported as discrete events, which an applica-
tion developer can then choose to resolve or pass through unresolved.
By default, entities are resolved. Alternatively, if you do not want to
report the entity as an event, replacement text can be substituted and
reported as

Characters.

Processin-
gInstruc-
tion

Reports the target and data for an underlying processing instruction.

Comment

Returns the text of a comment

EndDocument

Reports the end of a set of XML events.

DTD

Reports as

java.lang.String information about the DTD, if any,

associated with the stream, and provides a method for returning custom
objects found in the DTD.

Attribute

Attributes are generally reported as part of a

StartElement event.

However, there are times when it is desirable to return an attribute as a
standalone

Attribute event; for example, when a namespace is

returned as the result of an

XQuery or XPath expression.

Namespace

As with attributes, namespaces are usually reported as part of a
StartElement, but there are times when it is desirable to report a
namespace as a discrete

Namespace event.

Table 42

XMLEvent

Types (Continued)

Event Type

Description