org.apache.xml.resolver.readers
public class SAXCatalogReader extends Object implements CatalogReader, ContentHandler, DocumentHandler
A SAX-based CatalogReader
This class is used to read XML Catalogs using the SAX. This reader has an advantage over the DOM-based reader in that it functions on the stream of SAX events. It has the disadvantage that it cannot look around in the tree.
Since the choice of CatalogReaders (in the InputStream case) can only be made on the basis of MIME type, the following problem occurs: only one CatalogReader can exist for all XML mime types. In order to get around this problem, the SAXCatalogReader relies on a set of external CatalogParsers to actually build the catalog.
The selection of CatalogParsers is made on the basis of the QName of the root element of the document.
Version: 1.0
See Also: Catalog CatalogReader SAXCatalogReader TextCatalogReader
Field Summary | |
---|---|
protected Hashtable | namespaceMap Mapping table from QNames to CatalogParser classes. Each key in this hash table has the form "elementname" or "{namespaceuri}elementname". |
protected String | parserClass The SAX Parser Class |
protected SAXParserFactory | parserFactory The SAX Parser Factory |
Constructor Summary | |
---|---|
SAXCatalogReader() The constructor | |
SAXCatalogReader(SAXParserFactory parserFactory) The constructor | |
SAXCatalogReader(String parserClass) The constructor |
Method Summary | |
---|---|
void | characters(char[] ch, int start, int length) The SAX |
void | endDocument() The SAX |
void | endElement(String name) The SAX |
void | endElement(String namespaceURI, String localName, String qName) The SAX2 |
void | endPrefixMapping(String prefix) The SAX |
String | getCatalogParser(String namespaceURI, String rootElement) Get the SAXCatalogParser class for the given namespace/root
element type. |
String | getParserClass() Get the parser class currently in use. |
SAXParserFactory | getParserFactory() Get the parser factory currently in use. |
void | ignorableWhitespace(char[] ch, int start, int length) The SAX |
void | processingInstruction(String target, String data) The SAX |
void | readCatalog(Catalog catalog, String fileUrl) Parse an XML Catalog file. |
void | readCatalog(Catalog catalog, InputStream is) Parse an XML Catalog stream. |
void | setCatalogParser(String namespaceURI, String rootElement, String parserClass) Set the SAXCatalogParser class for the given namespace/root
element type. |
void | setDocumentLocator(Locator locator) The SAX |
void | setParserClass(String parserClass) Set the XML SAX Parser Class |
void | setParserFactory(SAXParserFactory parserFactory) Set the XML SAX Parser Factory. |
void | skippedEntity(String name) The SAX |
void | startDocument() The SAX |
void | startElement(String name, AttributeList atts) The SAX The catalog parser is selected based on the namespace of the first element encountered in the catalog. |
void | startElement(String namespaceURI, String localName, String qName, Attributes atts) The SAX2 The catalog parser is selected based on the namespace of the first element encountered in the catalog. |
void | startPrefixMapping(String prefix, String uri) The SAX |
Mapping table from QNames to CatalogParser classes.
Each key in this hash table has the form "elementname" or "{namespaceuri}elementname". The former is used if the namespace URI is null.
The SAX characters
method. Does nothing.
The SAX endDocument
method. Does nothing.
The SAX endElement
method. Does nothing.
The SAX2 endElement
method. Does nothing.
The SAX endPrefixMapping
method. Does nothing.
The SAX ignorableWhitespace
method. Does nothing.
The SAX processingInstruction
method. Does nothing.
Parse an XML Catalog file.
Parameters: catalog The catalog to which this catalog file belongs fileUrl The URL or filename of the catalog file to process
Throws: MalformedURLException Improper fileUrl IOException Error reading catalog file
Parse an XML Catalog stream.
Parameters: catalog The catalog to which this catalog file belongs is The input stream from which the catalog will be read
Throws: MalformedURLException Improper fileUrl IOException Error reading catalog file CatalogException A Catalog exception
The SAX setDocumentLocator
method. Does nothing.
The SAX skippedentity
method. Does nothing.
The SAX startDocument
method. Does nothing.
The SAX startElement
method.
The catalog parser is selected based on the namespace of the first element encountered in the catalog.
The SAX2 startElement
method.
The catalog parser is selected based on the namespace of the first element encountered in the catalog.
The SAX startPrefixMapping
method. Does nothing.