XMLReaderAdapter

XMLReaderAdapter

org.xml.sax.helpers

---

Java 1.4

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;   }