Tag: ibm social business toolkit

The Social Business Toolkit SDK is a set of libraries and code samples that you use for connecting to the IBM Social Platform. The SDK covers many products like IBM Connections, IBM Notes/Domino, IBM Sametime and IBM SmartCloud for Social Business. The SDK has support for many application server platforms – IBM Domino, IBM WebSphere Application Server, IBM WebSphere Portal, WordPress and Apache Tomcat. The SDK also supports many languages – JavaScript, PHP, Objective-C, XPages and Java.

The Java libraries include some core code to process many data formats – Extensible Markup Language (XML) and JavaScript Object Notation (JSON).

Steps
Download the most current release

Navigate to the Download Folder

Unzip the Folder (It’ll create an sbtsdk folder)

The files, which are going to be used for this post, are in sbtsdk/redist/jar/.

Launch Eclipse

Enter a Workspace for this Project

If this launch is the first time you have opened Eclipse, please Close the Welcome view.

Click File > New > Project

Select Java Project

Click Next

Enter Project Name – json.demo

Click Finish

Agree to switch the Java Perspective, Click OK.

Click on json.demo

Click File > Properties

Click Java Build Path

Click Libraries

Click Add External JARs

Navigate to sbtsdk/redist/jar

Select com.ibm.commons-1.0.0.20140125-1133.jar com.ibm.commons.runtime-1.0.0.20140125-1133.jar com.ibm.commons.xml-1.0.0.20140125-1133.jar and com.ibm.sbt.core-1.0.0.20140125-1133.jar.

Click OK

Click File > New > Class

Enter Name – Main

Select public static void main

Click Finish

For simple use, I am going to use a jsonString that is formatted for Java. You can load json from an InputStream (File, Pipe or WebService). The json example is from http://json.org/example .

{ “glossary”: { “title”: “example glossary”, “GlossDiv”: { “title”: “S”, “GlossList”: { “GlossEntry”: { “ID”: “SGML”, “SortAs”: “SGML”, “GlossTerm”: “Standard Generalized Markup Language”, “Acronym”: “SGML”, “Abbrev”: “ISO 8879:1986”, “GlossDef”: { “para”: “A meta-markup language, used to create markup languages such as DocBook.”, “GlossSeeAlso”: [“GML”, “XML”] }, “GlossSee”: “markup” } } } } }

I created the JSON String

String jsonString = "{ \"glossary\": { \"title\": \"example glossary\", \"GlossDiv\": {\"title\": \"S\",\"GlossList\": {\"GlossEntry\": {\"ID\": \"SGML\",\"SortAs\": \"SGML\",\"GlossTerm\": \"Standard Generalized Markup Language\",\"Acronym\": \"SGML\",\"Abbrev\": \"ISO 8879:1986\",\"GlossDef\": {\"para\": \"A meta-markup language, used to create markup languages such as DocBook.\",\"GlossSeeAlso\": [\"GML\", \"XML\"]},\"GlossSee\": \"markup\" } }} } }";

Parse the string

/**
 * Creates the Java Representation
 */
 JsonJavaObject jsonObject = (JsonJavaObject) JsonParser.fromJson(
 JsonJavaFactory.instanceEx, jsonString);

This code requires a surrounding try and catch clause with JsonExpection. If the parse fails, it throws an Exception.

To navigate the JSON data, I’m going to create a Handler.

/**
 * Processing it requires a handler
 */
 JsonDataHandler handler = new JsonDataHandler();
 handler.setData(jsonObject);

Next I want to get a specific field (and type a nested JSON Entry. I could in theory just request a String, Int, Long based on the field type. Typeahead is your friend.

/**
 * Select a JsonJavaObject that's a Child Object
 */
 JsonJavaObject entryJson = handler.getEntry("glossary");

For instance, I could get the String in this object.

 /**
 * Get a Specific Entry and have it cast to a preferred object type
 */
 String title = entryJson.getAsString("title");
 System.out.println(title);

I could also get a List of JsonJavaObjects (great if there is an included list of JsonEntities). Also Arrays.

To run the code, you can run the code.

Click Run > Run Configurations

Select Java Applications

Click New

Click Run (If Prompted, select Yes to Save)

You now see how to process a JsonObject, you can now read the details, and easily go about updating or cloning a JsonObject.

Good luck

You can download the source code for the Libraries at https://github.com/OpenNTF/SocialSDK. You can also download the built release at http://ibmsbt.openntf.org/ .