Package jakarta.json.bind

Interface JsonbBuilder

public interface JsonbBuilder
JsonbBuilder class provides the client's entry point to the JSON Binding API. It builds Jsonb instances based on all parameters and configuration provided before calling build() method. For most use-cases, only one instance of JsonbBuilder is required within the application.
Since:
JSON Binding 1.0
See Also:

  • Method Details

    • withConfig

      JsonbBuilder withConfig(JsonbConfig config)
      Set configuration which will be set to the newly created Jsonb instance.
      Parameters:
      config - Configuration for Jsonb instance.
      Returns:
      This JsonbBuilder instance.

    • withProvider

      JsonbBuilder withProvider(JsonProvider jsonpProvider)
      Provides a JSON-P provider to be used for all JSON-P related operations.
      Parameters:
      jsonpProvider - JsonProvider instance to be used by Jsonb to lookup JSON-P implementation.
      Returns:
      This JsonbBuilder instance.

    • build

      Jsonb build()
      Returns a new instance of Jsonb based on the parameters and configuration specified previously in this builder.
      Returns:
      Jsonb A new instance of Jsonb class. Always a non-null valid object.
      Throws:
      JsonbException - If an error was encountered while creating the Jsonb instance, such as (but not limited to) no JSON Binding provider found, or classes provide conflicting annotations.
      IllegalArgumentException - If there's an error processing the set parameters, such as the non-null parameter is assigned null value, or unrecognized property is set in JsonbConfig.

    • create

      static Jsonb create()
      Create a new Jsonb instance using the default JsonbBuilder implementation provided as returned from JsonbProvider.provider() method.
      Returns:
      new Jsonb instance.

    • create

      static Jsonb create(JsonbConfig config)
      Create a new Jsonb instance using the default JsonbBuilder implementation provided as returned from JsonbProvider.provider() method, configured with provided configuration.
      Parameters:
      config - Provided configuration for Jsonb instance.
      Returns:
      new Jsonb instance.

    • newBuilder

      static JsonbBuilder newBuilder()
      Create a new JsonbBuilder instance as returned by the default JsonbProvider.provider() method.
      Returns:
      new JsonbBuilder instance.

    • newBuilder

      static JsonbBuilder newBuilder(String providerName)
      Create a new JsonbBuilder instance as returned by JsonbProvider.provider(String) method.
      Parameters:
      providerName - Provider class name to be looked up by ServiceLoader.
      Returns:
      new JsonbBuilder instance.

    • newBuilder

      static JsonbBuilder newBuilder(JsonbProvider provider)
      Create a new JsonbBuilder instance as returned by provider#create call.
      Parameters:
      provider - JsonProvider instance used for creating JsonBuilder instances.
      Returns:
      new JsonbBuilder instance.