public class ApacheCatalogResolver
extends org.apache.xml.resolver.tools.CatalogResolver
This class extends the CatalogResolver class provided by Norman Walsh's resolver library in xml-commons. It provides the bridge between the Ant XMLCatalog datatype and the xml-commons Catalog class. XMLCatalog calls methods in this class using Reflection in order to avoid requiring the xml-commons resolver library in the path.
The ApacheCatalog
class is used to parse external catalog files, which
can be in either
plain text format or
XML format.
For each entry found in an external catalog file, if any, an
instance of ResourceLocation
is created and added to the controlling
XMLCatalog datatype. In this way, these entries will be included
in XMLCatalog's lookup algorithm. See XMLCatalog.java for more
details.
XMLCatalog.CatalogResolver
,
CatalogManager
Constructor and Description |
---|
ApacheCatalogResolver() |
Modifier and Type | Method and Description |
---|---|
void |
addPublicEntry(java.lang.String publicid,
java.lang.String systemid,
java.net.URL base)
Add a PUBLIC catalog entry to the controlling XMLCatalog instance.
|
void |
addURIEntry(java.lang.String uri,
java.lang.String altURI,
java.net.URL base)
Add a URI catalog entry to the controlling XMLCatalog instance.
|
void |
parseCatalog(java.lang.String file)
XMLCatalog calls this to add an external catalog file for each
file within a
<catalogfiles> fileset. |
void |
setXMLCatalog(XMLCatalog xmlCatalog)
Set the XMLCatalog object to callback.
|
public void setXMLCatalog(XMLCatalog xmlCatalog)
xmlCatalog
- the XMLCatalog to use.public void parseCatalog(java.lang.String file)
<catalogfiles>
fileset.file
- the external catalog file.public void addPublicEntry(java.lang.String publicid, java.lang.String systemid, java.net.URL base)
Add a PUBLIC catalog entry to the controlling XMLCatalog instance. ApacheCatalog calls this for each PUBLIC entry found in an external catalog file.
publicid
- The public ID of the resourcesystemid
- The system ID (aka location) of the resourcebase
- The base URL of the resource. If the systemid
specifies a relative URL/pathname, it is resolved using the
base. The default base for an external catalog file is the
directory in which the catalog is located.public void addURIEntry(java.lang.String uri, java.lang.String altURI, java.net.URL base)
Add a URI catalog entry to the controlling XMLCatalog instance. ApacheCatalog calls this for each URI entry found in an external catalog file.
uri
- The URI of the resourcealtURI
- The URI to which the resource should be mapped
(aka the location)base
- The base URL of the resource. If the altURI
specifies a relative URL/pathname, it is resolved using the
base. The default base for an external catalog file is the
directory in which the catalog is located.