SAXParserFactory (Java Platform SE 8 )

java.lang.Object
- javax.xml.parsers.SAXParserFactory

```
public abstract class SAXParserFactory
extends Object
```
定义工厂API，使应用程序能够配置和获取基于SAX的解析器来解析XML文档。

Version:

$修订：1.9 $，$日期：2010/05/25 16:19:44 $

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`SAXParserFactory()` 受保护的构造函数强制使用 `newInstance()` 。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract boolean`	`getFeature(String name)` 返回org.xml.sax.XMLReader的底层实现中请求的特定属性。
`Schema`	`getSchema()` 获取通过`setSchema(Schema schema)`方法指定的`Schema`对象。
`boolean`	`isNamespaceAware()` 指示工厂是否配置为生成名称空间感知的解析器。
`boolean`	`isValidating()` 指示工厂是否配置为生成在解析期间验证XML内容的解析器。
`boolean`	`isXIncludeAware()` 获取XInclude处理的状态。
`static SAXParserFactory`	`newInstance()` 获得一个新的实例 `SAXParserFactory` 。
`static SAXParserFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)` 从类名获取一个新的实例 `SAXParserFactory` 。
`abstract SAXParser`	`newSAXParser()` 使用当前配置的工厂参数创建SAXParser的新实例。
`abstract void`	`setFeature(String name, boolean value)` 设置org.xml.sax.XMLReader的底层实现中的特殊功能。
`void`	`setNamespaceAware(boolean awareness)` 指定此代码生成的解析器将为XML命名空间提供支持。
`void`	`setSchema(Schema schema)` 将`Schema`设置为由此工厂创建的解析器使用。
`void`	`setValidating(boolean validating)` 指定此代码生成的解析器将在文档解析时验证文档。
`void`	`setXIncludeAware(boolean state)` 设置XInclude处理的状态。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - SAXParserFactory
```
protected SAXParserFactory()
```
    受保护的构造函数强制使用newInstance() 。
- 方法详细信息
  - newInstance
```
public static SAXParserFactory newInstance()
```
    获得一个新的实例SAXParserFactory 。此静态方法创建一个新的工厂实例此方法使用以下有序查找过程来确定要加载的SAXParserFactory实现类：
    - 使用javax.xml.parsers.SAXParserFactory系统属性。
    - 在JRE目录中使用属性文件“lib / jaxp.properties”。此配置文件采用标准java.util.Properties格式，包含实现类的完全限定名称，其中键为上面定义的系统属性。 jaxp.properties文件由JAXP实现只读一次，然后将其缓存以备将来使用。如果文件第一次尝试读取文件不存在，则不再进一步检查其存在。在第一次读取jaxp.properties之后，无法更改任何属性的值。
    - 使用由ServiceLoader类定义的服务提供商加载工具尝试使用default loading mechanism查找和加载服务的实现：服务提供商加载工具将使用current thread's context class loader尝试加载服务。如果上下文类加载器为null，那么将使用system class loader 。
    - 否则返回系统默认的实现。
    一旦应用程序获得了对SAXParserFactory的SAXParserFactory就可以使用工厂来配置和获取解析器实例。
    提示进行故障排除
    
    设置jaxp.debug系统属性将导致此方法打印大量调试消息到System.err关于它正在做什么和它在哪里看。
    
    如果您有问题加载SAXParser s，请尝试：
```
  java -Djaxp.debug=1 YourProgram .... 
```
    结果
    
    SAXParserFactory的新实例。
    
    异常
    
    FactoryConfigurationError -在以下情况下service configuration error或者如果实现不可用或不能被实例化。
  - newInstance
```
public static SAXParserFactory newInstance(String factoryClassName,
                                           ClassLoader classLoader)
