Package org.eclipse.yasson

Interface YassonJsonb

All Superinterfaces:
AutoCloseable, javax.json.bind.Jsonb
All Known Implementing Classes:
JsonBinding
public interface YassonJsonb extends javax.json.bind.Jsonb
Adds methods to Jsonb that are operating directly with JsonGenerator or JsonParser types.

JsonProvider operates on top of the InputStream / OutputStream or Reader / Writer and creates generator / parser instances during runtime.

This interface accepts instantiated generators and parsers with different input / output sources.

  • Method Summary

    Modifier and Type
    Method
    Description
    <T> T
    fromJson(javax.json.stream.JsonParser jsonParser, Class<T> type)
    Reads in a JSON data with a specified JsonParser and return the resulting content tree.
    <T> T
    fromJson(javax.json.stream.JsonParser jsonParser, Type runtimeType)
    Reads in a JSON data with a specified JsonParser and return the resulting content tree.
    <T> T
    fromJsonStructure(javax.json.JsonStructure jsonStructure, Class<T> type)
    Reads a JsonStructure and and converts it into resulting java content tree.
    <T> T
    fromJsonStructure(javax.json.JsonStructure jsonStructure, Type runtimeType)
    Reads a JsonStructure and and converts it into resulting java content tree.
    void
    toJson(Object object, Type runtimeType, javax.json.stream.JsonGenerator jsonGenerator)
    Writes the object content tree with a specified JsonGenerator.
    void
    toJson(Object object, javax.json.stream.JsonGenerator jsonGenerator)
    Writes the object content tree with a specified JsonGenerator.
    javax.json.JsonStructure
    toJsonStructure(Object object)
    Serializes the object content tree to a JsonStructure.
    javax.json.JsonStructure
    toJsonStructure(Object object, Type runtimeType)
    Serializes the object content tree to a JsonStructure.

    Methods inherited from interface java.lang.AutoCloseable

    close

    Methods inherited from interface javax.json.bind.Jsonb

    fromJson, fromJson, fromJson, fromJson, fromJson, fromJson, toJson, toJson, toJson, toJson, toJson, toJson

  • Method Details

    • fromJson

      <T> T fromJson(javax.json.stream.JsonParser jsonParser, Class<T> type) throws javax.json.bind.JsonbException
      Reads in a JSON data with a specified JsonParser and return the resulting content tree. Provided json parser must be fully initialized, no further configurations will be applied.
      Type Parameters:
      T - Type of the content tree's root object.
      Parameters:
      jsonParser - The json parser instance to be used to read JSON data.
      type - Type of the content tree's root object.
      Returns:
      the newly created root object of the java content tree
      Throws:
      javax.json.bind.JsonbException - If any unexpected error(s) occur(s) during deserialization.

    • fromJson

      <T> T fromJson(javax.json.stream.JsonParser jsonParser, Type runtimeType) throws javax.json.bind.JsonbException
      Reads in a JSON data with a specified JsonParser and return the resulting content tree. Provided json parser must be fully initialized, no further configurations will be applied.
      Type Parameters:
      T - Type of the content tree's root object.
      Parameters:
      jsonParser - The json parser instance to be used to read JSON data.
      runtimeType - Runtime type of the content tree's root object.
      Returns:
      the newly created root object of the java content tree
      Throws:
      javax.json.bind.JsonbException - If any unexpected error(s) occur(s) during deserialization.

    • fromJsonStructure

      <T> T fromJsonStructure(javax.json.JsonStructure jsonStructure, Class<T> type) throws javax.json.bind.JsonbException
      Reads a JsonStructure and and converts it into resulting java content tree.
      Type Parameters:
      T - Type of the content tree's root object.
      Parameters:
      jsonStructure - JsonStructure to be used as a source for conversion.
      type - Type of the content tree's root object.
      Returns:
      the newly created root object of the java content tree
      Throws:
      javax.json.bind.JsonbException - If any unexpected error(s) occur(s) during conversion.

    • fromJsonStructure

      <T> T fromJsonStructure(javax.json.JsonStructure jsonStructure, Type runtimeType) throws javax.json.bind.JsonbException
      Reads a JsonStructure and and converts it into resulting java content tree.
      Type Parameters:
      T - Type of the content tree's root object.
      Parameters:
      jsonStructure - JsonStructure to be used as a source for conversion.
      runtimeType - Runtime type of the content tree's root object.
      Returns:
      the newly created root object of the java content tree
      Throws:
      javax.json.bind.JsonbException - If any unexpected error(s) occur(s) during deserialization.

    • toJson

      void toJson(Object object, javax.json.stream.JsonGenerator jsonGenerator) throws javax.json.bind.JsonbException
      Writes the object content tree with a specified JsonGenerator. Provided json generator must be fully initialized, no further configurations are applied.
      Parameters:
      object - The object content tree to be serialized.
      jsonGenerator - The json generator to write JSON data. The generator is not closed on a completion for further interaction.
      Throws:
      javax.json.bind.JsonbException - If any unexpected problem occurs during the serialization.
      Since:
      JSON Binding 1.0

    • toJson

      void toJson(Object object, Type runtimeType, javax.json.stream.JsonGenerator jsonGenerator) throws javax.json.bind.JsonbException
      Writes the object content tree with a specified JsonGenerator. Provided json generator must be fully initialized, no further configurations are applied.
      Parameters:
      object - The object content tree to be serialized.
      runtimeType - Runtime type of the content tree's root object.
      jsonGenerator - The json generator to write JSON data. The generator is not closed on a completion for further interaction.
      Throws:
      javax.json.bind.JsonbException - If any unexpected problem occurs during the serialization.
      Since:
      JSON Binding 1.0

    • toJsonStructure

      javax.json.JsonStructure toJsonStructure(Object object) throws javax.json.bind.JsonbException
      Serializes the object content tree to a JsonStructure.
      Parameters:
      object - The object content tree to be serialized.
      Returns:
      The JsonStructure serialized from java content tree.
      Throws:
      javax.json.bind.JsonbException - If any unexpected problem occurs during the serialization.
      Since:
      JSON Binding 1.0

    • toJsonStructure

      javax.json.JsonStructure toJsonStructure(Object object, Type runtimeType) throws javax.json.bind.JsonbException
      Serializes the object content tree to a JsonStructure.
      Parameters:
      object - The object content tree to be serialized.
      runtimeType - Runtime type of the content tree's root object.
      Returns:
      The JsonStructure serialized from java content tree.
      Throws:
      javax.json.bind.JsonbException - If any unexpected problem occurs during the serialization.
      Since:
      JSON Binding 1.0