Package com.clumd.projects.javajson.api

Interface JsonBuilder

All Superinterfaces:
JsonGenerator
All Known Implementing Classes:
BasicJsonBuilder
public interface JsonBuilder
extends JsonGenerator
Defines the required methods to build a JSON object from Java in this framework. The minimum wrapper for the output is an Object. You cannot return an array, or any primitive JSON datatype without first wrapping them in an object.

For each add method, If any element of the key does not already exist it will be created along the way. Additionally, when adding to an object, if your key has spaces, you can use ['spaced key'] notation for this. When adding to an array, you should leave the array accessor anonymous, e.g. someArray[] However, if you are adding to an existing element of an array, you should address the index. e.g. someArray[2]

  • Method Details

    • builder

      JsonBuilder builder()
      Used to create an empty JSON shell.
      Returns:
      An empty JSON builder, which will default to an object.

    • addBoolean

      JsonBuilder addBoolean​(String path, boolean value) throws BuildException
      Add a boolean to this JSON object.
      Parameters:
      path - The JSON path/key to place the object at.
      value - The boolean value to set at the given key.
      Returns:
      The current JSON object, with the new value assigned.
      Throws:
      BuildException - Thrown if the key was malformed or conflicts with values already present along it's path

    • addLong

      JsonBuilder addLong​(String path, long value) throws BuildException
      Add a long to this JSON object.
      Parameters:
      path - The JSON path/key to place the object at.
      value - The long value to set at the given key.
      Returns:
      The current JSON object, with the new value assigned.
      Throws:
      BuildException - Thrown if the key was malformed or conflicts with values already present along it's path

    • addDouble

      JsonBuilder addDouble​(String path, double value) throws BuildException
      Add a double to this JSON object.
      Parameters:
      path - The JSON path/key to place the object at.
      value - The double value to set at the given key.
      Returns:
      The current JSON object, with the new value assigned.
      Throws:
      BuildException - Thrown if the key was malformed or conflicts with values already present along it's path

    • addString

      JsonBuilder addString​(String path, String value) throws BuildException
      Add a string to this JSON object.
      Parameters:
      path - The JSON path/key to place the object at.
      value - The string value to set at the given key.
      Returns:
      The current JSON object, with the new value assigned.
      Throws:
      BuildException - Thrown if the key was malformed or conflicts with values already present along it's path

    • addBuilderBlock

      JsonBuilder addBuilderBlock​(String path, JsonBuilder value) throws BuildException
      Add another JsonBuilder (representing an object) with partially filled values to this JSON object.
      Parameters:
      path - The JSON path/key to place the object at.
      value - The JsonBuilder value to set at the given key.
      Returns:
      The current JSON object, with the new value assigned.
      Throws:
      BuildException - Thrown if the key was malformed or conflicts with values already present along it's path

    • addBuilderBlock

      JsonBuilder addBuilderBlock​(String path, Json value) throws BuildException
      Use an existing, compiled piece of JSON, converted to a JsonBuilder, then assigned to the value at the path.
      Parameters:
      path - The JSON path/key to place the object at.
      value - The JSON value to set at the given key.
      Returns:
      The current JSON object, with the new value assigned.
      Throws:
      BuildException - Thrown if the key was malformed or conflicts with values already present along it's path

    • convertFromJSON

      JsonBuilder convertFromJSON​(Json json)
      Break a full JSON object down into a builder representation of itself to be added to.
      Parameters:
      json - The JSON object to break into a builder representation.
      Returns:
      The given JSON object, as a JsonBuilder.

    • build

      Json build()
      Used to finalise the current builder into a fully compiled Java-JSON object.
      Returns:
      The compiled JSON object with all values set through this builder.