Boon, another JSON Parser, Faster and lighter than GSON

-

Boon and JSON


Boon is not a JSON parsing project. It is more than that, but JSON parsing is intrinsic to what Boon is all about. Boon is the probably the fastest way to serialize and parse JSON in Java so far for your project.. It is faster at object serialization, enabling JSON expressions, JSON parsing and much more. Boon JSON is FAST! In addition it has a very easy to use, convention-based API.
(Boon should be the fastest for most use cases that I have seen for REST, but there are some clear areas where Jackson and FASTJson are faster. At the moment, Boon is not the fastest way to encode JSON if you have a large strings with unicode outside of the ASCII range. The plan is to close the gap, but currently this makes Jackson faster for these use cases. Also please note that Boon is a newer project and not as mature as Jackson or GSON.)

Serialization

Serialization is achieved by:
Jackson style
        ObjectMapper mapper =  JsonFactory.create();
        mapper.writeValue(dst, myBean); // where 'dst' can be File, OutputStream or Writer
Gson Style
        ObjectMapper mapper =  JsonFactory.create();
        String dst = mapper.toJson(myBean);

Full Data Binding

When using full data binding, deserialization type must be fully specified as something other than Object.class. For example:
Jackson style
  MyBean value = mapper.readValue(src, MyBean.class); // 'src' can be File, InputStream, Reader, String
Gson style
  MyBean value = mapper.fromJson(src, MyBean.class); // 'src' can be File, InputStream,

Boon supports both Jackson and Gson style annotations so if you are coming from those project or are used to those projects, Boon should just work.



The main complication is handling of Generic types: if they are used, one has to use the two argument version of readValue to work around Java Type Erasure:


  List<MyBean> beans = mapper.readValue(src, List.class, MyBean.class);





"Simple" Data Binding



