This adapter class wraps a SAX2 XMLReader object and makes it behave like a SAX1 Parser object. It is useful when working with a legacy API that requires a deprecated Parser object. Create an XMLReaderAdapter by passing an XMLReader to the XMLReaderAdapter( ) constructor. Then use the resulting object exactly as you would use any other SAX1 Parser object. This class implements ContentHandler so that it can receive SAX events from the XMLReader. But it also implements the Parser interface so that it can have a SAX1 DocumentHandler registered on it. The methods of ContentHandler are implemented to invoke the corresponding methods of the registered DocumentHandler.

Figure 22-19. org.xml.sax.helpers.XMLReaderAdapter

public class XMLReaderAdapter implements org.xml.sax.ContentHandler, org.xml.sax.Parser {
// Public Constructors
     public XMLReaderAdapter( ) throws org.xml.sax.SAXException;  
     public XMLReaderAdapter(org.xml.sax.XMLReader xmlReader);  
// Methods Implementing ContentHandler
     public void characters(char[ ] ch, int start, int length) 
        throws org.xml.sax.SAXException;  
     public void endDocument( ) throws org.xml.sax.SAXException;  
     public void endElement(String uri, String localName, String qName) 
        throws org.xml.sax.SAXException;  
     public void endPrefixMapping(String prefix);           empty
     public void ignorableWhitespace(char[ ] ch, int start, int length) 
        throws org.xml.sax.SAXException;  
     public void processingInstruction(String target, String data) 
        throws org.xml.sax.SAXException;  
     public void setDocumentLocator(org.xml.sax.Locator locator);  
     public void skippedEntity(String name) throws org.xml.sax.SAXException;     empty
     public void startDocument( ) throws org.xml.sax.SAXException;  
     public void startElement(String uri, String localName, String qName, 
        org.xml.sax.Attributes atts) 
        throws org.xml.sax.SAXException;  
     public void startPrefixMapping(String prefix, String uri);         empty
// Methods Implementing Parser
     public void parse(String systemId) throws java.io.IOException, org.xml.sax.SAXException;  
     public void parse(org.xml.sax.InputSource input) throws java.io.IOException, 
        org.xml.sax.SAXException;  
     public void setDocumentHandler(org.xml.sax.DocumentHandler handler);  
     public void setDTDHandler(org.xml.sax.DTDHandler handler);  
     public void setEntityResolver(org.xml.sax.EntityResolver resolver);  
     public void setErrorHandler(org.xml.sax.ErrorHandler handler);  
     public void setLocale(java.util.Locale locale) throws org.xml.sax.SAXException;  
}