File	Doc	Category	Size	Date	Package
XMLReaderAdapter.java	API Doc	Java SE 5 API	14046	Fri Aug 26 14:58:44 BST 2005	org.xml.sax.helpers

XMLReaderAdapter

• java.lang.Object

Fields Summary
XMLReader	xmlReader
DocumentHandler	documentHandler
AttributesAdapter	qAtts

Constructors Summary
public XMLReaderAdapter() Create a new adapter. Use the "org.xml.sax.driver" property to locate the SAX2 driver to embed. exception org.xml.sax.SAXException If the embedded driver cannot be instantiated or if the org.xml.sax.driver property is not specified. setup(XMLReaderFactory.createXMLReader());
public XMLReaderAdapter(XMLReader xmlReader) Create a new adapter. Create a new adapter, wrapped around a SAX2 XMLReader. The adapter will make the XMLReader act like a SAX1 Parser. param xmlReader The SAX2 XMLReader to wrap. exception java.lang.NullPointerException If the argument is null. setup(xmlReader);

Methods Summary
public void	characters(char[] ch, int start, int length) Adapt a SAX2 characters event. param ch An array of characters. param start The starting position in the array. param length The number of characters to use. exception org.xml.sax.SAXException The client may raise a processing exception. see org.xml.sax.ContentHandler#characters if (documentHandler != null) documentHandler.characters(ch, start, length);
public void	endDocument() End document event. exception org.xml.sax.SAXException The client may raise a processing exception. see org.xml.sax.ContentHandler#endDocument if (documentHandler != null) documentHandler.endDocument();
public void	endElement(java.lang.String uri, java.lang.String localName, java.lang.String qName) Adapt a SAX2 end element event. param uri The Namespace URI. param localName The Namespace local name. param qName The qualified (prefixed) name. exception org.xml.sax.SAXException The client may raise a processing exception. see org.xml.sax.ContentHandler#endElement if (documentHandler != null) documentHandler.endElement(qName);
public void	endPrefixMapping(java.lang.String prefix) Adapt a SAX2 end prefix mapping event. param prefix The prefix being mapped. see org.xml.sax.ContentHandler#endPrefixMapping
public void	ignorableWhitespace(char[] ch, int start, int length) Adapt a SAX2 ignorable whitespace event. param ch An array of characters. param start The starting position in the array. param length The number of characters to use. exception org.xml.sax.SAXException The client may raise a processing exception. see org.xml.sax.ContentHandler#ignorableWhitespace if (documentHandler != null) documentHandler.ignorableWhitespace(ch, start, length);
public void	parse(org.xml.sax.InputSource input) Parse the document. This method will throw an exception if the embedded XMLReader does not support the http://xml.org/sax/features/namespace-prefixes property. param input An input source for the document. exception java.io.IOException If there is a problem reading the raw content of the document. exception org.xml.sax.SAXException If there is a problem processing the document. see #parse(java.lang.String) see org.xml.sax.Parser#parse(org.xml.sax.InputSource) setupXMLReader(); xmlReader.parse(input);
public void	parse(java.lang.String systemId) Parse the document. This method will throw an exception if the embedded XMLReader does not support the http://xml.org/sax/features/namespace-prefixes property. param systemId The absolute URL of the document. exception java.io.IOException If there is a problem reading the raw content of the document. exception org.xml.sax.SAXException If there is a problem processing the document. see #parse(org.xml.sax.InputSource) see org.xml.sax.Parser#parse(java.lang.String) parse(new InputSource(systemId));
public void	processingInstruction(java.lang.String target, java.lang.String data) Adapt a SAX2 processing instruction event. param target The processing instruction target. param data The remainder of the processing instruction exception org.xml.sax.SAXException The client may raise a processing exception. see org.xml.sax.ContentHandler#processingInstruction if (documentHandler != null) documentHandler.processingInstruction(target, data);
public void	setDTDHandler(org.xml.sax.DTDHandler handler) Register the DTD event handler. param handler The new DTD event handler. see org.xml.sax.Parser#setDTDHandler xmlReader.setDTDHandler(handler);
public void	setDocumentHandler(org.xml.sax.DocumentHandler handler) Register the SAX1 document event handler. Note that the SAX1 document handler has no Namespace support. param handler The new SAX1 document event handler. see org.xml.sax.Parser#setDocumentHandler documentHandler = handler;
public void	setDocumentLocator(org.xml.sax.Locator locator) Set a document locator. param locator The document locator. see org.xml.sax.ContentHandler#setDocumentLocator if (documentHandler != null) documentHandler.setDocumentLocator(locator);
public void	setEntityResolver(org.xml.sax.EntityResolver resolver) Register the entity resolver. param resolver The new resolver. see org.xml.sax.Parser#setEntityResolver xmlReader.setEntityResolver(resolver);
public void	setErrorHandler(org.xml.sax.ErrorHandler handler) Register the error event handler. param handler The new error event handler. see org.xml.sax.Parser#setErrorHandler xmlReader.setErrorHandler(handler);
public void	setLocale(java.util.Locale locale) Set the locale for error reporting. This is not supported in SAX2, and will always throw an exception. param locale the locale for error reporting. see org.xml.sax.Parser#setLocale exception org.xml.sax.SAXException Thrown unless overridden. throw new SAXNotSupportedException("setLocale not supported");
private void	setup(org.xml.sax.XMLReader xmlReader) Internal setup. param xmlReader The embedded XMLReader. if (xmlReader == null) { throw new NullPointerException("XMLReader must not be null"); } this.xmlReader = xmlReader; qAtts = new AttributesAdapter();
private void	setupXMLReader() Set up the XML reader. xmlReader.setFeature("http://xml.org/sax/features/namespace-prefixes", true); try { xmlReader.setFeature("http://xml.org/sax/features/namespaces", false); } catch (SAXException e) { // NO OP: it's just extra information, and we can ignore it } xmlReader.setContentHandler(this);
public void	skippedEntity(java.lang.String name) Adapt a SAX2 skipped entity event. param name The name of the skipped entity. see org.xml.sax.ContentHandler#skippedEntity exception org.xml.sax.SAXException Throwable by subclasses.
public void	startDocument() Start document event. exception org.xml.sax.SAXException The client may raise a processing exception. see org.xml.sax.ContentHandler#startDocument if (documentHandler != null) documentHandler.startDocument();
public void	startElement(java.lang.String uri, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes atts) Adapt a SAX2 start element event. param uri The Namespace URI. param localName The Namespace local name. param qName The qualified (prefixed) name. param atts The SAX2 attributes. exception org.xml.sax.SAXException The client may raise a processing exception. see org.xml.sax.ContentHandler#endDocument if (documentHandler != null) { qAtts.setAttributes(atts); documentHandler.startElement(qName, qAtts); }
public void	startPrefixMapping(java.lang.String prefix, java.lang.String uri) Adapt a SAX2 start prefix mapping event. param prefix The prefix being mapped. param uri The Namespace URI being mapped to. see org.xml.sax.ContentHandler#startPrefixMapping