Обработка JSON в платформе Java EE

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

Пакет javax.json содержит интерфейс чтения, интерфейс записи, интерфейс построения модели для объектной модели, а также служебные классы и типы Java для элементов JSON. Этот пакет также включает несколько классов, которые реализуют другие стандарты, связанные с JSON: JSON Pointer, JSON Patch и JSON Merge Patch. Эти стандарты используются для извлечения, преобразования или манипулирования значениями в объектной модели. Таблица 20-1 перечисляет основные классы и интерфейсы в этом пакете.
Пакет javax.json.stream содержит интерфейс синтаксического анализатора (parser) и интерфейс генератора для потоковой модели. Таблица 20-2 перечисляет основные классы и интерфейсы в этом пакете.
Пакет javax.json.spi содержит интерфейс поставщика услуг (SPI) для подключения реализаций для объектов обработки JSON. Этот пакет включает класс JsonProvider, который содержит методы, реализующие поставщик услуг.

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

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

Описание

Json

Содержит статические методы для создания объектов парсеров, конструкторов (builder) и генераторов JSON. Этот класс также содержит методы для создания объектов парсера, сборщика и генератора.

JsonReader

Считывает данные JSON из потока и создаёт объектную модель в памяти.

JsonObjectBuilder, JsonArrayBuilder

Создаёт объектную модель или модель массива в памяти, добавив элементы из кода приложения.

JsonWriter

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

JsonValue

Представляет элемент (например, объект, массив или значение) данных в JSON.

JsonStructure

Представляет объект или массив данных в JSON. Этот интерфейс является подтипом JsonValue.

JsonObject, JsonArray

Представляет объект или массив данных в JSON. Эти два интерфейса являются подтипами JsonStructure.

JsonPointer

Содержит методы для работы с конкретными целями в документах JSON. Цели могут быть объектами JsonValue, JsonObject или JsonArray.

JsonPatch

Интерфейс для поддержки последовательности операций, которые будут применены к целевому ресурсу JSON. Операции определены в документе исправления JSON.

JsonMergePatch

Интерфейс для поддержки обновлений для целевых ресурсов JSON. Документ исправления JSON сравнивается с целевым ресурсом, чтобы определить конкретный набор операций изменения, которые будут применены.

JsonString, JsonNumber

Представляет типы данных для элементов данных в JSON. Эти два интерфейса являются подтипами JsonValue.

JsonException

Указывает, что во время обработки JSON возникла проблема.

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

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

Описание

JsonParser

Представляет парсер на основе событий, который может читать данные JSON из потока или из объектной модели.

JsonGenerator

Записывает данные JSON в поток по одному элементу за раз.