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

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

```
public abstract class DocumentBuilder
extends Object
```
Определяет API, чтобы получить экземпляры ДОМА Докьюмнта из XML-документа. Используя этот класс, прикладной программист может получить a Document из XML.
Экземпляр этого класса может быть получен из DocumentBuilderFactory.newDocumentBuilder() метод. Как только экземпляр этого класса получается, XML может быть проанализирован от множества входных источников. Этими входными источниками является InputStreams, Файлы, URL, и SAX InputSources.
Отметьте что этот класс повторные использования несколько классов от API SAX. Это не требует, чтобы конструктор базовой реализации ДОМА использовал синтаксический анализатор SAX, чтобы проанализировать XML-документ в a Document. Это просто требует, чтобы реализация связалась с приложением, используя эти существующие API.

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

Конструкторы
Модификатор Конструктор и Описание

protected DocumentBuilder()
Защищенный конструктор

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`DocumentBuilder()` Защищенный конструктор

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

Методы
Модификатор и Тип	Метод и Описание
`abstract DOMImplementation`	`getDOMImplementation()` Получите экземпляр a `DOMImplementation` объект.
`Схема`	`getSchema()` Получите ссылку на `Schema` будучи используемым процессором XML.
`abstract boolean`	`isNamespaceAware()` Указывает, конфигурируется ли этот синтаксический анализатор, чтобы понять пространства имен.
`abstract boolean`	`isValidating()` Указывает, конфигурируется ли этот синтаксический анализатор, чтобы проверить XML-документов.
`boolean`	`isXIncludeAware()` Получите XInclude обработка режима для этого синтаксического анализатора.
`abstract Document`	`newDocument()` Получите новый экземпляр ДОМА `Document` возразите, чтобы создать дерево ДОМА с.
`Документ`	`parse(File f)` Проанализируйте контент данного файла как XML-документ и возвратите нового ДОМА `Document` объект.
`abstract Document`	`parse(InputSource is)` Проанализируйте контент данного входного источника как XML-документ и возвратите нового ДОМА `Document` объект.
`Документ`	`parse(InputStream is)` Проанализируйте контент данного `InputStream` как XML-документ и возврат новый ДОМ `Document` объект.
`Документ`	`parse(InputStream is, String systemId)` Проанализируйте контент данного `InputStream` как XML-документ и возврат новый ДОМ `Document` объект.
`Документ`	`parse(String uri)` Проанализируйте контент данного URI как XML-документ и возвратите нового ДОМА `Document` объект.
`void`	`reset()` Сбросьте это `DocumentBuilder` к его исходной конфигурации.
`abstract void`	`setEntityResolver(EntityResolver er)` Определите `EntityResolver` использоваться, чтобы разрешить объекты, существующие в XML-документе, который будет проанализирован.
`abstract void`	`setErrorHandler(ErrorHandler eh)` Определите `ErrorHandler` использоваться синтаксическим анализатором.

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

- Деталь конструктора
  - DocumentBuilder
```
protected DocumentBuilder()
```
    Защищенный конструктор
- Деталь метода
  - сброс
```
public void reset()
```
    Сбросьте это DocumentBuilder к его исходной конфигурации.
    
    DocumentBuilder сбрасывается к тому же самому состоянию как тогда, когда оно создавалось с DocumentBuilderFactory.newDocumentBuilder(). reset() разрабатывается, чтобы позволить повторное использование существующих DocumentBuilders таким образом сохраняющий ресурсы, связанные с созданием новых DocumentBuilders.
    
    Сброс DocumentBuilder как гарантируют, не будет иметь то же самое EntityResolver или ErrorHandler Objects, например. Object.equals(Object obj). Это, как гарантируют, будет иметь функционально равный EntityResolver и ErrorHandler.
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод.
    С тех пор:
    
    1.5
  - синтаксический анализ
```
public Document parse(InputStream is)
               throws SAXException,
                      IOException
```
    Проанализируйте контент данного InputStream как XML-документ и возврат новый ДОМ Document объект. IllegalArgumentException бросается если InputStream нуль.
    
    Параметры:
    is - InputStream, содержащий контент, который будет проанализирован.
    
    Возвраты:
    Document результат парсинга InputStream
    
    Броски:
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки синтаксического анализа происходят.
    
    IllegalArgumentException - Когда is null
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public Document parse(InputStream is,
             String systemId)
               throws SAXException,
                      IOException
