Класс W3CDomHandler

java.lang.Object
- javax.xml.bind.annotation.W3CDomHandler

Все реализованные интерфейсы:: DomHandler<Element,DOMResult>

public class W3CDomHandler
extends Object
implements DomHandler<Element,DOMResult>

DomHandler реализация для W3C DOM (org.w3c.dom пакет).

С момента:: JAXB2.0

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

Конструктор и описание
`W3CDomHandler()` Конструктор по умолчанию.
`W3CDomHandler(DocumentBuilder builder)` Конструктор, который позволяет приложениям указать, какая реализация DOM должна быть использована.

Методы

Модификатор и тип	Метод и описание
`DOMResult`	`createUnmarshaller(ValidationEventHandler errorHandler)` Когда поставщик JAXB нуждается в разборке части документа в представление infoset, он сначала вызывает этот метод для создания объекта `Result`.
`DocumentBuilder`	`getBuilder()`
`Element`	`getElement(DOMResult r)` После того, как часть отправлена в `Result`.
`Source`	`marshal(Element element, ValidationEventHandler errorHandler)` Этот метод вызывается, когда поставщик JAXB нуждается в сериализации элемента в XML.
`void`	`setBuilder(DocumentBuilder builder)`

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

W3CDomHandler

public W3CDomHandler()

Конструктор по умолчанию. Поставщику JAXB предоставлено право решать, какую реализацию DOM использовать или как это настроить.

W3CDomHandler

public W3CDomHandler(DocumentBuilder builder)

Конструктор, который позволяет приложениям указать, какую реализацию DOM использовать.

Параметры:: builder - не должно быть null. JAXB использует этот DocumentBuilder для создания нового элемента.

Методы

getBuilder

public DocumentBuilder getBuilder()

setBuilder

public void setBuilder(DocumentBuilder builder)

createUnmarshaller

public DOMResult createUnmarshaller(ValidationEventHandler errorHandler)

Описание скопировано из интерфейса: DomHandler

Когда поставщик JAXB нуждается в разборке части документа в представление infoset, он сначала вызывает этот метод для создания объекта Result объекта.

Поставщик JAXB затем отправит часть XML в указанный результат. Такая часть всегда образует поддерево всего XML-документа, укорененного в элементе.

Указано в:: createUnmarshaller в интерфейсе DomHandler<Element,DOMResult>
Параметры:: errorHandler - если между вызовом этого метода и вызовом DomHandler.getElement(Result) произошла какая-либо ошибка, они должны быть сообщены этому обработчику. Вызывающий должен предоставить обработчик ошибок, отличный от null. Объект Result, созданный из этого метода, может содержать ссылку на этот обработчик ошибок.
Возвращает:: null, если операция завершилась неудачно. Об ошибке должно быть сообщено обработчику ошибок.

getElement

public Element getElement(DOMResult r)

Описание скопировано из интерфейса: DomHandler

После того, как часть отправлена в Result. Этот метод вызывается поставщиком JAXB для получения представления разборки элемента.

Несколько вызовов этого метода могут возвращать разные объекты. Этот метод может быть вызван только тогда, когда все поддерево передано объекту Result объекта.

Указано в:: getElement в интерфейсе DomHandler<Element,DOMResult>
Параметры:: r - объект Result, созданный методом DomHandler.createUnmarshaller(ValidationEventHandler).
Возвращает:: null, если операция завершилась неудачно. Об ошибке должно быть сообщено обработчику ошибок.

marshal

public Source marshal(Element element,
                      ValidationEventHandler errorHandler)

Описание скопировано из интерфейса: DomHandler

Этот метод вызывается, когда поставщик JAXB нуждается в сериализации элемента в XML.

Если не null, возвращаемый Source должен содержать весь документ, укорененный в одном элементе, который затем будет вплетен в больший документ, который сериализует поставщик JAXB.

Указано в:: marshal в интерфейсе DomHandler<Element,DOMResult>; errorHandler - получает любые ошибки, произошедшие во время процесса преобразования элемента в Source. Вызывающий должен предоставить обработчик ошибок, отличный от null.
Возвращает:: null, если произошла ошибка. Об ошибке должно быть сообщено обработчику.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.