001    package com.thaiopensource.xml.sax;
002    
003    import org.xml.sax.SAXException;
004    import org.xml.sax.XMLReader;
005    
006    /**
007     * A factory for <code>XMLReader</code>s.  Thread-safety is determined by each particular
008     * implementation of this interface.
009     *
010     * @author <a href="mailto:jjc@jclark.com">James Clark</a>
011     */
012    public interface XMLReaderCreator {
013      /**
014       * Creates a new <code>XMLReader</code>.
015       *
016       * @return a new <code>XMLReader</code>; never <code>null</code>
017       * @throws org.xml.sax.SAXException If an <code>XMLReader</code> cannot be created for any reason
018       */
019      XMLReader createXMLReader() throws SAXException;
020    }