XPathFactory (Java Platform SE 8 )

java.lang.Object
- javax.xml.xpath.XPathFactory

```
public abstract class XPathFactory
extends Object
```
一个XPathFactory实例可以用来创建XPath对象。

看到newInstance(String uri)查找机制。

XPathFactory类不是线程安全的。换句话说，它是应用程序的责任保证最多只有一个线程在任何时候使用XPathFactory对象。实施鼓励synchronized标记方法来保护自己从破碎的客户。

XPathFactory是不可重入。而其中的newInstance方法被调用时，应用程序可能不会尝试递归调用newInstance方法，即使在同一个线程。

从以下版本开始：

一点五

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`DEFAULT_OBJECT_MODEL_URI` 默认的对象模型的URI。
`static String`	`DEFAULT_PROPERTY_NAME` 根据使用的默认属性名称规格

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`XPathFactory()` 受保护的构造函数为 `newInstance()`或 `newInstance(String uri)`或 `newInstance(String uri, String factoryClassName, ClassLoader classLoader)`应该被用来创建一个新实例 `XPathFactory`。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract boolean`	`getFeature(String name)` 获取已命名的功能的状态。
`abstract boolean`	`isObjectModelSupported(String objectModel)` 指定对象模型的 `XPathFactory`支持？
`static XPathFactory`	`newInstance()` 得到一个新的 `XPathFactory`实例使用默认的对象模型， `DEFAULT_OBJECT_MODEL_URI`，W3C DOM。
`static XPathFactory`	`newInstance(String uri)` 使用指定的对象模型，得到一个新的 `XPathFactory`实例。
`static XPathFactory`	`newInstance(String uri, String factoryClassName, ClassLoader classLoader)` 获得从一个工厂类的新实例的名称 `XPathFactory`。
`abstract XPath`	`newXPath()` 返回一个新的 `XPath`使用底层对象模型时确定的 `XPathFactory`被实例化。
`abstract void`	`setFeature(String name, boolean value)` 设置这一 `XPathFactory`和 `XPath`s这个工厂创建的特征。
`abstract void`	`setXPathFunctionResolver(XPathFunctionResolver resolver)` 建立一个默认的功能解析。
`abstract void`	`setXPathVariableResolver(XPathVariableResolver resolver)` 建立一个默认的变量解析器。

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

- Field Detail
  - DEFAULT_PROPERTY_NAME
```
public static final String DEFAULT_PROPERTY_NAME
```
    根据使用的默认属性名称规格
    
    另请参见：
    
    Constant Field Values
  - DEFAULT_OBJECT_MODEL_URI
```
public static final String DEFAULT_OBJECT_MODEL_URI
```
    默认的对象模型的URI。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - XPathFactory
```
protected XPathFactory()
```
    受保护的构造函数为newInstance()或newInstance(String uri)或newInstance(String uri, String factoryClassName, ClassLoader classLoader)应该被用来创建一个新实例XPathFactory。
- 方法详细信息
  - newInstance
```
public static XPathFactory newInstance()
```
    得到一个新的XPathFactory实例使用默认的对象模型，DEFAULT_OBJECT_MODEL_URI，W3C DOM。
    
    此方法在功能上相当于：
```
newInstance（default_object_model_uri）
```
    由于W3C DOM的实现一直是可用的，这个方法永远不会失败。
    结果
    
    一个 XPathFactory实例。
    
    异常
    
    RuntimeException -出现故障时在创建默认的对象模型 XPathFactory。
  - newInstance
```
public static XPathFactory newInstance(String uri)
                                throws XPathFactoryConfigurationException
```
    使用指定的对象模型，得到一个新的XPathFactory实例。
    
    找到一个XPathFactory对象，这种方法看起来以下依次为“类装载器”指的是上下文类加载器的地方：
    1. 如果系统性能DEFAULT_PROPERTY_NAME +“URI”是存在的，其中的URI是这个方法的参数，那么它的价值是理解为一个类的名字。该方法将尝试使用类装载器来创建这个类的一个新实例，并返回它如果它成功创建。
    2. $ { java。家} / lib / jaxp.properties是阅读的关键是在系统属性关联的值是找。如果存在，值被处理就像上面一样。
    3. 使用服务提供商装载设施，由ServiceLoader类定义，试图定位和加载使用default loading mechanism服务的实现：服务提供者装载设备将使用current thread's context class loader尝试加载服务。如果上下文类加载器是空的，将使用的system class loader。
      每个潜在的服务供应商需要实现的方法isObjectModelSupported(String objectModel)。发现支持指定的对象模型的第一个服务提供程序返回。在一个XPathFactoryConfigurationException ServiceConfigurationError将抛出的情况下
      。
    4. 平台默认XPathFactory位于平台的具体方式。必须有一个W3C DOM平台默认xpathfactory，即DEFAULT_OBJECT_MODEL_URI。
    如果一切都失败了，一个XPathFactoryConfigurationException将抛出。
    
    解决问题的技巧：
    
    看到Properties.load(java.io.InputStream)究竟属性文件解析。特别是，冒号“：”需要在属性文件中逃脱，所以确保URI正确了它。例如:
```
HTTP：/ / java。太阳。COM /使用/ XPath和DOM = org.acme.domxpathfactory
```
    参数
    
    uri -识别潜在的对象模型。规范只定义了URI DEFAULT_OBJECT_MODEL_URI，为W3C DOM http://java.sun.com/jaxp/xpath/dom，的org.w3c.dom.Node包，并实现免费介绍其他URI的其他对象模型。
    
    结果
    
    一个 XPathFactory实例。
    
    异常
    
    XPathFactoryConfigurationException -如果指定的对象模型不可用，或者如果有配置错误。
    
    如果是 null uri NullPointerException。
    
    IllegalArgumentException -如果 uri是 null或 uri.length() == 0。
  - newInstance
```
public static XPathFactory newInstance(String uri,
                                       String factoryClassName,
                                       ClassLoader classLoader)
                                throws XPathFactoryConfigurationException
