Interface JSONContext<T extends Message.Mutable>

Type Parameters:
T - the type of message
All Known Subinterfaces:
JSONContext.Client, JSONContextServer
All Known Implementing Classes:
JacksonJSONContextClient, JacksonJSONContextServer, JettyJSONContextClient, JettyJSONContextServer

public interface JSONContext<T extends Message.Mutable>

Abstraction for JSON parsing and generation.

  • Method Details

    • parse

      @Deprecated T[] parse(InputStream stream) throws ParseException
      Deprecated.
      use parse(Reader) instead

      Parses an array of messages from the given stream.

      Parameters:
      stream - the stream to parse from
      Returns:
      an array of messages
      Throws:
      ParseException - in case of parsing errors
    • parse

      T[] parse(Reader reader) throws ParseException

      Parses an array of messages from the given reader.

      Parameters:
      reader - the reader to parse from
      Returns:
      an array of messages
      Throws:
      ParseException - in case of parsing errors
    • parse

      T[] parse(String json) throws ParseException

      Parses an array of messages from the given string.

      Parameters:
      json - the JSON string to parse from
      Returns:
      an array of messages
      Throws:
      ParseException - in case of parsing errors
    • newAsyncParser

      default JSONContext.AsyncParser newAsyncParser()
      Returns:
      a new JSONContext.AsyncParser instance, or null if non-blocking parsing is not supported
    • generate

      String generate(T message)

      Converts a single message to a JSON string.

      Parameters:
      message - the message to stringify
      Returns:
      the JSON string for the message
    • generate

      String generate(List<T> messages)

      Converts a list of messages to a JSON string.

      Parameters:
      messages - the list of messages to stringify
      Returns:
      the JSON string for the messages
    • getParser

      JSONContext.Parser getParser()
      Returns:
      a synchronous JSON parser to parse any JSON string
    • getGenerator

      JSONContext.Generator getGenerator()
      Returns:
      a JSON generator to stringify any object to a JSON string