<include> : CookXml Core Tag

<include> : CookXml Core Tag

This tag is used to include another XML document, an element in another XML document, or an element in the current XML document. Unlike idref which references the same object created earlier, this tag parses the element referenced (which may or may not have been processed) to create a new object.

Constructor Attribute (ctor)

The constructor attribute of this element needs to be in "resource", "resource#id", or "#id" format, where resource refers to the xml document path that can be loaded using ClassLoader.

Additional Notes

The ClassLoader being used to load the new XML document is the same ClassLoader which loads the current XML document.

Limitations

Currently, include does not consider relativeness of two XML documents. So if the current XML document has an URL of "foo/xml/foo.xml", and the XML to be included is foo/xml/foobar.xml, then one still needs to specify "foo/xml/foobar.xml" as the path.

Examples

<include ctor="foo/xml/foobar.xml"/>.