```
    Проанализируйте контент данного InputStream как XML-документ и возврат новый ДОМ Document объект. IllegalArgumentException бросается если InputStream нуль.
    
    Параметры:
    is - InputStream, содержащий контент, который будет проанализирован.
    systemId - Обеспечьте основу для того, чтобы она разрешила относительные URI.
    
    Возвраты:
    Новый объект ДОМА Докьюмнта.
    
    Броски:
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки синтаксического анализа происходят.
    
    IllegalArgumentException - Когда is null
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public Document parse(String uri)
               throws SAXException,
                      IOException
```
    Проанализируйте контент данного URI как XML-документ и возвратите нового ДОМА Document объект. IllegalArgumentException бросается, если URI null нуль.
    
    Параметры:
    uri - Расположение контента, который будет проанализирован.
    
    Возвраты:
    Новый объект ДОМА Докьюмнта.
    
    Броски:
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки синтаксического анализа происходят.
    
    IllegalArgumentException - Когда uri null
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public Document parse(File f)
               throws SAXException,
                      IOException
```
    Проанализируйте контент данного файла как XML-документ и возвратите нового ДОМА Document объект. IllegalArgumentException бросается если File null нуль.
    
    Параметры:
    f - Файл, содержащий XML, чтобы проанализировать.
    
    Возвраты:
    Новый объект ДОМА Докьюмнта.
    
    Броски:
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки синтаксического анализа происходят.
    
    IllegalArgumentException - Когда f null
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public abstract Document parse(InputSource is)
                        throws SAXException,
                               IOException
```
    Проанализируйте контент данного входного источника как XML-документ и возвратите нового ДОМА Document объект. IllegalArgumentException бросается если InputSource null нуль.
    
    Параметры:
    is - InputSource, содержащий контент, который будет проанализирован.
    
    Возвраты:
    Новый объект ДОМА Докьюмнта.
    
    Броски:
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки синтаксического анализа происходят.
    
    IllegalArgumentException - Когда is null
    См. Также:
    DocumentHandler
  - isNamespaceAware
```
public abstract boolean isNamespaceAware()
```
    Указывает, конфигурируется ли этот синтаксический анализатор, чтобы понять пространства имен.
    
    Возвраты:
    истина, если этот синтаксический анализатор конфигурируется, чтобы понять пространства имен; ложь иначе.
  - isValidating
```
public abstract boolean isValidating()
```
    Указывает, конфигурируется ли этот синтаксический анализатор, чтобы проверить XML-документов.
    
    Возвраты:
    истина, если этот синтаксический анализатор конфигурируется, чтобы проверить XML-документов; ложь иначе.
  - setEntityResolver
```
public abstract void setEntityResolver(EntityResolver er)
```
    Определите EntityResolver использоваться, чтобы разрешить объекты, существующие в XML-документе, который будет проанализирован. Установка этого к null приведет к базовой реализации, используя свою собственную реализацию по умолчанию и поведение.
    
    Параметры:
    er - EntityResolver использоваться, чтобы разрешить объекты, существующие в XML-документе, который будет проанализирован.
  - setErrorHandler
```
public abstract void setErrorHandler(ErrorHandler eh)
```
    Определите ErrorHandler использоваться синтаксическим анализатором. Установка этого к null приведет к базовой реализации, используя свою собственную реализацию по умолчанию и поведение.
    
    Параметры:
    eh - ErrorHandler использоваться синтаксическим анализатором.
  - newDocument
```
public abstract Document newDocument()
```
    Получите новый экземпляр ДОМА Document возразите, чтобы создать дерево ДОМА с.
    
    Возвраты:
    Новый экземпляр объекта ДОМА Докьюмнта.
  - getDOMImplementation
```
public abstract DOMImplementation getDOMImplementation()
```
    Получите экземпляр a DOMImplementation объект.
    
    Возвраты:
    Новый экземпляр a DOMImplementation.
  - getSchema
```
public Schema getSchema()
```
    Получите ссылку на Schema будучи используемым процессором XML.
    
    Если никакая схема не используется, null возвращается.
    
    Возвраты:
    Schema будучи используемым или null если ни один в использовании
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод
    С тех пор:
    
    1.5
  - isXIncludeAware
```
public boolean isXIncludeAware()
```
    Получите XInclude обработка режима для этого синтаксического анализатора.
    
    Возвраты:
    возвращаемое значение DocumentBuilderFactory.isXIncludeAware() когда этот синтаксический анализатор создавался из фабрики.
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод
    С тех пор:
    
    1.5
    
    См. Также:
    DocumentBuilderFactory.setXIncludeAware(boolean)

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

Класс DocumentBuilder

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

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

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

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

DocumentBuilder

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

сброс

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

isNamespaceAware

isValidating

setEntityResolver

setErrorHandler

newDocument

getDOMImplementation

getSchema

isXIncludeAware