net.sf.saxon.lib

Interface UnparsedTextURIResolver

All Known Implementing Classes:

StandardUnparsedTextResolver

public interface UnparsedTextURIResolver

An UnparsedTextURIResolver accepts an absolute URI and optionally an encoding name as input, and returns a Reader as its result.

Method Summary

Modifier and Type	Method and Description
java.io.Reader	resolve(java.net.URI absoluteURI, java.lang.String encoding, Configuration config) Resolve the URI passed to the XSLT unparsed-text() function, after resolving against the base URI.

Method Detail

resolve

java.io.Reader resolve(java.net.URI absoluteURI,
                       java.lang.String encoding,
                       Configuration config)
                throws XPathException

Resolve the URI passed to the XSLT unparsed-text() function, after resolving against the base URI.

Note that a user-written resolver is responsible for enforcing some of the rules in the XSLT specification, such as the rules for inferring an encoding when none is supplied. Saxon will not report any error if the resolver does this in a non-conformant way.

Parameters:

absoluteURI - the absolute URI obtained by resolving the supplied URI against the base URI

encoding - the encoding requested in the call of unparsed-text(), if any. Otherwise null.

config - The Saxon configuration. Provided in case the URI resolver needs it.

Returns:

a Reader, which Saxon will use to read the unparsed text. After the text has been read, the close() method of the Reader will be called. Returning null is not acceptable; if the resolver wishes to delegate to the standard resolver, it can do this by subclassing StandardUnparsedTextResolver and calling super.resolve(...).

Throws:

XPathException - if any failure occurs

Since:

8.9