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

java.lang. Объект
- javax.xml.parsers. DocumentBuilderFactory

```
public abstract class DocumentBuilderFactory
extends Object
```
Определяет API фабрики, который позволяет приложениям получить синтаксический анализатор, который производит деревья объекта ДОМА из XML-документов.

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

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`DocumentBuilderFactory()` Защищенный конструктор, чтобы предотвратить инстанцирование.

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

Методы
Модификатор и Тип	Метод и Описание
`abstract Object`	`getAttribute(String name)` Позволяет пользователю получать определенные атрибуты на базовой реализации.
`abstract boolean`	`getFeature(String name)` Получите состояние именованной функции.
`Схема`	`getSchema()` Добирается `Schema` объект, определенный через `setSchema(Schema schema)` метод.
`boolean`	`isCoalescing()` Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, который преобразовывает узлы CDATA в текстовые узлы и добавляет ее к смежному (если любой) текстовый узел.
`boolean`	`isExpandEntityReferences()` Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые разворачивают узлы ссылки на сущность.
`boolean`	`isIgnoringComments()` Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, который игнорирует комментарии.
`boolean`	`isIgnoringElementContentWhitespace()` Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые игнорируют игнорируемый пробел в контенте элемента.
`boolean`	`isNamespaceAware()` Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые являются знающим пространством имен.
`boolean`	`isValidating()` Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые проверяют контента XML во время синтаксического анализа.
`boolean`	`isXIncludeAware()` Получите состояние обработки XInclude.
`abstract DocumentBuilder`	`newDocumentBuilder()` Создает новый экземпляр a `DocumentBuilder` использование в настоящий момент сконфигурированных параметров.
`static DocumentBuilderFactory`	`newInstance()` Получите новый экземпляр a `DocumentBuilderFactory`.
`static DocumentBuilderFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)` Получите новый экземпляр a `DocumentBuilderFactory` от имени класса.
`abstract void`	`setAttribute(String name, Object value)` Позволяет пользователю устанавливать определенные атрибуты на базовой реализации.
`void`	`setCoalescing(boolean coalescing)` Определяет, что синтаксический анализатор, произведенный этим кодом, преобразует узлы CDATA в текстовые узлы и добавит его к смежному (если любой) текстовый узел.
`void`	`setExpandEntityReferences(boolean expandEntityRef)` Определяет, что синтаксический анализатор, произведенный этим кодом, развернет узлы ссылки на сущность.
`abstract void`	`setFeature(String name, boolean value)` Установите функцию этого `DocumentBuilderFactory` и `DocumentBuilder`s создаваемый этой фабрикой.
`void`	`setIgnoringComments(boolean ignoreComments)` Определяет, что синтаксический анализатор, произведенный этим кодом, проигнорирует комментарии.
`void`	`setIgnoringElementContentWhitespace(boolean whitespace)` Определяет, что синтаксические анализаторы, создаваемые этой фабрикой, должны устранить пробел в контенте элемента (иногда известный свободно как 'игнорируемый пробел'), анализируя XML-документы (см. XML Rec 2.10).
`void`	`setNamespaceAware(boolean awareness)` Определяет, что синтаксический анализатор, произведенный этим кодом, окажет поддержку для пространств имен XML.
`void`	`setSchema(Schema schema)` Установите `Schema` использоваться синтаксическими анализаторами, создаваемыми из этой фабрики.
`void`	`setValidating(boolean validating)` Определяет, что синтаксический анализатор, произведенный этим кодом, проверит документов, поскольку они анализируются.
`void`	`setXIncludeAware(boolean state)` Состояние набора обработки XInclude.

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

- Деталь конструктора
  - DocumentBuilderFactory
```
protected DocumentBuilderFactory()
```
    Защищенный конструктор, чтобы предотвратить инстанцирование. Использовать newInstance().
- Деталь метода
  - newInstance
