Интерфейс DomHandler<ElementT,ResultT extends Result>

Все известные реализующие классы:: W3CDomHandler

public interface DomHandler<ElementT,ResultT extends Result>

Преобразует элемент (и его потомков) в/из представление DOM (или аналогичное).

Реализации этого интерфейса будут использоваться совместно с аннотацией XmlAnyElement для сопоставления элемента XML с представлением информационного набора, таким как W3C DOM.

Реализации скрывают, как часть XML преобразуется в/из такого представления, подобного DOM, позволяя поставщикам JAXB работать с произвольной такой библиотекой.

Этот интерфейс предназначен для реализации разработчиками библиотек и использования поставщиками JAXB. Ни один из этих методов не предназначен для вызова из приложений.

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

Методы

Модификатор и тип	Метод и описание
`ResultT`	`createUnmarshaller(ValidationEventHandler errorHandler)` Когда поставщику JAXB необходимо размаршировать часть документа в представление информационного набора, он сначала вызывает этот метод для создания объекта `Result`.
`ElementT`	`getElement(ResultT rt)` После того, как часть отправлена в `Result`.
`Source`	`marshal(ElementT n, ValidationEventHandler errorHandler)` Этот метод вызывается, когда поставщик JAXB должен маршировать элемент в XML.

Методы

createUnmarshaller

ResultT createUnmarshaller(ValidationEventHandler errorHandler)

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

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

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

getElement

ElementT getElement(ResultT rt)

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

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

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

marshal

Source marshal(ElementT n,
               ValidationEventHandler errorHandler)

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

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

Параметры:: 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.