de.larssh.utils.xml

Class XmlReadingFeatures.Xerces.XInclude

java.lang.Object

de.larssh.utils.xml.XmlReadingFeatures.Xerces.XInclude

Enclosing class:

XmlReadingFeatures.Xerces

public static final class XmlReadingFeatures.Xerces.XInclude
extends Object

XInclude Features (experimental)

Field Summary

Fields

Modifier and Type	Field and Description
static String	ALLOW_DTD_EVENTS_AFTER_ENDDTD true (default): Allows notationDecl and unparsedEntityDecl events to be sent in the XNI pipeline after the endDTD event has been sent.

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

ALLOW_DTD_EVENTS_AFTER_ENDDTD

public static final String ALLOW_DTD_EVENTS_AFTER_ENDDTD

true (default): Allows notationDecl and unparsedEntityDecl events to be sent in the XNI pipeline after the endDTD event has been sent.

false: Ensures that notationDecl and unparsedEntityDecl events are not sent after the endDTD event has been sent (default SAX behavior).

Note: The default value for this feature is true, except when using SAX, because SAX requires that no DTD events be sent after the endDTD event. Thus, in order to maintain SAX compatibility, this feature cannot be true by default for SAX. Setting this feature to false can result in loss of information, if notations and unparsed entities were needed to resolve references in the document.

This feature is only relevant when XInclude processing is being done. Due to the nature of implementing XInclude in a stream-based API, it is not possible to know the complete set of required unparsed entities and notations before the endDTD event from the source document is sent. If an XIncludeHandler is not present in your pipeline, the value of this feature is irrelevant.

This feature is currently experimental, and might be removed or changed in the next release. If you have any concerns or suggestions about its use, please contact the j-users@xerces.apache.org mailing list.

Since:

Xerces-J 2.5.0