```
public static DocumentBuilderFactory newInstance()
```
    Получите новый экземпляр a DocumentBuilderFactory. Этот статический метод создает новый экземпляр фабрики. Этот метод использует следующую упорядоченную процедуру поиска, чтобы определить DocumentBuilderFactory класс реализации загрузки:
    - Используйте javax.xml.parsers.DocumentBuilderFactory системное свойство.
    - Используйте файл свойств "lib/jaxp.properties" в каталоге JRE. Этот конфигурационный файл находится в стандарте java.util.Properties отформатируйте и содержит полностью определенное имя класса реализации с ключом, являющимся системным свойством, определенным выше. jaxp.properties файл только для чтения однажды реализацией JAXP, и это - значения, тогда кэшируются для будущего использования. Если файл не существует, когда первая попытка предпринимается, чтобы читать из него, никакие дальнейшие попытки не предпринимаются, чтобы проверить на ее существование. Не возможно изменить значение любого свойства в jaxp.properties после того, как это было считано впервые.
    - Используйте API Служб (как детализировано в спецификации JAR), при наличии, чтобы определить имя класса. API Служб будет искать имя класса в файле META-INF/services/javax.xml.parsers.DocumentBuilderFactory во флягах, доступных времени выполнения.
    - Значение по умолчанию платформы DocumentBuilderFactory экземпляр.
    Как только приложение получило ссылку на a DocumentBuilderFactory это может использовать фабрику, чтобы сконфигурировать и получить экземпляры синтаксического анализатора.
    Подсказка для Поиска и устранения неисправностей
    
    Установка jaxp.debug системное свойство заставит этот метод печатать много сообщений отладки к System.err о каком это делает и где это смотрит на.
    
    Если у Вас есть проблемы, загружаясь DocumentBuilders, попробуйте:
```
 java -Djaxp.debug=1 YourProgram ....
 
```
    Возвраты:
    Новый экземпляр a DocumentBuilderFactory
    
    Броски:
    
    FactoryConfigurationError - если реализация не доступна или не может быть инстанцирована.
  - newInstance
```
public static DocumentBuilderFactory newInstance(String factoryClassName,
                                 ClassLoader classLoader)
```
    Получите новый экземпляр a DocumentBuilderFactory от имени класса. Эта функция полезна, когда есть многократные провайдеры в пути к классу. Это дает больше контроля к приложению, поскольку это может определить, какой провайдер должен быть загружен.
    
    Как только приложение получило ссылку на a DocumentBuilderFactory это может использовать фабрику, чтобы сконфигурировать и получить экземпляры синтаксического анализатора.
    
    Подсказка для Поиска и устранения неисправностей
    
    Установка jaxp.debug системное свойство заставит этот метод печатать много сообщений отладки к System.err о каком это делает и где это смотрит на.
    
    Если у Вас есть попытка задач:
```
 java -Djaxp.debug=1 YourProgram ....
 
```
    Параметры:
    factoryClassName - полностью определенное имя класса фабрики, которое обеспечивает реализацию javax.xml.parsers.DocumentBuilderFactory.
    classLoader - ClassLoader используемый, чтобы загрузить класс фабрики. Если null ток Thread's контекст classLoader используется, чтобы загрузить класс фабрики.
    
    Возвраты:
    Новый экземпляр a DocumentBuilderFactory
    
    Броски:
    
    FactoryConfigurationError - если factoryClassName null, или класс фабрики не может быть загружен, инстанцирован.
    С тех пор:
    
    1.6
    
    См. Также:
    newInstance()
  - newDocumentBuilder
```
public abstract DocumentBuilder newDocumentBuilder()
                                            throws ParserConfigurationException
```
    Создает новый экземпляр a DocumentBuilder использование в настоящий момент сконфигурированных параметров.
    
    Возвраты:
    Новый экземпляр DocumentBuilder.
    
    Броски:
    
    ParserConfigurationException - если DocumentBuilder не может быть создан, который удовлетворяет конфигурацию, которую требуют.
  - setNamespaceAware
```
public void setNamespaceAware(boolean awareness)
```
    Определяет, что синтаксический анализатор, произведенный этим кодом, окажет поддержку для пространств имен XML. По умолчанию значение этого устанавливается в false
    
    Параметры:
    awareness - истина, если произведенный синтаксический анализатор окажет поддержку для пространств имен XML; ложь иначе.
  - setValidating
```
public void setValidating(boolean validating)
```
    Определяет, что синтаксический анализатор, произведенный этим кодом, проверит документов, поскольку они анализируются. По умолчанию значение этого устанавливается в false.
    Отметьте, что "проверка допустимости" здесь означает синтаксический анализатор проверки допустимости как определено в рекомендации XML. Другими словами это по существу только управляет проверкой допустимости DTD. (кроме наследства два свойства, определенные в JAXP 1.2.)
    
    Чтобы использовать современные языки схемы, такие как XML-схема W3C или ОСЛАБИТЬ НАНОГРАММ вместо DTD, можно сконфигурировать свой синтаксический анализатор, чтобы быть синтаксическим анализатором непроверки допустимости, уезжая setValidating(boolean) метод false, тогда используйте setSchema(Schema) метод, чтобы связать схему к синтаксическому анализатору.
    
    Параметры:
    validating - истина, если произведенный синтаксический анализатор проверит документов, поскольку они анализируются; ложь иначе.
  - setIgnoringElementContentWhitespace
```
public void setIgnoringElementContentWhitespace(boolean whitespace)
```
    Определяет, что синтаксические анализаторы, создаваемые этой фабрикой, должны устранить пробел в контенте элемента (иногда известный свободно как 'игнорируемый пробел'), анализируя XML-документы (см. XML Rec 2.10). Отметьте, что только пробел, который непосредственно содержится в пределах контента элемента, у которого есть элемент только модель контента (см. XML Rec 3.2.1) будет устранен. Из-за уверенности в модели контента эта установка требует, чтобы синтаксический анализатор был в проверке допустимости режима. По умолчанию значение этого устанавливается в false.
    
    Параметры:
    whitespace - истина, если создаваемый синтаксический анализатор должен устранить пробел в контенте элемента, анализируя XML-документы; ложь иначе.
  - setExpandEntityReferences
```
public void setExpandEntityReferences(boolean expandEntityRef)
```
    Определяет, что синтаксический анализатор, произведенный этим кодом, развернет узлы ссылки на сущность. По умолчанию значение этого устанавливается в true
    
    Параметры:
    expandEntityRef - истина, если произведенный синтаксический анализатор развернет узлы ссылки на сущность; ложь иначе.
  - setIgnoringComments
```
public void setIgnoringComments(boolean ignoreComments)
```
    Определяет, что синтаксический анализатор, произведенный этим кодом, проигнорирует комментарии. По умолчанию значение этого устанавливается в false .
    
    Параметры:
    ignoreComments - boolean значение, чтобы проигнорировать комментарии во время обработки
  - setCoalescing
```
public void setCoalescing(boolean coalescing)
```
    Определяет, что синтаксический анализатор, произведенный этим кодом, преобразует узлы CDATA в текстовые узлы и добавит его к смежному (если любой) текстовый узел. По умолчанию значение этого устанавливается в false
    
    Параметры:
    coalescing - истина, если произведенный синтаксический анализатор преобразует узлы CDATA в текстовые узлы и добавит это к смежному (если кто-либо) текстовый узел; ложь иначе.
  - isNamespaceAware
```
public boolean isNamespaceAware()
```
    Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые являются знающим пространством имен.
    
    Возвраты:
    истина, если фабрика конфигурируется, чтобы произвести синтаксические анализаторы, которые являются знающим пространством имен; ложь иначе.
  - isValidating
```
public boolean isValidating()
```
    Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые проверяют контента XML во время синтаксического анализа.
    
    Возвраты:
    истина, если фабрика конфигурируется, чтобы произвести синтаксические анализаторы, которые проверяют контента XML во время синтаксического анализа; ложь иначе.
  - isIgnoringElementContentWhitespace
```
public boolean isIgnoringElementContentWhitespace()
```
    Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые игнорируют игнорируемый пробел в контенте элемента.
    
    Возвраты:
    истина, если фабрика конфигурируется, чтобы произвести синтаксические анализаторы, которые игнорируют игнорируемый пробел в контенте элемента; ложь иначе.
  - isExpandEntityReferences
```
public boolean isExpandEntityReferences()
```
    Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые разворачивают узлы ссылки на сущность.
    
    Возвраты:
    истина, если фабрика конфигурируется, чтобы произвести синтаксические анализаторы, которые разворачивают узлы ссылки на сущность; ложь иначе.
  - isIgnoringComments
```
public boolean isIgnoringComments()
```
    Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, который игнорирует комментарии.
    
    Возвраты:
    истина, если фабрика конфигурируется, чтобы произвести синтаксические анализаторы, который игнорирует комментарии; ложь иначе.
  - isCoalescing
```
public boolean isCoalescing()
```
    Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, который преобразовывает узлы CDATA в текстовые узлы и добавляет ее к смежному (если любой) текстовый узел.
    
    Возвраты:
    истина, если фабрика конфигурируется, чтобы произвести синтаксические анализаторы, который преобразовывает узлы CDATA в текстовые узлы и добавляет это к смежному (если любой) текстовый узел; ложь иначе.
  - setAttribute
```
public abstract void setAttribute(String name,
                Object value)
                           throws IllegalArgumentException
```
    Позволяет пользователю устанавливать определенные атрибуты на базовой реализации.
    
    Параметры:
    name - Имя атрибута.
    value - Значение атрибута.
    
    Броски:
    
    IllegalArgumentException - брошенный, если базовая реализация не распознает атрибут.
  - getAttribute
```
public abstract Object getAttribute(String name)
                             throws IllegalArgumentException
```
    Позволяет пользователю получать определенные атрибуты на базовой реализации.
    
    Параметры:
    name - Имя атрибута.
    
    Возвраты:
    оцените значение атрибута.
    
    Броски:
    
    IllegalArgumentException - брошенный, если базовая реализация не распознает атрибут.
  - setFeature
```
public abstract void setFeature(String name,
              boolean value)
                         throws ParserConfigurationException
```
    Установите функцию этого DocumentBuilderFactory и DocumentBuilders создаваемый этой фабрикой.
    
    Имена функции полностью определяются URIs. Реализации могут определить свои собственные функции. A ParserConfigurationException бросается если это DocumentBuilderFactory или DocumentBuilders это создает, не может поддерживать функцию. Это возможно для a DocumentBuilderFactory представить значение функции, но быть неспособными изменить его состояние.
    
    Все реализации обязаны поддерживать XMLConstants.FEATURE_SECURE_PROCESSING функция. Когда функция:
    - true: реализация ограничит обработку XML, чтобы соответствовать пределам реализации. Примеры включают enity пределы расширения и конструкции XML-схемы, которые использовали бы большое количество ресурсов. Если обработка XML будет ограничена для соображений безопасности, то о ней сообщат через звонок в зарегистрированный ErrorHandler.fatalError(SAXParseException exception). См. DocumentBuilder.setErrorHandler(org.xml.sax.ErrorHandler errorHandler).
    - false: реализация будет, обрабатывая XML согласно спецификациям XML без отношения к возможным пределам реализации.
    Параметры:
    name - Имя функции.
    value - Состояние функции true или false.
    
    Броски:
    
    ParserConfigurationException - если это DocumentBuilderFactory или DocumentBuilders это создает, не может поддерживать эту функцию.
    
    NullPointerException - Если name параметр является нулем.
  - getFeature
