|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface RelativeURIResolver
The standard JAXP URIResolver is given a relative URI and a base URI and returns the resource identified by this combination. However, to support a stable implementation of the doc() function, Saxon needs to know what the absolute URI is before the resource is fetched, so it can determine whether a document with that absolute URI actually exists.
This extended interface defines a URIResolver that separates the two functions of resolving a relative URI against a base URI, and fetching a resource with that absolute URI. If the URI resolver supplied to Saxon implements this interface, the absolute URI associated with a loaded document will be the URI returned by this resolver.
The particular motivation for providing this interface is to allow a URIResolver to wrap a .NET XmlResolver, which has additional capability not present in the JAXP interface.
Method Summary | |
---|---|
Source |
dereference(String uri)
Called by the processor when it encounters an xsl:include, xsl:import, or document() function. |
String |
makeAbsolute(String href,
String base)
Create an absolute URI from a relative URI and a base URI. |
Source |
resolve(String href,
String base)
Called by the processor when it encounters an xsl:include, xsl:import, or document() function. |
void |
setExpectedMediaType(String mediaType)
Specify the media type of the resource that is expected to be delivered. |
Method Detail |
---|
String makeAbsolute(String href, String base) throws TransformerException
href
- A relative or absolute URI, to be resolved against the specified base URIbase
- The base URI against which the first argument will be made
absolute if the absolute URI is required.
resolve
method.
TransformerException
- if any failure occursSource dereference(String uri) throws TransformerException
uri
- The absolute URI to be dereferenced
TransformerException
- if an error occurs when trying to
resolve the URI.Source resolve(String href, String base) throws TransformerException
Despite the name, the main purpose of this method is to dereference the URI, not merely to resolve it.
This method is provided because it is required by the interface. When using a RelativeURIResolver,
the single-argument dereference() method is preferred. The result of calling this method should be the
same as the result of calling dereference(makeAbsolute(href, base))
resolve
in interface URIResolver
href
- An href attribute, which may be relative or absolute.base
- The base URI against which the first argument will be made
absolute if the absolute URI is required.
TransformerException
- if an error occurs when trying to
resolve the URI.void setExpectedMediaType(String mediaType)
mediaType
- the expected media type
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |