purejson

PureJSON is a simple JSON parser exposing pure object APIs for parsing json documents

License

License

Categories

Categories

JSON Data
GroupId

GroupId

io.github.senthilganeshs
ArtifactId

ArtifactId

purejson
Last Version

Last Version

1.0.1
Release Date

Release Date

Type

Type

jar
Description

Description

purejson
PureJSON is a simple JSON parser exposing pure object APIs for parsing json documents
Project URL

Project URL

http://maven.apache.org
Source Code Management

Source Code Management

https://github.com/senthilganeshs/jsonp

Download purejson

How to add to project

<!-- https://jarcasting.com/artifacts/io.github.senthilganeshs/purejson/ -->
<dependency>
    <groupId>io.github.senthilganeshs</groupId>
    <artifactId>purejson</artifactId>
    <version>1.0.1</version>
</dependency>
// https://jarcasting.com/artifacts/io.github.senthilganeshs/purejson/
implementation 'io.github.senthilganeshs:purejson:1.0.1'
// https://jarcasting.com/artifacts/io.github.senthilganeshs/purejson/
implementation ("io.github.senthilganeshs:purejson:1.0.1")
'io.github.senthilganeshs:purejson:jar:1.0.1'
<dependency org="io.github.senthilganeshs" name="purejson" rev="1.0.1">
  <artifact name="purejson" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.github.senthilganeshs', module='purejson', version='1.0.1')
)
libraryDependencies += "io.github.senthilganeshs" % "purejson" % "1.0.1"
[io.github.senthilganeshs/purejson "1.0.1"]

Dependencies

test (1)

Group / Artifact Type Version
junit : junit jar 3.8.1

Project Modules

There are no modules declared in this project.

build

Overview

This project contains a simple JSON parser written in JAVA using only pure object oriented concepts. It was originally written for this blog.

Maven Dependency

Want to give a try using the purejson parser, add the following to your pom.xml

<dependency>
    <groupId>io.github.senthilganeshs</groupId>
    <artifactId>purejson</artifactId>
    <version>1.0.1</version>
</dependency>

Parser

Parser accepts a json string and returns an Either which indicates presence of a value (ifSuccess) or an exception (ifFailure).

Parser.create().parse(
  "{" +
      "name : \"Senthil\"," + 
      "Employed : true," +
      "favourites : [\"TDD\", \"OOPS\"]" + 
  "}")
    .ifSuccess(v -> v
      .isJSON((k, _v) -> _v
        .isString(__v -> System.out.printf("String Attribute (%s, %s)\n", k, __v))
          .isBool(__v -> System.out.printf("Boolean Attribute(%s, %s)\n", k, __v))
          .isArray(__v -> __v
            .isString(___v -> System.out.printf("\t String Value (%s)", ___v)))))
    .ifFailure(System.out::println);

Converting a JSON string to an object (not POJO) can also be done declaratively with the fluent API's of Value object.

Parser.create().parse(
  "{" + 
    "  \"name\" : \"Senthil\"," + 
    "  \"address\" : {" + 
    "    \"flatNumber\" : \"#1011\"," + 
    "    \"building\"   : \"PureOO\"," + 
    "    \"city\"       : \"Objectvile\"" + 
    "  }," + 
    "  \"cargo\"   : {" + 
    "    \"trackingID\" : \"AOL123\"," + 
    "    \"from\"       : \"Impericity\"," + 
    "    \"to\"         : \"Objectvile\"" + 
    "  }" + 
  "}")
  .ifSuccess(v -> Customer.fromJSON(v).render(System.out))
  .ifFailure(System.out::println);

Objects encapsulate state and state is represented as JSON. Since parsing a JSON is a multi-step process, having a builder for the object construction is preferable. Any object will only expose behavior and in our example, the behavior is render to given OutputStream. This will help avoid cluttering the code with lots of POJO's.

Sample object construction via builder interface is follows:

public static Customer fromJSON (final Value node) {
    Customer.Builder bld = new Customer.Builder.CustomerBuilder();
    node
    .isJSON((k, v) -> {
        k.isString(key -> {
            if (key.equals("name")) {
                v.isString(bld::name)
            } else if (key.equals("address")) {
                v.isJSON((_k, _v) -> {
                    _k
                    .isString(_key -> {
                        if (_key.equals("flatNumber")) {
                            _v.isString(bld.address()::flatNumber);
                        } else if (_key.equals("building")) {
                            _v.isString(bld.address()::building);
                        } else if (_key.equals("city")) {
                            _v.isString(bld.address()::city);
                        }
                    })
                })
            } else if (key.equals("cargo")) {
                v
                .isJSON((_k, _v) -> {
                    _k
                    .isString(_key -> {
                        if (_key.equals("trackingID")) {
                            _v.isString(bld.cargo()::trackingID)
                        } else if (_key.equals("from")) {
                            _v.isString(bld.cargo()::from)
                        } else if (_key.equals("to")) {
                            _v.isString(bld.cargo()::to)
                        }
                    })
                })
            }
        });
    })
    .isError(System.err::println);
    return bld.build();
}

Generator

Generator accepts a Value returned by Parser and returns a JSON string as output.

Generator.create().generate(
  Value.arr(Arrays.asList(
    Value.bool(true),
    Value.string("string"),
    Value.arr(Arrays.asList(
      Value.integer(1),
      Value.integer(2))))));

The above code will generate the following json [true,"string",[1,2]]

Supported API's for Value.

API Description
isString(final Consumer action) Executes action supplying string value if the node represents a string
isBool(final Consumer action) Executes action supplying boolean value if the node represents a bool
isError(final Consumer action) Executes action supplying error message if the node represents an error
isInteger(final Consumer action) Executes action supplying long value if the node represents a long
isDouble(final Consumer action) Executes action supplying double value if the node represents a double
isArray(final Consumer action) Executes action for every element in the array. Each element can again be used with other value apis to get to primitive values.
isArrayAt(final int index, final Consumer action) Executes action for the value at specified index in the array
isNull(final Thunk action) Executes provided code in case of null value
isJSON(final BiConsumer<Value, Value> action) Executes action supplying key and value for each entries in the JSON object. Just like array data type, the value can further be used with other APIs to get to the primitive values.
isJSONKey(final Value key, final Consumer action) Executes action supplying value matching the given key in the JSON object

Performance Benchmarks

fabienrenauds java-json-benchmark has results of purejson compared against top json parsers

Versions

Version
1.0.1
1.0.0