This catalog supports the XCatalog proposal draft 0.2 posted
to the xml-dev mailing list by
John Cowan. XCatalog
is an XML representation of the SGML Open TR9401:1997 catalog
format. The current proposal supports public identifier maps,
system identifier aliases, and public identifier prefix
delegates. Refer to the XCatalog DTD for the full specification
of this catalog format at
http://www.ccil.org/~cowan/XML/XCatalog.html.
In order to use XCatalogs, you must write the catalog files
with the following restrictions:
To use this catalog in a parser, set an XCatalog instance as the
parser's EntityResolver. For example:
XMLParser parser = new AnyParser();
Catalog catalog = new XCatalog();
parser.getEntityHandler().setEntityResolver(catalog);
Once installed, catalog files that conform to the XCatalog grammar
can be appended to the catalog by calling the loadCatalog
method on the parser or the catalog instance. The following example
loads the contents of two catalog files:
parser.loadCatalog(new InputSource("catalogs/cat1.xml"));
parser.loadCatalog(new InputSource("http://host/catalogs/cat2.xml"));
Limitations: The following are the current limitations
of this XCatalog implementation:
- No error checking is done to avoid circular Delegate
or Extend references. Do not specify a combination of
catalog files that reference each other.
author: Andy Clark, IBM version: $Id: XCatalog.java,v 1.2 2000/04/04 21:14:25 andyc Exp $ |