Package net.sf.saxon.lib
Class StandardOutputResolver
java.lang.Object
net.sf.saxon.lib.StandardOutputResolver
- All Implemented Interfaces:
OutputURIResolver
This class defines the default OutputURIResolver. This is a counterpart to the JAXP
URIResolver, but is used to map the URI of a secondary result document to a Result object
which acts as the destination for the new document.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
Signal completion of the result document.protected Result
createResult
(URI absoluteURI) static StandardOutputResolver
Get a singular instanceGet an instance of this OutputURIResolver class.Resolve an output URI
-
Constructor Details
-
StandardOutputResolver
public StandardOutputResolver()
-
-
Method Details
-
getInstance
Get a singular instance- Returns:
- the singleton instance of the class
-
newInstance
Get an instance of this OutputURIResolver class.This method is called every time an xsl:result-document instruction is evaluated (with an href attribute). The resolve() and close() methods will be called on the returned instance.
This OutputURIResolver is stateless (that is, it retains no information between resolve() and close()), so the same instance can safely be returned each time. For a stateful OutputURIResolver, it must either take care to be thread-safe (handling multiple invocations of xsl:result-document concurrently), or it must return a fresh instance of itself for each call.
- Specified by:
newInstance
in interfaceOutputURIResolver
- Returns:
- a new instance of the class
-
resolve
Resolve an output URI- Specified by:
resolve
in interfaceOutputURIResolver
- Parameters:
href
- The relative URI of the output document. This corresponds to the href attribute of the xsl:result-document instruction.base
- The base URI that should be used. This is the base output URI, normally the URI of the principal output file.- Returns:
- a Result object representing the destination for the XML document
- Throws:
XPathException
-
createResult
- Throws:
XPathException
IOException
-
close
Signal completion of the result document. This method is called by the system when the result document has been successfully written. It allows the resolver to perform tidy-up actions such as closing output streams, or firing off processes that take this result tree as input. Note that the OutputURIResolver is stateless, so the original href is supplied to identify the document that has been completed.- Specified by:
close
in interfaceOutputURIResolver
- Parameters:
result
- The result object returned by the previous call of resolve()- Throws:
XPathException
-