fr.tireme.shared.xml.resolver
Class MyCatalogResolver

java.lang.Object
  fr.tireme.shared.xml.resolver.MyCatalogResolver

All Implemented Interfaces:

javax.xml.transform.URIResolver, org.xml.sax.EntityResolver

public class MyCatalogResolver
extends java.lang.Object
implements org.xml.sax.EntityResolver, javax.xml.transform.URIResolver

A SAX EntityResolver/JAXP URIResolver that uses catalogs.

This class implements both a SAX EntityResolver and a JAXP URIResolver.

This resolver understands OASIS TR9401 catalogs, XCatalogs, and the current working draft of the OASIS Entity Resolution Technical Committee specification.

See Also:

Catalog, EntityResolver, Source created from Norman Walsh Apache resolver sample distribution

Field Summary

boolean	namespaceAware Make the parser Namespace aware?
boolean	validating Make the parser validating?

Constructor Summary

MyCatalogResolver()
Constructor

MyCatalogResolver(boolean privateCatalog)
Constructor

MyCatalogResolver(org.apache.xml.resolver.CatalogManager manager)
Constructor

Method Summary

org.apache.xml.resolver.Catalog	getCatalog() Return the underlying catalog
java.lang.String	getResolvedEntity(java.lang.String publicId, java.lang.String systemId) Implements the guts of the resolveEntity method for the SAX interface.
javax.xml.transform.Source	resolve(java.lang.String href, java.lang.String base) JAXP URIResolver API
org.xml.sax.InputSource	resolveEntity(java.lang.String publicId, java.lang.String systemId) Implements the resolveEntity method for the SAX interface.

Methods inherited from class java.lang.Object

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

Field Detail

namespaceAware

public boolean namespaceAware

Make the parser Namespace aware?

validating

public boolean validating

Make the parser validating?

Constructor Detail

MyCatalogResolver

public MyCatalogResolver()
                  throws Xml2outputAbortExcept

Constructor

Throws:

Xml2outputAbortExcept

MyCatalogResolver

public MyCatalogResolver(boolean privateCatalog)
                  throws Xml2outputAbortExcept

Constructor

Parameters:

privateCatalog - boolean

Throws:

Xml2outputAbortExcept

MyCatalogResolver

public MyCatalogResolver(org.apache.xml.resolver.CatalogManager manager)
                  throws Xml2outputAbortExcept

Constructor

Parameters:

manager - CatalogManager

Throws:

Xml2outputAbortExcept

Method Detail

getCatalog

public org.apache.xml.resolver.Catalog getCatalog()

Return the underlying catalog

Returns:

Catalog

getResolvedEntity

public java.lang.String getResolvedEntity(java.lang.String publicId,
                                          java.lang.String systemId)

Implements the guts of the resolveEntity method for the SAX interface.

Presented with an optional public identifier and a system identifier, this function attempts to locate a mapping in the catalogs.

If such a mapping is found, it is returned. If no mapping is found, null is returned.

Parameters:

publicId - The public identifier for the entity in question. This may be null.

systemId - The system identifier for the entity in question. XML requires a system identifier on all external entities, so this value is always specified.

Returns:

The resolved identifier (a URI reference).

resolveEntity

public org.xml.sax.InputSource resolveEntity(java.lang.String publicId,
                                             java.lang.String systemId)

Implements the resolveEntity method for the SAX interface.

Presented with an optional public identifier and a system identifier, this function attempts to locate a mapping in the catalogs.

If such a mapping is found, the resolver attempts to open the mapped value as an InputSource and return it. Exceptions are ignored and null is returned if the mapped value cannot be opened as an input source.

If no mapping is found (or an error occurs attempting to open the mapped value as an input source), null is returned and the system will use the specified system identifier as if no entityResolver was specified.

Specified by:

resolveEntity in interface org.xml.sax.EntityResolver

Parameters:

publicId - The public identifier for the entity in question. This may be null.

systemId - The system identifier for the entity in question. XML requires a system identifier on all external entities, so this value is always specified.

Returns:

An InputSource for the mapped identifier, or null.

See Also:

EntityResolver.resolveEntity(String, String)

resolve

public javax.xml.transform.Source resolve(java.lang.String href,
                                          java.lang.String base)
                                   throws javax.xml.transform.TransformerException

JAXP URIResolver API

Specified by:

resolve in interface javax.xml.transform.URIResolver

Parameters:

href - String

base - String

Returns:

Source

Throws:

javax.xml.transform.TransformerException

See Also:

URIResolver.resolve(String, String)