Изучаем Java EE 7 - [190]
>@XmlRootElement
>public class CreditCard {
>···private String number;
>···private String expiryDate;
>···private Integer controlNumber;
>···private String type;
>···// Конструкторы, методы работы со свойствами
>}
За исключением аннотации @XmlRootElement выше приведен код простого класса Java. С этим механизмом аннотаций и маршалинга JAXB способен создать XML-представление объекта типа CreditCard, которое выглядит как XML-документ, показанный в листинге 12.8.
>
>
>··
>··
>··
>··
>
Маршалинг — это процесс преобразования объекта в XML (рис. 12.2). Обратное преобразование также возможно с помощью JAXB. При демаршалинге в качестве входных данных был бы принят XML-документ из листинга 12.8 и создан экземпляр типа CreditCard со значениями, определенными в документе.
JAXB управляет XML-документами и определениями XML-схем (XSD) прозрачным, объектно-ориентированным способом, что скрывает сложность языка XSD. JAXB может автоматически сгенерировать схему, которая проверила бы XML-структуру кредитной карты, чтобы убедиться, что она имеет правильную структуру и типы данных (благодаря утилите schemagen, поставляющейся с JDK). В листинге 12.9 показана XML-схема (XSD) класса CreditCard.
Рис. 12.2. Архитектура JAXB
>
>
>··
>··
>····
>······
>······
>······
>······
>····
>··
>
Схема, приведенная выше, состоит из простых элементов (controlNumber, ExpiryDate и т. д.) и сложного типа (creditCard). Обратите внимание, что все метки используют префикс xs (xs: element, хs: string и т. д.). Он называется пространством имен и определяется в заголовочном теге документа xmlns (пространство имен XML):
>
Пространства имен создают уникальные префиксы для элементов в виде отдельных документов или приложений, которые используются вместе. В основном они применяются, чтобы избежать конфликтов, которые могут возникнуть, если одинаковое имя элемента появляется в нескольких документах (например, тег
JAXB обеспечивает легкое двустороннее преобразование между объектами Java и XML-структурами. Это позволяет трансформировать объекты Java в XML-данные без необходимости создания сложного кода, который трудно поддерживать и отлаживать. Например, JAXB позволяет легко переносить состояние объекта в XML-данные или сериализовать его сетевой поток. С другой стороны, JAXB позволяет работать с XML-документами, как будто они являются объектами Java без необходимости явно выполнять анализ SAX или DOM в коде приложения.
Связывание
JAXB API, определенный в пакете javax.xml.bind, предоставляет набор интерфейсов и классов для создания XML-документов и генерации классов Java. Другими словами, он связывает две модели. Фреймворк среды выполнения JAXB реализует операции маршалинга и демаршалинга. В табл. 12.7 перечислены основные используемые для них пакеты JAXB.
| Пакет | Описание |
|---|---|
| javax.xml.bind | Фреймворк связывания среды выполнения, имеющий возможность выполнять операции маршалинга, демаршалинга и проверки |
| javax.xml.bind.annotation | Аннотации для настройки преобразований между программой Java и XML-данными |
| javax.xml.bind.annotation.adapters | Классы-адаптеры JAXB |
| javax.xml.bind.attachment | Позволяет выполнять маршалинг для оптимизации хранения двоичных данных и демаршалинг корня документа, содержащего форматы двоичных данных |
| javax.xml.bind.helpers | Содержит частичные стандартные реализации некоторых интерфейсов javax.xml.binding |
| javax.xml.bind.util | Предоставляет полезные вспомогательные классы |
Как было показано выше (см. рис. 12.2), маршалинг — это процесс преобразования экземпляров аннотированных с помощью JAXB-классов в XML-представления. Кроме того, демаршалинг — это процесс преобразования XML-представлений в дерево объектов. В процессе маршалинга/демаршалинга JAXB также может проверить XML на соответствие схеме XSD (см. листинг 12.9). JAXB может также работать на уровне классов и способен автоматически генерировать схемы из набора классов и наоборот.
В центре JAXB API находится класс javax.xml.bind.JAXBContext. Этот абстрактный класс управляет связыванием между XML-документами и объектами Java, поскольку он предоставляет:
