Package org.xmlresolver

The XML (Catalog) Resolver.

The resolver maps external identifiers (document type declarations and external parsed entities) and URIs found in XML documents to other resources. This implementation supports additional interfaces to perform redirection through RDDL documents and automated caching of resources retrieved from the web.

TL;DR

Tell your processor to instantiate a Resolver (it has a zero argument constructor so that it can be instantiated just from its name) and use it as the entity and URI resolver.

Tell your processor to instantiate a ResolvingXMLReader for parsing.

L;OS (long; only skimmed)

For most users, the principle entry points to this API will be the Resolver class and the ResolvingXMLReader. These instantiate a resolver that can be configured with either system properties or a properties file.

The Resolver class implements a wide variety of resolver APIs:

• javax.xml.transform.URIResolver.
• org.w3c.dom.ls.LSResourceResolver.
• org.xml.sax.EntityResolver.
• org.xml.sax.ext.EntityResolver2.
• NamespaceResolver

The StAX XMLResolver interface is incompatible with the EntityResolver2 interface, so it’s implemented in StAXResolver:

• javax.xml.stream.XMLResolver

The ResolvingXMLReader class extends the SAX parser so that it will automatically construct and use a resolver.

Accessing the resolver

The resolver is configured with a ResolverConfiguration, more specifically in this release, an XMLResolverConfiguration. This class allows you to configure features of the resolver.

Interface Summary

Interface	Description
NamespaceResolver	Interface for resolving namespace URIs.
ResolverConfiguration	Interface for configuring the resolver.
ResourceResolver	The resource resolver interface.
XMLCatalogResolver	The Catalog resolver interface.

Class Summary

Class	Description
CatalogManager	The CatalogManager manages a list of OASIS XML Catalogs and performs lookup operations on those catalogs.
CatalogResolver	The CatalogResolver returns resolved resources in a uniform way.
ResolvedResource	A resolved resource represents a successfully resolved resource.
Resolver	An implementation of many resolver interfaces.
ResolverConstants	A collection of constants.
ResolverFeature<T>	An individual resolver feature.
Resource	Represents a web resource.
StAXResolver	Implements the XMLResolver interface.
XercesResolver	An extension of the Resolver that implements Xerces XMLEntityResolver.
XMLResolverConfiguration	Configures an XML resolver.