Class Resolver

java.lang.Object

org.xmlresolver.Resolver

All Implemented Interfaces:

URIResolver, LSResourceResolver, EntityResolver, EntityResolver2, NamespaceResolver

Direct Known Subclasses:

XercesResolver

public class Resolver
extends Object
implements URIResolver, EntityResolver, EntityResolver2, NamespaceResolver, LSResourceResolver

An implementation of many resolver interfaces.

This class is probably the most common entry point to the XML Catalog resolver. It has a zero argument constructor so it can be instantiated directly from its class name (for example, passed to an application as a commend line argument or stored in a configuration file). When instantiated this way, it will automatically be configured by system properties and an xmlresolver.properties configuration file, if one exists.

This class implements the EntityResolver, EntityResolver2, LSResourceResolver and NamespaceResolver, and URIResolver interfaces.

The StAX XMLResolver interface is implemented by the StAXResolver class because the resolveEntity method of the XMLResolver interface isn't compatible with the EntityResolver2 method of the same name.

See Also:

• StAXResolver

Field Summary

Fields

Modifier and Type	Field	Description
protected final XMLResolverConfiguration	config
static final String	NATURE_RELAX_NG
static final String	NATURE_XML_SCHEMA
static final String	NATURE_XML_SCHEMA_1_1
static final String	PURPOSE_SCHEMA_VALIDATION
protected final CatalogResolver	resolver

Constructor Summary

Constructors

Constructor	Description
Resolver()	Creates a new instance of Resolver.
Resolver(CatalogResolver resolver)	Creates a new instance of a Resolver.
Resolver(XMLResolverConfiguration config)	Creates a new instance of a Resolver.

Method Summary

Modifier and Type	Method	Description
CatalogResolver	getCatalogResolver()	Get the underlying CatalogResolver used by this resolver.
XMLResolverConfiguration	getConfiguration()	Get the Catalog used by this resolver.
InputSource	getExternalSubset(String name, String baseURI)	Implements the EntityResolver2 interface.
protected ResolvedResource	openConnection(String uri, String baseURI, boolean asEntity)
protected ResolvedResource	openConnection(URI originalURI, boolean asEntity)
Source	resolve(String href, String base)	Implements the URIResolver interface.
InputSource	resolveEntity(String publicId, String systemId)	Implements the EntityResolver interface.
InputSource	resolveEntity(String name, String publicId, String baseURI, String systemId)	Implements the EntityResolver2 interface.
Source	resolveNamespace(String uri, String nature, String purpose)	Implements the NamespaceResolver interface.
LSInput	resolveResource(String type, String namespaceURI, String publicId, String systemId, String baseURI)	Implements the LSResourceResolver interface.
static String	version()	What version is this? Returns the version number of this resolver instance.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

PURPOSE_SCHEMA_VALIDATION

public static final String PURPOSE_SCHEMA_VALIDATION

See Also:

• Constant Field Values

NATURE_XML_SCHEMA

public static final String NATURE_XML_SCHEMA

See Also:

• Constant Field Values

NATURE_XML_SCHEMA_1_1

public static final String NATURE_XML_SCHEMA_1_1

See Also:

• Constant Field Values

NATURE_RELAX_NG

public static final String NATURE_RELAX_NG

See Also:

• Constant Field Values

config

protected final XMLResolverConfiguration config

resolver

protected final CatalogResolver resolver

Constructor Details

Resolver

public Resolver()

Creates a new instance of Resolver. The default resolver is a new ResourceResolver that uses a static catalog shared by all threads.

Resolver

public Resolver(XMLResolverConfiguration config)

Creates a new instance of a Resolver. Creates a resolver using a specific Catalog.

Parameters:

config - The configuration to use.

Resolver

public Resolver(CatalogResolver resolver)

Creates a new instance of a Resolver. Creates a resolver using a specific underlying ResourceResolver.

Parameters:

resolver - The resource resolver to use.

Method Details

version

public static String version()

What version is this? Returns the version number of this resolver instance.

Returns:

The version number

getConfiguration

public XMLResolverConfiguration getConfiguration()

Get the Catalog used by this resolver.

Returns:

The underlying catalog.

getCatalogResolver

public CatalogResolver getCatalogResolver()

Get the underlying CatalogResolver used by this resolver.

Returns:

The catalog resolver.

resolve

public Source resolve(String href,
 String base)
               throws TransformerException

Implements the URIResolver interface.

Specified by:

resolve in interface URIResolver

Throws:

TransformerException

resolveResource

public LSInput resolveResource(String type,
 String namespaceURI,
 String publicId,
 String systemId,
 String baseURI)

Implements the LSResourceResolver interface.

Specified by:

resolveResource in interface LSResourceResolver

getExternalSubset

public InputSource getExternalSubset(String name,
 String baseURI)
                              throws SAXException,
IOException

Implements the EntityResolver2 interface.

Specified by:

getExternalSubset in interface EntityResolver2

Throws:

SAXException

IOException

resolveEntity

public InputSource resolveEntity(String name,
 String publicId,
 String baseURI,
 String systemId)
                          throws SAXException,
IOException

Implements the EntityResolver2 interface.

Specified by:

resolveEntity in interface EntityResolver2

Throws:

SAXException

IOException

resolveEntity

public InputSource resolveEntity(String publicId,
 String systemId)
                          throws SAXException,
IOException

Implements the EntityResolver interface.

Specified by:

resolveEntity in interface EntityResolver

Throws:

SAXException

IOException

resolveNamespace

public Source resolveNamespace(String uri,
 String nature,
 String purpose)
                        throws TransformerException

Implements the NamespaceResolver interface.

Specified by:

resolveNamespace in interface NamespaceResolver

Parameters:

uri - The namespace URI.

nature - The RDDL nature of the resource.

purpose - The RDDL purpose of the resource.

Returns:

A Source object, or null if the href cannot be resolved, and the processor should try to resolve the URI itself.

Throws:

TransformerException - If an error occurs

openConnection

protected ResolvedResource openConnection(String uri,
 String baseURI,
 boolean asEntity)
                                   throws IOException

Throws:

IOException

openConnection

protected ResolvedResource openConnection(URI originalURI,
 boolean asEntity)
                                   throws IOException

Throws:

IOException