XPathFactory (Платформа Java SE 8 b92)

java.lang. Объект
- javax.xml.xpath. XPathFactory

```
public abstract class XPathFactory
extends Object
```
XPathFactory экземпляр может использоваться, чтобы создать XPath объекты.

См. newInstance(String uri) для механизма поиска.

XPathFactory class не ориентирован на многопотоковое исполнение. Другими словами это - обязанность приложения гарантировать, что самое большее один поток использует a XPathFactory объект в любой данный момент. Реализации поощряются отметить методы как synchronized защищать себя от поврежденных клиентов.
XPathFactory не повторно используемо. В то время как один из newInstance методы вызываются, приложения, возможно, не пытаются рекурсивно вызвать a newInstance метод, даже от того же самого потока.

С тех пор:

1.5

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static String`	`DEFAULT_OBJECT_MODEL_URI` URI Объектной модели значения по умолчанию.
`static String`	`DEFAULT_PROPERTY_NAME` Свойство значения по умолчанию называет согласно спецификации JAXP.

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`XPathFactory()` Защищенный конструктор как `newInstance()` или `newInstance(String uri)` или `newInstance(String uri, String factoryClassName, ClassLoader classLoader)` должен использоваться, чтобы создать новый экземпляр `XPathFactory`.

Сводка метода

Все Методы Статические Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`abstract boolean`	`getFeature(String name)` Получите состояние именованной функции.
`abstract boolean`	`isObjectModelSupported(String objectModel)` Определенная объектная модель, поддерживаемая этим `XPathFactory`?
`static XPathFactory`	`newInstance()` Получите новое `XPathFactory` экземпляр используя объектную модель значения по умолчанию, `DEFAULT_OBJECT_MODEL_URI`, W3C ДОМ.
`static XPathFactory`	`newInstance(String uri)` Получите новое `XPathFactory` экземпляр используя указанную объектную модель.
`static XPathFactory`	`newInstance(String uri, String factoryClassName, ClassLoader classLoader)` Получите новый экземпляр a `XPathFactory` от фабрики имя class.
`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)` Установите преобразователь переменной значения по умолчанию.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - 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.
- Деталь метода
  - newInstance
```
public static XPathFactory newInstance()
```
    Получите новое XPathFactory экземпляр используя объектную модель значения по умолчанию, DEFAULT_OBJECT_MODEL_URI, W3C ДОМ.
    
    Этот метод функционально эквивалентен:
```
   newInstance(DEFAULT_OBJECT_MODEL_URI)
 
```
    Начиная с реализации для W3C ДОМ всегда доступен, этот метод никогда не перестанет работать.
    Возвраты:
    
    Экземпляр XPathFactory.
    
    Броски:
    
    RuntimeException - Когда есть отказ в создании XPathFactory для объектной модели значения по умолчанию.
  - newInstance
```
public static XPathFactory newInstance(String uri)
                                throws XPathFactoryConfigurationException
```
    Получите новое XPathFactory экземпляр используя указанную объектную модель.
    
    Найти a XPathFactory объект, этот метод смотрит следующие места в следующем порядке, где "загрузчик class" отсылает к контексту загрузчик class:
    1. Если системное свойство DEFAULT_PROPERTY_NAME + ":uri" присутствует, где туры являются параметром к этому методу, тогда его значение читается как имя class. Метод попытается создать новый экземпляр этого class при использовании загрузчика class, и возвращает это, если это будет успешно создаваться.
    2. $ {java.home}/lib/jaxp.properties читается, и значение, связанное с ключом, являющимся системным свойством выше, разыскивается. Если существующий, значение обрабатывается точно так же как выше.
    3. Используйте средства загрузки поставщика услуг, определенные ServiceLoader class, чтобы попытаться расположиться и загрузить реализацию службы.
      Каждый потенциальный поставщик услуг обязан реализовывать метод isObjectModelSupported(String objectModel). Первый поставщик услуг, найденный этим, поддерживает указанную объектную модель, возвращается.
      В случае ServiceConfigurationError XPathFactoryConfigurationException будет брошен.
    4. Значение по умолчанию платформы XPathFactory располагается в особенном методе платформы. Должно быть значение по умолчанию платформы XPathFactory для W3C ДОМ, то есть. 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 ДОМ, 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
```
    Получите новый экземпляр a XPathFactory от фабрики имя class. XPathFactory возвращается, если определенная фабрика class поддерживает указанную объектную модель. Эта функция полезна, когда есть многократные провайдеры в пути к классу. Это дает больше контроля к приложению, поскольку это может определить, какой провайдер должен быть загружен.
    
    Подсказка для Поиска и устранения неисправностей
    
    Установка jaxp.debug системное свойство заставит этот метод печатать много сообщений отладки к System.err о каком это делает и где это смотрит на.
    
    Если у Вас есть попытка задач:
```
 java -Djaxp.debug=1 YourProgram ....
 
```
    Параметры:
    
    uri - Идентифицирует базовую объектную модель. Спецификация только определяет URI DEFAULT_OBJECT_MODEL_URI,http://java.sun.com/jaxp/xpath/dom для W3C ДОМ, org.w3c.dom пакет, и реализации свободны представить другие URI для других объектных моделей.
    
    factoryClassName - полностью определенное имя class фабрики, которое обеспечивает реализацию javax.xml.xpath.XPathFactory.
    
    classLoader - ClassLoader используемый, чтобы загрузить фабрику class. Если null ток Thread's контекст classLoader используется, чтобы загрузить фабрику class.
    
    Возвраты:
    
    Новый экземпляр a XPathFactory
    
    Броски:
    
    XPathFactoryConfigurationException - если factoryClassName null, или фабрика, class не может быть загружен, инстанцирован или фабрика class, не поддерживает объектную модель, определенную в 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 и XPaths создаваемый этой фабрикой.
    
    Имена функции полностью определяются URIs. Реализации могут определить свои собственные функции. XPathFactoryConfigurationException бросается если это XPathFactory или XPaths это создает, не может поддерживать функцию. Это возможно для XPathFactory представить значение функции, но быть неспособными изменить его состояние.
    
    Все реализации обязаны поддерживать XMLConstants.FEATURE_SECURE_PROCESSING функция. Когда функция true, любая ссылка на внешнюю функцию является ошибкой. При этих условиях реализация не должна вызвать XPathFunctionResolver и должен бросить XPathFunctionException.
    
    Параметры:
    
    name - Имя функции.
    
    value - Состояние функции true или false.
    
    Броски:
    
    XPathFactoryConfigurationException - если это XPathFactory или XPaths это создает, не может поддерживать эту функцию.
    
    NullPointerException - если name null.
  - getFeature
```
public abstract boolean getFeature(String name)
                            throws XPathFactoryConfigurationException
```
    Получите состояние именованной функции.
    
    Имена функции полностью определяются URIs. Реализации могут определить свои собственные функции. XPathFactoryConfigurationException бросается если это XPathFactory или XPaths это создает, не может поддерживать функцию. Это возможно для XPathFactory представить значение функции, но быть неспособными изменить его состояние.
    
    Параметры:
    
    name - Имя функции.
    
    Возвраты:
    
    Государство именованной функции.
    
    Броски:
    
    XPathFactoryConfigurationException - если это XPathFactory или XPaths это создает, не может поддерживать эту функцию.
    
    NullPointerException - если name null.
  - setXPathVariableResolver
```
public abstract void setXPathVariableResolver(XPathVariableResolver resolver)
```
    Установите преобразователь переменной значения по умолчанию.
    
    Любой XPath объекты, созданные из этой фабрики, будут использовать указанный преобразователь по умолчанию.
    
    A NullPointerException бросается если resolver null.
    
    Параметры:
    
    resolver - Переменный преобразователь.
    
    Броски:
    
    NullPointerException - Если resolver null.
  - setXPathFunctionResolver
```
public abstract void setXPathFunctionResolver(XPathFunctionResolver resolver)
```
    Установите преобразователь функции значения по умолчанию.
    
    Любой XPath объекты, созданные из этой фабрики, будут использовать указанный преобразователь по умолчанию.
    
    A NullPointerException бросается если resolver null.
    
    Параметры:
    
    resolver - Преобразователь функции XPath.
    
    Броски:
    
    NullPointerException - Если resolver null.
  - newXPath
```
public abstract XPath newXPath()
```
    Возвратите новое XPath использование базовой объектной модели, определенной, когда XPathFactory был инстанцирован.
    
    Возвраты:
    
    Новый экземпляр XPath.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс XPathFactory

Полевая Сводка

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Полевая Деталь

DEFAULT_PROPERTY_NAME

DEFAULT_OBJECT_MODEL_URI

Деталь конструктора

XPathFactory

Деталь метода

newInstance

newInstance

newInstance

Подсказка для Поиска и устранения неисправностей

isObjectModelSupported

setFeature

getFeature

setXPathVariableResolver

setXPathFunctionResolver

newXPath