Class ParserFactory
@Deprecated(since="1.5") public class ParserFactory extends Object
Note: This class is designed to work with the now-deprecated SAX1 Parser class. SAX2 applications should use XMLReaderFactory instead.
ParserFactory is not part of the platform-independent definition of SAX; it is an additional convenience class designed specifically for Java XML application writers. SAX applications can use the static methods in this class to allocate a SAX parser dynamically at run-time based either on the value of the `org.xml.sax.parser' system property or on a string containing the class name.
Note that the application still requires an XML parser that implements SAX1.
- Since:
- 1.4, SAX 1.0
Method Summary
| Modifier and Type | Method | Description |
|---|---|---|
static Parser |
makeParser() |
Deprecated. Create a new SAX parser using the `org.xml.sax.parser' system property. |
static Parser |
makeParser |
Deprecated. Create a new SAX parser object using the class name provided. |
Methods declared in class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Modifier and Type | Method | Description |
|---|---|---|
protected Object |
clone() |
Creates and returns a copy of this object. |
boolean |
equals |
Indicates whether some other object is "equal to" this one. |
protected void |
finalize() |
Deprecated, for removal: This API element is subject to removal in a future version. Finalization is deprecated and subject to removal in a future release. |
final Class |
getClass() |
Returns the runtime class of this Object. |
int |
hashCode() |
Returns a hash code value for this object. |
final void |
notify() |
Wakes up a single thread that is waiting on this object's monitor. |
final void |
notifyAll() |
Wakes up all threads that are waiting on this object's monitor. |
String |
toString() |
Returns a string representation of the object. |
final void |
wait() |
Causes the current thread to wait until it is awakened, typically by being notified or interrupted. |
final void |
wait |
Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. |
final void |
wait |
Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. |
Method Details
makeParser
public static Parser makeParser() throws ClassNotFoundException, IllegalAccessException, InstantiationException, NullPointerException, ClassCastException
The named class must exist and must implement the Parser interface.
- Returns:
- a new SAX parser
- Throws:
-
NullPointerException- There is no value for the `org.xml.sax.parser' system property. -
ClassNotFoundException- The SAX parser class was not found (check your CLASSPATH). -
IllegalAccessException- The SAX parser class was found, but you do not have permission to load it. -
InstantiationException- The SAX parser class was found but could not be instantiated. -
ClassCastException- The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser. - See Also:
makeParser
public static Parser makeParser(String className) throws ClassNotFoundException, IllegalAccessException, InstantiationException, ClassCastException
The named class must exist and must implement the Parser interface.
- Parameters:
-
className- A string containing the name of the SAX parser class. - Returns:
- a new SAX parser
- Throws:
-
ClassNotFoundException- The SAX parser class was not found (check your CLASSPATH). -
IllegalAccessException- The SAX parser class was found, but you do not have permission to load it. -
InstantiationException- The SAX parser class was found but could not be instantiated. -
ClassCastException- The SAX parser class was found and instantiated, but does not implement org.xml.sax.Parser. - See Also:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Parserinterface.