```
public abstract boolean getFeature(String name)
                            throws ParserConfigurationException
```
    Получите состояние именованной функции.
    
    Имена функции полностью определяются URIs. Реализации могут определить свои собственные функции. ParserConfigurationException бросается если это DocumentBuilderFactory или DocumentBuilders это создает, не может поддерживать функцию. Это возможно для DocumentBuilderFactory представить значение функции, но быть неспособными изменить его состояние.
    
    Параметры:
    name - Имя функции.
    
    Возвраты:
    Государство именованной функции.
    
    Броски:
    
    ParserConfigurationException - если это DocumentBuilderFactory или DocumentBuilders это создает, не может поддерживать эту функцию.
  - getSchema
```
public Schema getSchema()
```
    Добирается Schema объект, определенный через setSchema(Schema schema) метод.
    
    Возвраты:
    Schema объект, который был последним набором через setSchema(Schema) метод, или нуль, если метод не был вызван с тех пор a DocumentBuilderFactory создается.
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод.
    С тех пор:
    
    1.5
  - setSchema
```
public void setSchema(Schema schema)
```
    Установите Schema использоваться синтаксическими анализаторами, создаваемыми из этой фабрики.
    Когда a Schema ненуль, синтаксический анализатор будет использовать блок проверки допустимости, создаваемый из него, чтобы проверить документов прежде, чем он передаст информацию к приложению.
    Когда ошибки находятся блоком проверки допустимости, синтаксический анализатор ответственен, чтобы сообщить о них определенному пользователем ErrorHandler (или если обработчик ошибок не устанавливается, проигнорируйте их или бросьте их), точно так же как любые другие ошибки, найденные синтаксическим анализатором непосредственно. Другими словами, если определенный пользователем ErrorHandler устанавливается, это должно получить те ошибки, и в противном случае они должны быть обработаны согласно реализации определенные правила обработки ошибок по умолчанию.
    Блок проверки допустимости может изменить результат синтаксического анализа (например, добавляя значения по умолчанию, которые отсутствовали в документах), и синтаксический анализатор ответственен, чтобы удостовериться, что приложение получит, изменил деревья ДОМА.
    Initialy, нуль устанавливается как Schema.
    Эта обработка вступит в силу даже если isValidating() возвраты метода false.
    Это - ошибка использовать http://java.sun.com/xml/jaxp/properties/schemaSource свойство и/или http://java.sun.com/xml/jaxp/properties/schemaLanguage свойство в соединении с a Schema объект. Такая конфигурация вызовет a ParserConfigurationException исключение, когда newDocumentBuilder() вызывается.
    
    Отметьте implmentors
    
    Синтаксический анализатор должен быть в состоянии работать с любым Schema реализация. Однако, синтаксическим анализаторам и схемам позволяют использовать специфичные для реализации пользовательские механизмы, пока они приводят к результату, описанному в спецификации.
    
    Параметры:
    schema - Schema использовать или null удалить схему.
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод.
    С тех пор:
    
    1.5
  - setXIncludeAware
```
public void setXIncludeAware(boolean state)
```
    Состояние набора обработки XInclude.
    
    Если разметка XInclude находится в экземпляре документа, должен это обрабатываться как определено во Включениях XML (XInclude) Версия 1.0.
    
    XInclude обработка значений по умолчанию к false.
    
    Параметры:
    state - Набор XInclude, обрабатывающий к true или false
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод.
    С тех пор:
    
    1.5
  - isXIncludeAware
```
public boolean isXIncludeAware()
```
    Получите состояние обработки XInclude.
    
    Возвраты:
    текущее состояние обработки XInclude
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод.
    С тех пор:
    
    1.5

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

Класс DocumentBuilderFactory

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

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

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

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

DocumentBuilderFactory

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

newInstance

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

newInstance

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

newDocumentBuilder

setNamespaceAware

setValidating

setIgnoringElementContentWhitespace

setExpandEntityReferences

setIgnoringComments

setCoalescing

isNamespaceAware

isValidating

isIgnoringElementContentWhitespace

isExpandEntityReferences

isIgnoringComments

isCoalescing

setAttribute

getAttribute

setFeature

getFeature

getSchema

setSchema

Отметьте implmentors

setXIncludeAware

isXIncludeAware