Класс DocumentBuilder

public abstract class DocumentBuilder
extends Object

Определяет API для получения экземпляров DOM Document из XML-документа. Используя этот класс, программист может получить Document из XML.

Экземпляр этого класса можно получить из метода DocumentBuilderFactory.newDocumentBuilder(). После получения экземпляра этого класса XML можно парсить из различных источников ввода. Эти источники ввода — InputStream, файлы, URL и SAX InputSources.

Обратите внимание, что этот класс повторно использует несколько классов из API SAX. Это не требует, чтобы реализатор базовой реализации DOM использовал SAX-парсер для разбора XML-документа в Document. Это просто требует, чтобы реализация общалась с приложением, используя эти существующие API.

Конструкторы

DocumentBuilder

protected DocumentBuilder()

Защищённый конструктор

Методы

reset

public void reset()

Возбуждает:

UnsupportedOperationException - Когда реализация не переопределяет этот метод.

С момента:

1.5

parse

public Document parse(InputStream is)
               throws SAXException,
                      IOException

Обработать содержимое заданного InputStream как XML-документ и вернуть новый объект DOM Document. Будет выброшено IllegalArgumentException, если InputStream равно null.

Параметры:

is - Поток ввода, содержащий содержимое для обработки.

Возвращает:

Document результат обработки InputStream

Возбуждает:

IOException - Если произошли какие-либо ошибки ввода-вывода.

SAXException - Если произошли какие-либо ошибки обработки.

IllegalArgumentException - Когда is равно null

См. также:

DocumentHandler

parse

public Document parse(InputStream is,
                      String systemId)
               throws SAXException,
                      IOException

Обработать содержимое заданного InputStream как XML-документ и вернуть новый объект DOM Document. Будет выброшено IllegalArgumentException, если InputStream равно null.

Параметры:

is - Поток ввода, содержащий содержимое для обработки.

systemId - Предоставить базу для разрешения относительных URI.

Возвращает:

Новый объект DOM Document.

Возбуждает:

IOException - Если произошли какие-либо ошибки ввода-вывода.

SAXException - Если произошли какие-либо ошибки обработки.

IllegalArgumentException - Когда is равно null

См. также:

DocumentHandler

parse

public Document parse(String uri)
               throws SAXException,
                      IOException

Обработать содержимое заданного URI как XML-документ и вернуть новый объект DOM Document. Будет выброшено IllegalArgumentException, если URI null равен null.

Параметры:

uri - Расположение содержимого для обработки.

Возвращает:

Новый объект DOM Document.

Возбуждает:

IOException - Если произошли какие-либо ошибки ввода-вывода.

SAXException - Если произошли какие-либо ошибки обработки.

IllegalArgumentException - Когда uri равно null

См. также:

DocumentHandler

parse

public Document parse(File f)
               throws SAXException,
                      IOException

Обработать содержимое заданного файла как XML-документ и вернуть новый объект DOM Document. Будет выброшено IllegalArgumentException, если File равно null null.

Параметры:

f - Файл, содержащий XML для обработки.

Возвращает:

Новый объект DOM Document.

Возбуждает:

IOException - Если произошли какие-либо ошибки ввода-вывода.

SAXException - Если произошли какие-либо ошибки обработки.

IllegalArgumentException - Когда f равно null

См. также:

DocumentHandler

parse

public abstract Document parse(InputSource is)
                        throws SAXException,
                               IOException

Обработать содержимое заданного источника ввода как XML-документ и вернуть новый объект DOM Document. Будет выброшено IllegalArgumentException, если InputSource равно null null.

Параметры:

is - InputSource, содержащий содержимое для обработки.

Возвращает:

Новый объект DOM Document.

Возбуждает:

IOException - Если произошли какие-либо ошибки ввода-вывода.

SAXException - Если произошли какие-либо ошибки обработки.

IllegalArgumentException - Когда is равно null

См. также:

DocumentHandler

isNamespaceAware

public abstract boolean isNamespaceAware()

Указывает, настроен ли этот анализатор на понимание пространств имён.

Возвращает:

true, если этот анализатор настроен на понимание пространств имён; в противном случае false.

isValidating

public abstract boolean isValidating()

Указывает, настроен ли этот анализатор на проверку XML-документов.

Возвращает:

true, если этот анализатор настроен на проверку XML-документов; в противном случае false.

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()

Получить новый экземпляр объекта DOM Document для построения дерева DOM.

Возвращает:

Новый экземпляр объекта DOM Document.

getDOMImplementation

public abstract DOMImplementation getDOMImplementation()

Получить экземпляр объекта DOMImplementation.

Возвращает:

Новый экземпляр DOMImplementation.

getSchema

public Schema getSchema()

Возвращает:

Schema или null, если нет

Возбуждает:

UnsupportedOperationException - Когда реализация не переопределяет этот метод

С момента:

1.5

isXIncludeAware

public boolean isXIncludeAware()

Возвращает:

Значение возвращаемое DocumentBuilderFactory.isXIncludeAware() при создании этого анализатора из фабрики.

Возбуждает:

UnsupportedOperationException - Когда реализация не переопределяет этот метод

С момента:

1.5

См. также:

DocumentBuilderFactory.setXIncludeAware(boolean)