57 *
58 * This static method creates a new factory instance based
59 * on a system property setting or uses the platform default
60 * if no property has been defined.<p>
61 *
62 * The system property that controls which Factory implementation
63 * to create is named <code>"javax.xml.parsers.SAXParserFactory"</code>.
64 * This property names a class that is a concrete subclass of this
65 * abstract class. If no property is defined, a platform default
66 * will be used.</p>
67 *
68 * As the content is parsed by the underlying parser, methods of the
69 * given {@link org.xml.sax.HandlerBase} or the
70 * {@link org.xml.sax.helpers.DefaultHandler} are called.<p>
71 *
72 * Implementors of this class which wrap an underlying implementation
73 * can consider using the {@link org.xml.sax.helpers.ParserAdapter}
74 * class to initially adapt their SAX1 implementation to work under
75 * this revised class.
76 *
77 * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
78 * @since 1.4
79 */
80 @SuppressWarnings("deprecation")
81 public abstract class SAXParser {
82
83 /**
84 * <p>Protected constructor to prevent instantiation.
85 * Use {@link javax.xml.parsers.SAXParserFactory#newSAXParser()}.</p>
86 */
87 protected SAXParser () {
88
89 }
90
91 /**
92 * <p>Reset this <code>SAXParser</code> to its original configuration.</p>
93 *
94 * <p><code>SAXParser</code> is reset to the same state as when it was created with
95 * {@link SAXParserFactory#newSAXParser()}.
96 * <code>reset()</code> is designed to allow the reuse of existing <code>SAXParser</code>s
97 * thus saving resources associated with the creation of new <code>SAXParser</code>s.</p>
|
57 *
58 * This static method creates a new factory instance based
59 * on a system property setting or uses the platform default
60 * if no property has been defined.<p>
61 *
62 * The system property that controls which Factory implementation
63 * to create is named <code>"javax.xml.parsers.SAXParserFactory"</code>.
64 * This property names a class that is a concrete subclass of this
65 * abstract class. If no property is defined, a platform default
66 * will be used.</p>
67 *
68 * As the content is parsed by the underlying parser, methods of the
69 * given {@link org.xml.sax.HandlerBase} or the
70 * {@link org.xml.sax.helpers.DefaultHandler} are called.<p>
71 *
72 * Implementors of this class which wrap an underlying implementation
73 * can consider using the {@link org.xml.sax.helpers.ParserAdapter}
74 * class to initially adapt their SAX1 implementation to work under
75 * this revised class.
76 *
77 * @author Jeff Suttor
78 * @since 1.4
79 */
80 @SuppressWarnings("deprecation")
81 public abstract class SAXParser {
82
83 /**
84 * <p>Protected constructor to prevent instantiation.
85 * Use {@link javax.xml.parsers.SAXParserFactory#newSAXParser()}.</p>
86 */
87 protected SAXParser () {
88
89 }
90
91 /**
92 * <p>Reset this <code>SAXParser</code> to its original configuration.</p>
93 *
94 * <p><code>SAXParser</code> is reset to the same state as when it was created with
95 * {@link SAXParserFactory#newSAXParser()}.
96 * <code>reset()</code> is designed to allow the reuse of existing <code>SAXParser</code>s
97 * thus saving resources associated with the creation of new <code>SAXParser</code>s.</p>
|