```
    从类名获取一个新的实例SAXParserFactory 。在类路径中有多个提供程序时，此功能很有用。它可以更好地控制应用程序，因为它可以指定应该加载哪个提供程序。
    
    一旦应用程序获得了对SAXParserFactory的SAXParserFactory它可以使用工厂来配置和获取解析器实例。
    
    提示进行故障排除
    
    设置jaxp.debug系统属性将导致此方法打印大量调试消息到System.err关于它正在做什么和它在哪里看。
    
    如果您有问题，请尝试：
```
  java -Djaxp.debug=1 YourProgram .... 
```
    参数
    
    factoryClassName -完全限定工厂类名称，提供实施 javax.xml.parsers.SAXParserFactory 。
    
    classLoader - ClassLoader用于加载工厂类。如果null当前的Thread的上下文classLoader用于加载工厂类。
    
    结果
    
    新实例的一个 SAXParserFactory
    
    异常
    
    FactoryConfigurationError - 如果 factoryClassName是 null ，或工厂类无法加载，实例化。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    newInstance()
  - newSAXParser
```
public abstract SAXParser newSAXParser()
                                throws ParserConfigurationException,
                                       SAXException
```
    使用当前配置的工厂参数创建SAXParser的新实例。
    
    结果
    
    SAXParser的一个新实例。
    
    异常
    
    ParserConfigurationException - 如果无法创建满足请求配置的解析器。
    
    SAXException - 用于SAX错误。
  - setNamespaceAware
```
public void setNamespaceAware(boolean awareness)
```
    指定此代码生成的解析器将为XML命名空间提供支持。默认情况下，该值设置为false 。
    
    参数
    
    awareness - 如果此代码生成的解析器将为XML命名空间提供支持，则为true; 否则为假。
  - setValidating
```
public void setValidating(boolean validating)
```
    指定此代码生成的解析器将在文档解析时验证文档。默认情况下，该值设置为false 。
    需要注意的是“验证”在这里是指a validating parser如XML推荐定义。换句话说，它基本上只是控制DTD验证。（JAXP 1.2中定义的遗留的两个属性除外）
    
    要使用现代模式语言（如W3C XML Schema或RELAX NG而不是DTD），您可以通过离开setValidating(boolean)方法false将您的解析器配置为非验证解析器，然后使用setSchema(Schema)方法将模式与解析器相关联。
    
    参数
    
    validating - 如果此代码生成的解析器将在解析文档时验证文本，则为true; 否则为假。
  - isNamespaceAware
```
public boolean isNamespaceAware()
```
    指示工厂是否配置为生成名称空间感知的解析器。
    
    结果
    
    如果工厂配置为生成名称空间感知的解析器，则为true; 否则为假。
  - isValidating
```
public boolean isValidating()
```
    指示工厂是否配置为生成在解析期间验证XML内容的解析器。
    
    结果
    
    如果工厂配置为生成在解析期间验证XML内容的解析器，则为true; 否则为假。
  - setFeature
```
public abstract void setFeature(String name,
                                boolean value)
                         throws ParserConfigurationException,
                                SAXNotRecognizedException,
                                SAXNotSupportedException
```
    设置org.xml.sax.XMLReader的底层实现中的特殊功能。核心功能和属性的列表可以在http://www.saxproject.org/找到
    
    所有实现都需要支持XMLConstants.FEATURE_SECURE_PROCESSING功能。当功能是
    - true ：实现将限制XML处理以符合实现限制。示例包括将消耗大量资源的实体扩展限制和XML模式构造。如果XML处理由于安全原因而受到限制，则通过对已注册的ErrorHandler.fatalError(SAXParseException exception)的呼叫进行报告。请参阅SAXParser parse处理程序规范的方法。
    - 当功能是false时，实现将根据XML规范处理XML，而不考虑可能的实现限制。
    参数
    
    name - 要设置的功能的名称。
    
    value - 要设置的要素的值。
    
    异常
    
    ParserConfigurationException - 如果无法创建满足请求的配置的解析器。
    
    SAXNotRecognizedException - 底层XMLReader无法识别属性名称时。
    
    SAXNotSupportedException - 底层XMLReader识别属性名称但不支持该属性时。
    
    NullPointerException - 如果 name参数为空。
    
    另请参见：
    
    XMLReader.setFeature(java.lang.String, boolean)
  - getFeature
```
public abstract boolean getFeature(String name)
                            throws ParserConfigurationException,
                                   SAXNotRecognizedException,
                                   SAXNotSupportedException
