javax.xml.catalog

Interface CatalogUriResolver

All Superinterfaces:

URIResolver

public interface CatalogUriResolver
extends URIResolver

A JAXP URIResolver that uses catalogs to resolve references.

Since:

9

Method Summary

Modifier and Type	Method and Description
Source	resolve(String href, String base) The method searches through the catalog entries in the main and alternative catalogs to attempt to find a match with the specified URI.

Method Detail

resolve

Source resolve(String href,
               String base)

The method searches through the catalog entries in the main and alternative catalogs to attempt to find a match with the specified URI.

Specified by:

resolve in interface URIResolver

Parameters:

href - an href attribute, which may be relative or absolute

base - The base URI against which the href attribute will be made absolute if the absolute URI is required

Returns:

a Source object if a mapping is found. If no mapping is found, returns an empty Source object if the javax.xml.catalog.resolve property is set to ignore; returns a Source object with the original URI (href, or href resolved with base if base is not null) if the javax.xml.catalog.resolve property is set to continue.

Throws:

CatalogException - if no mapping is found and javax.xml.catalog.resolve is specified as strict