compact2, compact3

org.xml.sax.helpers

Class XMLReaderFactory

java.lang.Object

org.xml.sax.helpers.XMLReaderFactory

public final class XMLReaderFactory
extends Object

用于创建XML阅读器的工厂。

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.

此类包含从显式类名称或基于运行时默认值创建XML读取器的静态方法：

  try {
   XMLReader myReader = XMLReaderFactory.createXMLReader();
 } catch (SAXException e) {
   System.err.println(e.getMessage());
 } 

与解析器捆绑的分发注意事项：您应该修改无参数createXMLReader的实现，以处理未设置外部配置机制的情况。 该方法应该尽可能地在类路径中返回一个解析器，即使没有将其类名称绑定到org.xml.sax.driver ，这样配置机制就可以看到它。

从以下版本开始：

SAX 2.0

Version:

2.0.1（sax2r2）

方法摘要

Modifier and Type	Method and Description
static XMLReader	createXMLReader() 尝试从系统默认值创建XMLReader。
static XMLReader	createXMLReader(String className) 尝试从类名创建XML阅读器。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

createXMLReader

public static XMLReader createXMLReader()
                                 throws SAXException

尝试从系统默认值创建XMLReader。 在可以支持它的环境中，XMLReader类的名称通过按顺序尝试这些选项来确定，并使用成功的第一个选项：

• 如果系统属性org.xml.sax.driver具有值，则用作XMLReader类名。
• JAR“服务API”用于在运行时可用的jarfile中的META-INF / services / org.xml.sax.driver文件中查找类名。
• 强烈地鼓励SAX解析器分发提供一个默认的XMLReader类名，只有当前一个选项（在此列表中）不成功时才会生效。
• 最后，如果ParserFactory.makeParser()可以返回一个系统默认的SAX1解析器，那个解析器被包裹在一个ParserAdapter中 。 （这是SAX1环境的迁移帮助，其中org.xml.sax.parser系统属性通常可以使用。）

在诸如不能支持灵活性的小型嵌入式系统的环境中，可以使用其他确定默认的机制。

请注意，许多Java环境允许在命令行上初始化系统属性。 这意味着在大多数情况下为该属性设置好的值可确保对此方法的调用将成功，除非安全策略介入。 这也将最大限度地提高应用程序对旧版SAX环境的可移植性，同时这种方法的实现也较少。

结果

一个新的XMLReader。

异常

SAXException - 如果不能识别和实例化默认的XMLReader类。

另请参见：

createXMLReader(java.lang.String)

createXMLReader

public static XMLReader createXMLReader(String className)
                                 throws SAXException

尝试从类名创建XML阅读器。

给定一个类名称，该方法尝试加载和实例化该类作为XML读取器。

请注意，这种方法在不允许调用者（可能是小程序）不允许动态加载类的环境中不可用。

结果

一个新的XML阅读器。

异常

SAXException - 如果类无法加载，实例化并转换为XMLReader。

另请参见：

createXMLReader()