字段详细信息

• DEFAULT_PROPERTY_NAME

  public static final String DEFAULT_PROPERTY_NAME

  根据JAXP规范的默认属性名称。

  另请参见：

  常数字段值

• DEFAULT_OBJECT_MODEL_URI

  public static final String DEFAULT_OBJECT_MODEL_URI

  默认对象模型URI。

  另请参见：

  常数字段值

构造方法详细信息

• XPathFactory

  protected XPathFactory()

  应使用受保护的构造函数newInstance()或newInstance(String uri)或newInstance(String uri, String factoryClassName, ClassLoader classLoader)来创建XPathFactory的新实例。

方法详细信息

• newDefaultInstance

  public static XPathFactory newDefaultInstance()

  创建 XPathFactory内置系统默认实现的新实例。

  实现要求：

  该 XPathFactory内置系统默认的实现只需要支持 default object model ，该 W3C DOM ，但可能支持额外的对象模型。

  结果

  XPathFactory内置系统默认实现的新实例。

  从以下版本开始：

  9

• newInstance

  public static XPathFactory newInstance()

  使用默认对象模型DEFAULT_OBJECT_MODEL_URI （W3C DOM）获取新的XPathFactory实例。

  此方法在功能上等同于：

    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. 使用配置文件“jaxp.properties”。 该文件采用标准Properties格式，通常位于Java安装的conf目录中。 它包含实现类的完全限定名称，键是上面定义的系统属性。

     jaxp.properties文件只能由JAXP实现读取一次，然后缓存其值以供将来使用。 如果在第一次尝试从该文件读取时该文件不存在，则不再进行任何检查以检查其是否存在。 在第一次读取之后，无法更改jaxp.properties中任何属性的值。

  3. 使用服务提供商装载设施，由定义ServiceLoader类，试图找到并使用加载服务的实现default loading mechanism ：服务提供商装载设施将使用current thread's context class loader试图加载的服务。 如果上下文类加载器为null，则将使用system class loader 。
     每个潜在的服务提供商都需要实施方法isObjectModelSupported(String objectModel) 。 找到支持指定对象模型的第一个服务提供者。
     如果是ServiceConfigurationError ，则会抛出XPathFactoryConfigurationException 。

  4. 平台默认XPathFactory位于特定于平台的方式中。 对于W3C DOM，必须有platform default XPathFactory ，即DEFAULT_OBJECT_MODEL_URI 。

  如果一切都失败了，将抛出一个XPathFactoryConfigurationException 。

  故障排除提示：

  有关如何解析属性文件的信息，请参阅Properties.load(java.io.InputStream) 。 特别是，冒号'：'需要在属性文件中进行转义，因此请确保在其中正确转义URI。 例如：

    http\://java.sun.com/jaxp/xpath/dom=org.acme.DomXPathFactory 

  参数

  uri - 标识基础对象模型。 本说明书中只定义了URI DEFAULT_OBJECT_MODEL_URI ， http://java.sun.com/jaxp/xpath/dom为W3C DOM，org.w3c.dom包，和实施方式可以自由地引入其他的URI其他对象模型。

  结果

  实例 XPathFactory 。

  异常

  XPathFactoryConfigurationException - 如果指定的对象模型不可用，或者存在配置错误。

  NullPointerException - 如果 uri是 null 。

  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.debug=1 YourProgram .... 

  参数

  uri - 标识基础对象模型。 本说明书中只定义了URI DEFAULT_OBJECT_MODEL_URI ， http://java.sun.com/jaxp/xpath/dom为W3C DOM，org.w3c.dom包，和实施方式可以自由地引入其他的URI其他对象模型。

  factoryClassName - 提供 javax.xml.xpath.XPathFactory实现的完全限定工厂类名称。

  classLoader - ClassLoader用于加载工厂类。 如果null当前Thread的上下文classLoader用于加载工厂类。

  结果

  XPathFactory新实例

  异常

  XPathFactoryConfigurationException - 如果 factoryClassName是 null ，或者无法加载，实例化工厂类或工厂类不支持 uri参数中指定的对象模型。

  NullPointerException - 如果 uri是 null 。

  IllegalArgumentException - 如果 uri是 null或 uri.length() == 0 。

  从以下版本开始：

  1.6

  另请参见：

  newInstance() ， newInstance(String uri)

• isObjectModelSupported

  public abstract boolean isObjectModelSupported​(String objectModel)

  此XPathFactory是否支持指定的对象模型？

  参数

  objectModel - 指定返回的 XPathFactory将理解的对象模型。

  结果

  true如果 XPathFactory支持 objectModel ，其他 false 。

  异常

  NullPointerException - 如果 objectModel是 null 。

  IllegalArgumentException - 如果是 objectModel.length() == 0 。

• setFeature

  public abstract void setFeature​(String name,
                                  boolean value)
                           throws XPathFactoryConfigurationException

  设置此工厂创建的XPathFactory和XPath的功能。

  功能名称是完全限定的URI 。 实现可以定义自己的功能。 一个XPathFactoryConfigurationException如果这是抛出XPathFactory或XPath的IT创建不支持该功能。 XPathFactory可能会公开特征值但无法更改其状态。

  所有实现都需要支持XMLConstants.FEATURE_SECURE_PROCESSING功能。 当该功能为true ，对外部函数的任何引用都是错误。 在这些条件下，实现不得调用XPathFunctionResolver并且必须抛出XPathFunctionException 。

  参数

  name - 功能名称。

  value - 功能状态为 true或 false 。

  异常

  XPathFactoryConfigurationException - 如果这个 XPathFactory或它创建的 XPath不能支持此功能。

  NullPointerException - 如果 name是 null 。

• getFeature

  public abstract boolean getFeature​(String name)
                              throws XPathFactoryConfigurationException

  获取指定功能的状态。

  功能名称完全限定URI 。 实现可以定义自己的功能。 一个XPathFactoryConfigurationException如果这是抛出XPathFactory或XPath的IT创建不支持该功能。 XPathFactory可能会公开特征值但无法更改其状态。

  参数

  name - 功能名称。

  结果

  命名功能的状态。

  异常

  XPathFactoryConfigurationException - 如果这个 XPathFactory或它创建的 XPath不能支持此功能。

  NullPointerException - 如果 name是 null 。

• setXPathVariableResolver

  public abstract void setXPathVariableResolver​(XPathVariableResolver resolver)

  建立默认变量解析器。

  从该工厂构造的任何XPath对象将默认使用指定的解析程序。

  一个NullPointerException如果抛出resolver为null 。

  参数

  resolver - 可变解析器。

  异常

  NullPointerException - 如果 resolver是 null 。

• setXPathFunctionResolver

  public abstract void setXPathFunctionResolver​(XPathFunctionResolver resolver)

  建立默认函数解析器。

  从该工厂构造的任何XPath对象将默认使用指定的解析程序。

  一个NullPointerException如果抛出resolver为null 。

  参数

  resolver - XPath函数解析器。

  异常

  NullPointerException - 如果 resolver是 null 。

• newXPath

  public abstract XPath newXPath()

  使用在实例化XPathFactory时确定的基础对象模型返回新的XPath 。

  结果

  XPath新实例。