Связывание с JSON

Связывание с JSON в платформе Java EE

Java EE включает поддержку JSR 367, которая предоставляет API, сериализующий объекты Java в документы JSON и десериализующий документы JSON в объекты Java. Java API для связывания с JSON содержит следующие пакеты:

Пакет javax.json.bind содержит интерфейс привязки, интерфейс конструктора (builder) и класс конфигурации. Таблица 21-1 перечисляет основные классы и интерфейсы в этом пакете.
Пакет javax.json.bind.adapter содержит интерфейс JsonbAdapter, который предоставляет методы для связывания пользовательских типов Java путём преобразования их в известные типы.
Пакет javax.json.bind.annotation определяет аннотации, которые можно использовать для настройки поведения привязки по умолчанию. Аннотации могут использоваться для поля, свойства JavaBean, типа или элементов пакета.
Интерфейсы и классы пакета javax.json.bind.config для настройки поведения привязки по умолчанию. Таблица 21-2 перечисляет основные классы и интерфейсы в этом пакете.
Пакет javax.json.bind.serializer содержит интерфейсы, которые используются для создания процедур сериализации и десериализации для пользовательских типов, которые не могут быть сопоставлены с помощью методов JsonbAdapter. Таблица 21-3 перечисляет основные интерфейсы в этом пакете.
Пакет javax.json.bind.spi содержит интерфейс поставщика услуг (SPI) для создания реализаций связывания JSON. Этот пакет содержит класс JsonbProvider, который содержит методы, реализующие поставщик услуг.

Таблица 21-1 Основные классы и интерфейсы в javax.json.bind

Класс или интерфейс

Описание

Jsonb

Содержит методы JSON-B для сериализации объектов Java в JSON и десериализации JSON в объекты Java.

JsonBuilder

Используется клиентами для создания объектов Jsonb.

JsonbConfig

Используется для установки свойств конфигурации в объектах Jsonb. Свойства включают стратегии привязки и свойства для настройки кастомных сериализаторов и десериализаторов.

JsonbException

Сообщает о проблемах, возникших во время привязки JSON.

Таблица 21-2 Основные классы и интерфейсы в javax.json.bind.config

Класс или интерфейс

Описание

PropertyNamingStrategy

Используется для установки способа перевода имён свойств.

PropertyVisibilityStrategy

Используется для определения, следует ли рассматривать поля и методы как свойства, переопределяющие область видимости по умолчанию и поведение доступа к полям.

BinaryDataStrategy

Используется для установки бинарного кодирования.

PropertyOrderStrategy

Используется для установки способа упорядочения свойств при сериализации.

Таблица 21-3 Основные классы и интерфейсы в javax.json.bind.serializer

Класс или интерфейс

Описание

JsonbDeserializer

Используется для создания процедуры десериализации для пользовательского типа.

JsonbSerializer

Используется для создания процедуры сериализации для пользовательского типа.