Package de.xima.fc.fastjson

Class DefaultFastJsonConverter

java.lang.Object
de.xima.fc.fastjson.DefaultFastJsonConverter
All Implemented Interfaces:
IFastJsonConverter
public final class DefaultFastJsonConverter extends Object implements IFastJsonConverter
Default implementation of IFastJsonConverter that does not add any custom serializers etc.
Since:
7.0.0
Author:
XIMA MEDIA GmbH

  • Field Details

    • INSTANCE

      public static IFastJsonConverter INSTANCE
      The immutable, thread-safe instance of the default fast JSON converter.

  • Method Details

    • parseJavaArray

      public <T> List<T> parseJavaArray(com.alibaba.fastjson.JSONArray json, Type type) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Creates a new list and for each entry in the given JSON array, adds an object with the data from that entry.
      Specified by:
      parseJavaArray in interface IFastJsonConverter
      Type Parameters:
      T - Type of the list items to create.
      Parameters:
      json - JSONArray to convert. The items in this array are expected to be JSON objects.
      type - Class of the items to create.
      Returns:
      A new list, populated with the converted items from the given JSON array.
      Throws:
      FastJsonException - When the JSON could not be parsed.

    • parseJavaArray

      public <T> List<T> parseJavaArray(String json, Type clazz) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Deserializes a JSON string into a List of Java objects of a particular class.
      Specified by:
      parseJavaArray in interface IFastJsonConverter
      Type Parameters:
      T - Type of the list items.
      Parameters:
      json - JSON string to parse. This is assumed to represent a JSON array of JSON objects.
      clazz - Class of the items in the JSON array.
      Returns:
      A list with the deserialized objects from the given JSON array.
      Throws:
      FastJsonException - When the JSON could not be parsed.

    • parseJavaObject

      public <T> T parseJavaObject(com.alibaba.fastjson.JSONObject json, Type clazz) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Creates an instance of the given class and populates it with the data from the given JSON object.
      Specified by:
      parseJavaObject in interface IFastJsonConverter
      Type Parameters:
      T - Type of the class to create.
      Parameters:
      json - JSON object with the data to set on the newly created instance.
      clazz - Class of the instance to create.
      Returns:
      A new instance of the given class, with the data from the given JSON object.
      Throws:
      FastJsonException - When the JSON could not be parsed.

    • parseJavaObject

      public <T> T parseJavaObject(String json, Type clazz) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Deserializes a JSON string into a Java object of a particular class.
      Specified by:
      parseJavaObject in interface IFastJsonConverter
      Type Parameters:
      T - Type of the class to create from the JSON string.
      Parameters:
      json - JSON string to parse. This is assumed to represent a JSON object.
      clazz - Class to create from the JSON string.
      Returns:
      The deserialized object with the data from the JSON string.
      Throws:
      FastJsonException - When the JSON could not be parsed.

    • parseJsonArray

      public com.alibaba.fastjson.JSONArray parseJsonArray(String json) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Takes a JSON string and parses it into a JSON array.
      Specified by:
      parseJsonArray in interface IFastJsonConverter
      Parameters:
      json - JSON string to parse. This is assumed to represent a JSON array.
      Returns:
      The parsed JSON array.
      Throws:
      FastJsonException - When the JSON could not be parsed.

    • parseJsonObject

      public com.alibaba.fastjson.JSONObject parseJsonObject(String json) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Takes a JSON string and parses it into a JSON object.
      Specified by:
      parseJsonObject in interface IFastJsonConverter
      Parameters:
      json - JSON string to parse. This is assumed to represent a JSON object.
      Returns:
      The parsed JSON object.
      Throws:
      FastJsonException - When the JSON could not be parsed.

    • toJsonObject

      public com.alibaba.fastjson.JSONObject toJsonObject(Object data) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Serializes the given instance to a JSON object.
      Specified by:
      toJsonObject in interface IFastJsonConverter
      Parameters:
      data - The data object to serialize.
      Returns:
      A JSON object with the data from the given object.
      Throws:
      FastJsonException - When the JSON could not be serialized.

    • toJsonString

      public String toJsonString(Object data) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Serializes the given instance to a JSON string.
      Specified by:
      toJsonString in interface IFastJsonConverter
      Parameters:
      data - The data object to serialize.
      Returns:
      A JSON string that represents the serialized form of the given data.
      Throws:
      FastJsonException - When the JSON could not be serialized.

    • toJsonString

      public String toJsonString(Object data, IFastJsonSerializeOptions opts) throws FastJsonException
      Description copied from interface: IFastJsonConverter
      Serializes the given instance to a JSON string.
      Specified by:
      toJsonString in interface IFastJsonConverter
      Parameters:
      data - The data object to serialize.
      opts - Options for the serialization process.
      Returns:
      A JSON string that represents the serialized form of the given data.
      Throws:
      FastJsonException - When the JSON could not be serialized.

    • forClassLoader

      public static IFastJsonConverter forClassLoader(ClassLoader loader)
      Parameters:
      loader - Class loader to use for locating classes during deserialization.
      Returns:
      An (effectively) immutable IFastJsonConverter instance with the given class loader.
      Throws:
      NullPointerException - When loader is null.

    • forClassLoaderCached

      public static IFastJsonConverter forClassLoaderCached(ClassLoader loader)
      Same as forClassLoader, but reuses created instances if possible. Not that since the returned converter is effectively immutable, there is no functional difference between this method and forClassLoader.
      Parameters:
      loader - Class loader to use for locating classes during deserialization.
      Returns:
      An (effectively) immutable IFastJsonConverter instance with the given class loader.
      Throws:
      NullPointerException - When loader is null.