```
    返回org.xml.sax.XMLReader的底层实现中请求的特定属性。
    
    参数
    
    name - 要检索的属性的名称。
    
    结果
    
    请求的财产的价值。
    
    异常
    
    ParserConfigurationException - 如果无法创建满足请求的配置的解析器。
    
    SAXNotRecognizedException - 底层XMLReader无法识别属性名称时。
    
    SAXNotSupportedException - 底层XMLReader识别属性名称但不支持该属性时。
    
    另请参见：
    
    XMLReader.getProperty(java.lang.String)
  - getSchema
```
public Schema getSchema()
```
    通过setSchema(Schema schema)方法获取Schema对象。
    
    结果
    
    通过setSchema(Schema)方法最后设置的Schema对象，如果自创建SAXParserFactory以来未调用该方法，则为null。
    
    异常
    
    UnsupportedOperationException - 实现时不覆盖此方法
    
    从以下版本开始：
    
    1.5
  - setSchema
```
public void setSchema(Schema schema)
```
    将Schema设置为由此工厂创建的解析器使用。
    
    当一个Schema为非空值时，解析器将使用从其创建的验证器在将信息传递给应用程序之前验证文档。
    
    当验证器发现警告/错误/致命错误时，解析器必须处理它们，就像解析器本身发现这些错误一样。换句话说，如果设置了用户指定的ErrorHandler ，则必须收到这些错误，如果不是，则必须根据实现特定的默认错误处理规则进行处理。
    
    验证器可以修改SAX事件流（例如通过添加在文档中缺少的默认值），并且解析器负责确保应用程序将接收到修改的事件流。
    
    Initialy， null设为Schema 。
    
    即使isValidating()方法返回false此处理也将生效。
    
    将http://java.sun.com/xml/jaxp/properties/schemaSource属性和/或http://java.sun.com/xml/jaxp/properties/schemaLanguage属性与非空Schema对象结合使用是一个错误。当这些属性在SAXParser上设置时，此类配置将导致SAXException 异常。
    
    实施者注意事项
    
    解析器必须能够使用任何Schema实现。但是，解析器和模式允许使用实现特定的定制机制，只要它们产生规范中描述的结果即可。
    
    参数
    
    schema - Schema要使用， null删除一个模式。
    
    异常
    
    UnsupportedOperationException - 实现时不覆盖此方法
    
    从以下版本开始：
    
    1.5
  - setXIncludeAware
```
public void setXIncludeAware(boolean state)
```
    设置XInclude处理的状态。
    
    如果在文档实例中找到XInclude标记，则应按照XML Inclusions (XInclude) Version 1.0中的规定进行处理。
    
    XInclude处理默认为false 。
    
    参数
    
    state - 将XInclude处理设置为 true或 false
    
    异常
    
    UnsupportedOperationException - 实现时不覆盖此方法
    
    从以下版本开始：
    
    1.5
  - isXIncludeAware
```
public boolean isXIncludeAware()
```
    获取XInclude处理的状态。
    
    结果
    
    XInclude处理的当前状态
    
    异常
    
    UnsupportedOperationException - 当实现不覆盖此方法时
    
    从以下版本开始：
    
    1.5

Class SAXParserFactory

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

SAXParserFactory

方法详细信息

newInstance

提示进行故障排除

newInstance

提示进行故障排除

newSAXParser

setNamespaceAware

setValidating

isNamespaceAware

isValidating

setFeature

getFeature

getSchema

setSchema

实施者注意事项

setXIncludeAware

isXIncludeAware