General entities are reported with their regular names, parameter entities have '%' prepended to their names, and the external DTD subset has the pseudo-entity name "[dtd]".
When a SAX2 driver is providing these events, all other events must be properly nested within start/end entity events. There is no additional requirement that events from {@link org.xml.sax.ext.DeclHandler DeclHandler} or{@link org.xml.sax.DTDHandler DTDHandler} be properly ordered.
Note that skipped entities will be reported through the {@link org.xml.sax.ContentHandler#skippedEntity skippedEntity}event, which is part of the ContentHandler interface.
Because of the streaming event model that SAX uses, some entity boundaries cannot be reported under any circumstances:
These will be silently expanded, with no indication of where the original entity boundaries were.
Note also that the boundaries of character references (which are not really entities anyway) are not reported.
All start/endEntity events must be properly nested. @param name The name of the entity. If it is a parameterentity, the name will begin with '%', and if it is the external DTD subset, it will be "[dtd]". @exception SAXException The application may raise an exception. @see #endEntity @see org.xml.sax.ext.DeclHandler#internalEntityDecl @see org.xml.sax.ext.DeclHandler#externalEntityDecl
|
|
|
|
|
|
|
|
|
|
|
|
|
|