Tuesday, August 28, 2012

JSON GSON

JSON is a wide spread data description format used to exchange JavaScript Objects.
It is pretty widely used for web API.
Today, I will focus on the exploitation of this kind of data in Java, with the pretty well done GSon library.
First, call the API (a simple GET with the arguments in the URL) that provide the data, this is done simply by this code :

public static String call(String url) throws IOException {
    BufferedReader bis = null;
    InputStream is = null;
    try {
        URLConnection connection = new URL(url).openConnection();
        is = connection.getInputStream();
        // warning of UTF-8 data
        bis = new BufferedReader(new InputStreamReader(is, "UTF-8"));
        String line = null;
        StringBuffer result = new StringBuffer();
        while ((line = bis.readLine()) != null) {
            result.append(line);
        }
        return result.toString();
    } finally {
        if (bis != null) {
            try {
                bis.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        if (is != null) {
            try {
                is.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

Note : we use a InputStreamReader(is, "UTF-8") in order to manage correctly UTF-8 data that we'll retrieve in some Japanese, French or other exotic languages.

Ok, the String result will be the something, for example like that :

{
     "first-name": "John",
     "last-name": "Smith",
     "age": 25,
     "address":
     {
         "street-address": "21 2nd Street",
         "city": "New York",
         "state": "NY",
         "postal-code": "10021"
     },
     "phone-number":
     [
         {
           "type": "home",
           "number": "212 555-1234"
         },
         {
           "type": "fax",
           "number": "646 555-4567"
         }
     ]
 }

To process this String, we'll use the magic GSon.

The GSon library will try to parse the JSon formatted string and map the data to a given Java Person Object. GSon used reflection to do such a trick, so the attributes types and names of the target java Object will need to be matchable with the JSon string structure.
In the previous example, the Person object will need to have a structure that match the JSon object, that is to say, will have 5 attributes named "first-name", "last-name", "age", "address", and "phone-number".

First of all, what we see here, is that an attribute cannot be called first-name in Java, because the '-' character is not permitted in java attribute names. No problem, we'll declare a firstName attribute, and specify that it's JSon serialized name id "first-name" by using a @SerializedName annotation.

We'll obtain an attribute declared like this :

@SerializedName("first-name") private String firstName;

Of course same trick is applied for the "last-name" attribute.
The age is simply declared as a int, here we keep the same attribute name in JavaScript and in Java :

private int age;

Ok, now the address, which is a complex Object (we can see it with the {...} that represents a structure.
So we'll map it with a Java Object Address, which following the same principle as above, which give us :

private class Address {

    @SerializedName("street-address") private String streetAddress;

    private String city;

    private String state;

    @SerializedName("postal-code") private int postalCode;

}

Remain the phone numbers, here the [...] characters point out that we are dealing with a collections of objects.
We'll then map it with a java.util.List of PhoneNumber Objects as below :

@SerializedName("phone-number") private List<PhoneNumber> phoneNumber;

Where a PhoneNumber is the given object :

private class PhoneNumber {

    private String type;
    private String number;
}

OK, so now our Object Person is completed and looks like that :

private class Person {

    @SerializedName("first-name") private String firstName;

    @SerializedName("last-name") private String lastName;

    private int age;

    private Address address;

    @SerializedName("phone-number") private List<PhoneNumber> phoneNumber;

}

We are done. A call to Gson will instantiate a Person Java Object and populate it with the flux.

Person data = new Gson().fromJson(json, Person .class); 

 That give us :



14 comments:

  1. Thank you for allowing me to read it, welcome to the next in a recent article. And thanks for sharing the nice article, keep posting or updating news article.
    python Course in Pune
    python Course institute in Chennai
    python Training institute in Bangalore

    ReplyDelete
  2. Your very own commitment to getting the message throughout came to be rather powerful and have consistently enabled employees just like me to arrive at their desired goals.
    AWS Training in Bangalore
    AWS training in sholinganallur
    AWS training in Tambaram
    AWS training in Velachery

    ReplyDelete
  3. Attend The Python Training in Bangalore From ExcelR. Practical Python Training in Bangalore Sessions With Assured Placement Support From Experienced Faculty. ExcelR Offers The Python Training in Bangalore.

    ReplyDelete
  4. Good post, Thank you so much for sharing this lovely article. It was so good to read and useful to upgrade my understanding. Keep it up!! machine learning course bangalore

    ReplyDelete
  5. For Devops training in Bangalore Visit:
    Devops Training in Bangalore

    ReplyDelete
  6. I recently came across your article and have been reading along. I want to express my admiration of your writing skill and ability to make readers read from the beginning to the end.
    Python Training In Pune

    ReplyDelete
  7. College issue above. Big fact marriage choose many statement read answer. Like magazine former attention.news today live

    ReplyDelete