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

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

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

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

XPathFactory класс не ориентирован на многопотоковое исполнение. Другими словами это - обязанность приложения гарантировать, что самое большее один поток использует 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` от имени класса фабрики.
`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)` Установите переменный преобразователь по умолчанию.

Методы 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 final XPathFactory newInstance()
```
    Получите новое XPathFactory экземпляр используя объектную модель по умолчанию, DEFAULT_OBJECT_MODEL_URI, W3C ДОМ.
    
    Этот метод функционально эквивалентен:
```
   newInstance(DEFAULT_OBJECT_MODEL_URI)
 
```
    Начиная с реализации для W3C ДОМ всегда доступен, этот метод никогда не перестанет работать.
    Возвраты:
    Экземпляр XPathFactory.
    
    Броски:
    
    RuntimeException - Когда есть отказ в создании XPathFactory для объектной модели по умолчанию.
  - newInstance
```
public static final XPathFactory newInstance(String uri)
                                      throws XPathFactoryConfigurationException
```
    Получите новое XPathFactory экземпляр используя указанную объектную модель.
    
    Найти a XPathFactory объект, этот метод смотрит следующие места в следующем порядке, где "загрузчик класса" обращается к загрузчику класса контекста:
    1. Если системное свойство DEFAULT_PROPERTY_NAME + ":uri" присутствует, где туры являются параметром к этому методу, тогда его значение читается как имя класса. Метод попытается создать новый экземпляр этого класса при использовании загрузчика класса, и возвращает это, если это будет успешно создаваться.
    2. $ {java.home}/lib/jaxp.properties читается, и значение, связанное с ключом, являющимся системным свойством выше, разыскивается. Если существующий, значение обрабатывается точно так же как выше.
    3. Загрузчик класса просят относительно соответствия конфигурационных файлов провайдера поставщика услуг javax.xml.xpath.XPathFactory в каталоге ресурса, META-INF/services. См. Спецификацию Файла JAR для формата файла и анализирующих правил. Каждый потенциальный поставщик услуг обязан реализовывать метод:
      isObjectModelSupported(String objectModel)
      Первый поставщик услуг, найденный в порядке загрузчика класса, который поддерживает указанную объектную модель, возвращается.
    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 от имени класса фабрики. XPathFactory возвращается, если определенный класс фабрики поддерживает указанную объектную модель. Эта функция полезна, когда есть многократные провайдеры в пути к классу. Это дает больше контроля к приложению, поскольку это может определить, какой провайдер должен быть загружен.
    
    Подсказка для Поиска и устранения неисправностей
    
    Установка 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 - полностью определенное имя класса фабрики, которое обеспечивает реализацию javax.xml.xpath.XPathFactory.
    classLoader - ClassLoader используемый, чтобы загрузить класс фабрики. Если null ток Thread's контекст classLoader используется, чтобы загрузить класс фабрики.
    
    Возвраты:
    Новый экземпляр a 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 и 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, 2011, Oracle и/или его филиалы. Все права защищены.

Класс XPathFactory

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

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

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

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

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

DEFAULT_PROPERTY_NAME

DEFAULT_OBJECT_MODEL_URI

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

XPathFactory

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

newInstance

newInstance

newInstance

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

isObjectModelSupported

setFeature

getFeature

setXPathVariableResolver

setXPathFunctionResolver

newXPath