- All Known Implementing Classes:
public interface CollationURIResolverA CollationURIResolver accepts a collation name as input, and returns a collation (represented by a
StringCollatoras output. A CollationURIResolver can be registered with the Configuration (or with a TransformerFactory) to resolve all collation URIs used in a stylesheet or query.
StringCollator resolve(java.lang.String collationURI, Configuration config) throws XPathExceptionResolve a collation URI (expressed as a string in the form of an absolute URI) and return the corresponding collation.
collationURI- the collation URI as written in the query or stylesheet, after resolving against the base URI where necessary
config- The configuration. Provided in case the collation URI resolver needs it.
- a StringCollator, representing the collation to be used. Note that although
any StringCollator may be returned, functions such as contains() that need to break
a string into its collation units will work only if the returned StringCollator
If the Collation URI is not recognized, return null. Note that unlike the JAXP URIResolver, returning null does not cause the default CollationURIResolver to be invoked; if this is required, the user-written CollationURIResolver should explicitly instantiate and invoke the
StandardCollationURIResolverbefore returning null.
XPathException- if the form of the URI is recognized, but if it is not valid, for example because it is not supported in this environment. In this case of the UCA collation, this exception is thrown when there are invalid parameters and fallback=no is specified.
- 8.5/8.9 (this interface was introduced provisionally in 8.5, and modified in 8.9 to return a StringCollator rather than a Comparator). Modified in 9.6 to accept the absolute URI of the collation, rather than the relative URI and base URI separately, and also to allow an exception to be thrown