As mentioned above, simple here just means that range of value types is limited to core JDK types. If this is acceptable, deserialization type can be simply defined as Object.class. This can apply at root level (for calls to ObjectMapper, as well as at lower level -- whatever value are declared to be of basic Object type will use Simple data binding. Simple like this:


        Object root = mapper.readValue(src, Object.class);
        Map<String,Object> rootAsMap =  mapper.readValue(src, Map.class);




Complete code listing for tutorial so far


package org.boon.json;

import org.boon.Lists;

import java.io.File;
import java.util.List;
import java.util.Map;

import static org.boon.Boon.puts;

/**
 * Created by rick on 1/4/14.
 */
public class JsonTutorial {


    public static class MyBean {
        String name = "Rick";

        @Override
        public String toString() {
            return "MyBean{" +
                    "name='" + name + '\'' +
                    '}';
        }
    }

    public static void main (String... args) throws Exception {

        MyBean myBean = new MyBean();
        File dst = File.createTempFile("emp", ".json");

        ObjectMapper mapper =  JsonFactory.create();

        puts ("json string", mapper.writeValueAsString( myBean ));

        mapper.writeValue( dst, myBean ); // where 'dst' can be File, OutputStream or Writer


        File src = dst;
        MyBean value = mapper.readValue(src, MyBean.class); // 'src' can be File, InputStream, Reader, String



        //MyBean value = mapper.readValue(src, MyBean.class); // 'src' can be File, InputStream, Reader, String

        puts ("mybean", value);



        Object root = mapper.readValue(src, Object.class);
        Map<String,Object> rootAsMap =  mapper.readValue(src, Map.class);

        puts ("root", root);
        puts ("rootAsMap", rootAsMap);



        MyBean myBean1 = new MyBean(); myBean1.name = "Diana";
        MyBean myBean2 = new MyBean(); myBean2.name = "Rick";

        dst = File.createTempFile("empList", ".json");

        final List<MyBean> list = Lists.list( myBean1, myBean2 );

        puts ("json string", mapper.writeValueAsString( list ));

        mapper.writeValue( dst, list );

        src = dst;

        List<MyBean> beans = mapper.readValue(src, List.class, MyBean.class);

        puts ("mybeans", beans);





    }
}





Output from the above listing:


json string {"name":"Rick"} 
mybean MyBean{name='Rick'} 
root {name=Rick} 
rootAsMap {name=Rick} 
json string [{"name":"Diana"},{"name":"Rick"}] 
mybeans [MyBean{name='Diana'}, MyBean{name='Rick'}] 




Examples of it "just works"



Full Data Binding (POJO) Example



Boon's ObjectMapper "just works" for mapping JSON data into plain old Java objects ("POJOs"). For example, given JSON data:


{
    "gender": "MALE",
    "name": {
        "first": "Richard",
        "last": "Hightower"
    },
    "verified": true
}




To create the above JSON file, you could serialize this Java POJO:


    public class User {
        public enum Gender { MALE, FEMALE };

        public static class Name {
            private String first, last;

            public Name( String _first, String _last ) {
                this.first = _first;
                this.last = _last;
            }

            public String getFirst() { return first; }
            public String getLast() { return last; }

            public void setFirst(String s) { first = s; }
            public void setLast(String s) { last = s; }
        }

        private Gender gender;
        private Name name;
        private boolean isVerified;

        public Name getName() { return name; }
        public boolean isVerified() { return isVerified; }
        public Gender getGender() { return gender; }

        public void setName(Name n) { name = n; }
        public void setVerified(boolean b) { isVerified = b; }
        public void setGender(Gender g) { gender = g; }
    }




To produce the above JSON, you can create a serialize User as follows:


        ObjectMapper mapper =  JsonFactory.create();

        User user = new User();
        user.setGender( User.Gender.MALE );
        user.setName(new User.Name("Richard", "Hightower"));
        user.setVerified( true );

        puts ( mapper.writeValueAsString( user ) );





This JSON gets produced:


{
    "gender": "MALE",
    "name": {
        "first": "Richard",
        "last": "Hightower"
    },
    "verified": true
}




It is just as easy to read and write files:



Now to write/serialize and then read/deserialize this user to/fro to a file.



Write to a file:



        File file = File.createTempFile( "user", ".json" );

        mapper.writeValue( file, user );






Read from a file


        User userFromFile = mapper.readValue( file, User.class );

        puts ( userFromFile );






The puts method is like System.out.println of sorts and is part of Boon.



Using Streams, Readers, Writers, etc.



Boon also works with Streams, Readers, Writers, etc.



Read from a inputStream using JDK 1.7 Files utility:


        Path path = Paths.get(file.toString());
        InputStream inputStream = Files.newInputStream(path);

        User userFromInput = mapper.readValue( inputStream, User.class );
        puts ( "userFromInput", userFromInput );





Read from a reader using JDK 1.7 Files utility:



        Reader reader = Files.newBufferedReader( path, StandardCharsets.UTF_8 );
        User userFromReader = mapper.readValue( reader, User.class );
        puts ( "userFromReader", userFromReader );





Boon and REST



Boon ships with an IO library that makes it easy to read/write from URLs, and other file systems:


        User userFromURL = mapper.readValue( IO.read("http://fromsomewebsite/user.json"), User.class );
        puts ( "userFromURL", userFromURL );




Boon also makes making JSON calls to REST webservices easy as you can use Boon's HTTP utilities as follows:


         String results = HTTP.postJSON("http://foo.com/bar/add/user", mapper.writeValueAsString( user ) );
         AddUserResponse response = mapper.readValue( results, AddUserResponse.class );




Here is an example of getting a listing of users from a REST call:


         List <User> userList = mapper.readValue( HTTP.getJSON("http://foo.com/bar/user/listing"), 
                                            List.class, User.class );




Complete code listing so far for tutorial


package org.boon.json;

import org.boon.Lists;
import org.boon.core.Dates;

import java.io.File;
import java.io.InputStream;
import java.io.Reader;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Date;
import java.util.List;
import java.util.Map;

import static org.boon.Boon.puts;

/**
 * Created by rick on 1/4/14.
 */
public class JsonTutorial {


    public static class MyBean {
        String name = "Rick";

        @Override
        public String toString() {
            return "MyBean{" +
                    "name='" + name + '\'' +
                    '}';
        }
    }


    public static class User {
        public enum Gender { MALE, FEMALE };

        public static class Name {
            private String first, last;

            public Name( String _first, String _last ) {
                this.first = _first;
                this.last = _last;
            }

            public String getFirst() { return first; }
            public String getLast() { return last; }

            public void setFirst(String s) { first = s; }
            public void setLast(String s) { last = s; }

            @Override
            public String toString() {
                return "Name{" +
                        "first='" + first + '\'' +
                        ", last='" + last + '\'' +
                        '}';
            }
        }

        private Gender gender;
        private Name name;
        private boolean verified;
        private Date birthDate;

        public Name getName() { return name; }
        public boolean isVerified() { return verified; }
        public Gender getGender() { return gender; }

        public void setName(Name n) { name = n; }
        public void setVerified(boolean b) { verified = b; }
        public void setGender(Gender g) { gender = g; }

        public Date getBirthDate() { return birthDate; }
        public void setBirthDate( Date birthDate ) { this.birthDate = birthDate; }

        @Override
        public String toString() {
            return "User{" +
                    "gender=" + gender +
                    ", name=" + name +
                    ", isVerified=" + verified +
                    '}';
        }
    }


    public static void part1 () throws Exception {


        MyBean myBean = new MyBean();
        File dst = File.createTempFile("emp", ".json");

        ObjectMapper mapper =  JsonFactory.create();

        puts ("json string", mapper.writeValueAsString( myBean ));

        mapper.writeValue( dst, myBean ); // where 'dst' can be File, OutputStream or Writer


        File src = dst;
        MyBean value = mapper.readValue(src, MyBean.class); // 'src' can be File, InputStream, Reader, String

        puts ("mybean", value);



        Object root = mapper.readValue(src, Object.class);
        Map<String,Object> rootAsMap =  mapper.readValue(src, Map.class);

        puts ("root", root);
        puts ("rootAsMap", rootAsMap);



        MyBean myBean1 = new MyBean(); myBean1.name = "Diana";
        MyBean myBean2 = new MyBean(); myBean2.name = "Rick";

        dst = File.createTempFile("empList", ".json");

        final List<MyBean> list = Lists.list( myBean1, myBean2 );

        puts ("json string", mapper.writeValueAsString( list ));

        mapper.writeValue( dst, list );

        src = dst;

        List<MyBean> beans = mapper.readValue(src, List.class, MyBean.class);

        puts ("mybeans", beans);


    }

    public static void part2 () throws Exception {

        ObjectMapper mapper =  JsonFactory.create();

        User user = new User();
        user.setGender( User.Gender.MALE );
        user.setName(new User.Name("Richard", "Hightower"));
        user.setVerified( true );
        user.setBirthDate( Dates.getUSDate( 5, 25, 1980 ) );


        puts (mapper.writeValueAsString( user ));



        //Now to write and then read this as a file.

        File file = File.createTempFile( "user", ".json" );

        mapper.writeValue( file, user );

        User userFromFile = mapper.readValue( file, User.class );

        puts ( "userFromFile", userFromFile );


        Path path = Paths.get(file.toString());
        InputStream inputStream = Files.newInputStream(path);

        User userFromInput = mapper.readValue( inputStream, User.class );
        puts ( "userFromInput", userFromInput );


        Reader reader = Files.newBufferedReader( path, StandardCharsets.UTF_8 );
        User userFromReader = mapper.readValue( reader, User.class );

        puts ( "userFromReader", userFromReader );


    }

    public static void main (String... args) throws Exception {

        part1();
        part2();

    }
}









Project   :




Reference :

Comments

Post a Comment

Popular posts from this blog

PostgreSQL bytea and oid

-
I came across with following issue when i'm trying to save the uploaded file in to the database as a byte array using hibernate, JPA 2.0  annotation with Postgre SQL. even though in this stage i'm pretty much new to Postgre SQL, It has two type of data types to represent the binary data or BLOB, since i'm using hibernate jpa annotations use the annotation @Lob to indicate the byte[] of data to persist as a binary data. @Lob   @Basic(fetch = FetchType.LAZY)  public byte[] getPicture() { return picture;  }    exception : java.sql.SQLException: ERROR: column "picture" is of type bytea but expression is of type oid   Then i understood the issue with the data types.but when the hibernate generating the table it creates the  column with data type "oid" , after removing this annotation it creates a table column with "bytea" data type. and i'm in doubt which would be the most suitable data type to use.   Then i found the difference...
Read more

Microservices Architecture with Spring Boot in 15mins

-
Image
1. Introduction Microservices is not a new term. It coined in 2005 by Dr Peter Rodgers then called micro web services based on SOAP. It became more popular since 2010. Micoservices allows us to break our large system into number of independent collaborating processes. Lets see below microservices architecture. 1.1 What is Microservices Architecture? Microservices architecture allows to avoid monolith application for large system. It provide loose coupling between collaborating processes which running independently in different environments with tight cohesion. So lets discuss it by an example as below. For example imagine an online shop with separate microservices for user-accounts, product-catalog order-processing and shopping carts. So these components are inevitably important for such a large online shopping portal. For online shopping system we could use following architectures. 1.2 Shopping system without Microservices (Monolith architecture) In this architecture we are ...
Read more

Adding MySQL datasource to JBOSS AS 7

-
Retrieve the MySQL Connector The connector can be downloaded from:  http://dev.mysql.com/downloads/connector/j/ . The current version at the time of writing is 5.1.24, further sections of this guide assume that version number. Unzip the connector to your downloads folder and save the location of the main JAR in a variable which we can refer to later: Add a Module to AS 7 AS 7 uses a module system to provide isolation in class loading. We need to create a new module which contains the MySQL Connector J JAR. Move to the the AS installation directory and create the folder structure for the new module: export JBOSS_HOME =~ / Development / jboss-as-web-7.0.0.Final cd $JBOSS_HOME mkdir -p modules / com / mysql / main Copy the driver jar to the new directory and move to that directory: cp MYSQL_JAR $JBOSS_HOME / modules / com / mysql / main cd $JBOSS_HOME / modules / com / mysql / main Define the module in XML. This is the key part of the process....
Read more