```
    获得从一个工厂类的新实例的名称XPathFactory。如果指定XPathFactory工厂类支持指定的对象模型返回。此功能是有用的当有多个供应商在类路径。它给应用程序提供了更多的控制，因为它可以指定要加载哪个提供程序。
    
    解决问题的技巧
    
    设置jaxp.debug系统属性将导致这种方法印制大量的调试消息System.err关于它是什么做的，是在看。
    
    如果你有问题的话：
```
java djaxp。调试= 1你的…
```
    参数
    
    uri -识别潜在的对象模型。规范只定义了URI DEFAULT_OBJECT_MODEL_URI，为W3C DOM http://java.sun.com/jaxp/xpath/dom，的org.w3c.dom.Node包，并实现免费介绍其他URI的其他对象模型。
    
    factoryClassName完全合格的工厂类的名称，提供了实现 javax.xml.xpath.XPathFactory。
    
    classLoader用于负荷工厂类 ClassLoader。如果 null电流 Thread上下文类加载器来加载工厂类。
    
    结果
    
    一个 XPathFactory新实例
    
    异常
    
    XPathFactoryConfigurationException -如果 factoryClassName是 null，或工厂类不能被加载，实例化或工厂类不支持的 uri参数指定的对象模型。
    
    如果是 null uri NullPointerException。
    
    IllegalArgumentException -如果 uri是 null或 uri.length() == 0。
    
    从以下版本开始：
    
    一点六
    
    另请参见：
    
    newInstance()， newInstance(String uri)
  - isObjectModelSupported
```
public abstract boolean isObjectModelSupported(String objectModel)
```
    指定对象模型的XPathFactory支持？
    
    参数
    
    objectModel -指定对象模型返回的 XPathFactory会理解的。
    
    结果
    
    true如果 XPathFactory支持 objectModel，其他 false。
    
    异常
    
    如果是 null objectModel NullPointerException。
    
    如果 objectModel.length() == 0 IllegalArgumentException。
  - setFeature
```
public abstract void setFeature(String name,
                                boolean value)
                         throws XPathFactoryConfigurationException
```
    设置这一XPathFactory和XPaths这个工厂创建的特征。
    
    功能名称是完全合格的URIs实现可以定义自己的功能。如果这是一个XPathFactoryConfigurationException XPathFactory或创建不支持特征的XPaths扔。一个XPathFactory暴露特征值，但不能改变它的状态，它是可能的。
    
    所有的实现都必须支持的XMLConstants.FEATURE_SECURE_PROCESSING特征。当特征是true，任何引用外部函数是一个错误。在这种情况下，必须执行，不叫XPathFunctionResolver必须抛出一个XPathFunctionException。
    
    参数
    
    name特征名称。
    
    value -特征状态 true或 false。
    
    异常
    
    XPathFactoryConfigurationException -如果这 XPathFactory也创造不支持此功能的 XPaths。
    
    如果是 null name NullPointerException。
  - getFeature
```
public abstract boolean getFeature(String name)
                            throws XPathFactoryConfigurationException
```
    获取已命名的功能的状态。
    
    功能名称是完全合格的URIs实现可以定义自己的功能。如果这是一个XPathFactoryConfigurationException XPathFactory或XPaths创建不支持特征扔。一个XPathFactory暴露特征值，但不能改变它的状态，它是可能的。
    
    参数
    
    name特征名称。
    
    结果
    
    命名特征的状态。
    
    异常
    
    XPathFactoryConfigurationException -如果这 XPathFactory或 XPaths它创造不支持此功能。
    
    如果是 null name NullPointerException。
  - setXPathVariableResolver
```
public abstract void setXPathVariableResolver(XPathVariableResolver resolver)
```
    建立一个默认的变量解析器。
    
    本厂建有XPath对象将使用默认指定的冲突解决程序。
    
    一个NullPointerException抛出如果resolver是null。
    
    参数
    
    resolver变量解析器。
    
    异常
    
    如果是 null resolver NullPointerException。
  - setXPathFunctionResolver
```
public abstract void setXPathFunctionResolver(XPathFunctionResolver resolver)
```
    建立一个默认的功能解析。
    
    本厂建有XPath对象将使用默认指定的冲突解决程序。
    
    如果一个NullPointerException resolver是null扔。
    
    参数
    
    resolver - XPath函数旋转变压器。
    
    异常
    
    如果是 null resolver NullPointerException。
  - newXPath
```
public abstract XPath newXPath()
```
    返回一个新的XPath使用底层对象模型时确定的XPathFactory被实例化。
    
    结果
    
    一个 XPath新实例。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class XPathFactory

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_PROPERTY_NAME

DEFAULT_OBJECT_MODEL_URI

Constructor Detail

XPathFactory

方法详细信息

newInstance

newInstance

newInstance

解决问题的技巧

isObjectModelSupported

setFeature

getFeature

setXPathVariableResolver

setXPathFunctionResolver

newXPath