Building a Source Document from an application
With the Java s9api interface, a source document can be built using the DocumentBuilder class, which is created using
the factory method newDocumentBuilder
on the Processor object. Various options for document
building are available as methods on the DocumentBuilder
, for example options to
perform schema or DTD validation, to strip whitespace, to expand XInclude directives, and also
to choose the tree implementation model to be used.
Similarly in the .NET API, there is a DocumentBuilder object that can be created from the Processor. This allows options to be set controlling the way
documents are built, and provides an overloaded Build
method allowing a tree to
be built from various kinds of source.
It is also possible to build a Saxon tree in memory by using the buildDocument
method of the Configuration object.
(When using the JAXP Transformation API, the Configuration
can be obtained from
the TransformerFactory
as the value of the attribute named FeatureKeys.CONFIGURATION.)
The buildDocument()
method takes a single argument, a JAXP Source
. This can be any of the standard
kinds of JAXP Source
. See JAXP
Sources for more information.
All the documents processed in a single transformation or query must be loaded using the same
Configuration. However, it is
possible to copy a document from one Configuration
into another by supplying the
DocumentInfo at the root of the
existing document as the Source
supplied to the buildDocument()
method of the new Configuration.