JSON Binding

JSON Binding in the Java EE Platform

Java EE includes support for JSR 367, which provides an API that can serialize Java objects to JSON documents and deserialize JSON documents to Java objects. The Java API for JSON Binding contains the following packages:

The javax.json.bind package contains the binding interface, the builder interface, and a configuration class. Table 21-1 lists the main classes and interfaces in this package.
The javax.json.bind.adapter package contains the JsonbAdapter interface, which provides methods for binding custom Java types by converting them to known types.
The javax.json.bind.annotation package defines annotations that can be used to customize default binding behavior. Annotations can be used for field, JavaBean property, type, or package elements.
The javax.json.bind.config package interfaces and classes for customizing default binding behavior. Table 21-2 lists the main classes and interfaces in this package.
The javax.json.bind.serializer package contains interfaces that are used to create serialization and deserialization routines for custom types that cannot be easily mapped using the JsonbAdapter methods. Table 21-3 lists the main interfaces in this package.
The javax.json.bind.spi package contains a Service Provider Interface (SPI) for creating JSON Binding implementations. This package contains the JsonbProvider class, which contains the methods that a service provider implements.

Table 21-1 Main Classes and Interfaces in javax.json.bind

Class or Interface

Description

Jsonb

Contains the JSON-B methods for serializing Java objects to JSON and deserailizing JSON to Java objects.

JsonBuilder

Used by clients to create Jsonb instances.

JsonbConfig

Used to set configuration properties on Jsonb instances. Properties include binding strategies and properties for configuring custom serializers and deserializers.

JsonbException

Indicates that a problem occurred during JSON binding.

Table 21-2 Main Classes and Interfaces in javax.json.bind.config

Class or Interface

Description

PropertyNamingStrategy

Used to set how property names are translated.

PropertyVisibilityStrategy

Used to set whether fields and methods should be considered properties overriding the default scope and field access behavior.

BinaryDataStrategy

Used to set binary encoding.

PropertyOrderStrategy

Used to set how properties are ordered during serialization.

Table 21-3 Main Classes and Interfaces in javax.json.bind.serializer

Class or Interface

Description

JsonbDeserializer

Used to create a deserialization routine for a custom type.

JsonbSerializer

Used to create a serialization routine for a custom type.