3.org/2001/XInclude and a localname of
include
. When it finds an <include> element, it attempts to include the file specified in the
href
attribute of the element. If inclusion succeeds, all children of the <include> element are ignored (with the exception of checking for invalid children as outlined in the specification). If the inclusion fails, the <fallback> child of the <include> element is processed.
See the XInclude specification for more information on how XInclude is to be used.
This component requires the following features and properties from the component manager that uses it:
- http://xml.org/sax/features/allow-dtd-events-after-endDTD
- http://apache.org/xml/properties/internal/error-reporter
- http://apache.org/xml/properties/internal/entity-resolver
Optional property:
- http://apache.org/xml/properties/input-buffer-size
Furthermore, the
NamespaceContext
used in the pipeline is required to be an instance of
XIncludeNamespaceSupport
.
Currently, this implementation has only partial support for the XInclude specification. Specifically, it is missing support for XPointer document fragments. Thus, only whole documents can be included using this component in the pipeline.
@author Peter McCracken, IBM
@author Michael Glavassevich, IBM
@version $Id: XIncludeHandler.java,v 1.7 2010-11-01 04:40:18 joehw Exp $
@see XIncludeNamespaceSupport