Adds example usage and a test for it

Author: itamarhaber

README.md

@@ -1,24 +1,38 @@
 # JReJSON
 
-A Java Client Library for [ReJSON](https://https://github.com/redislabsmodules/rejson)
+A Java Client Library for [ReJSON](https://github.com/redislabsmodules/rejson)
 
 ## Overview 
 
+This client provides access to ReJSON's Redis API, and provides back-and-forth serialization between Java's and its objects.
 
 ## Usage example
 
-Initializing the client:
+Firstly, the client's initialization:
 
 ```java
+Client c = new Client("localhost", 6379);
+```
 
-import io.rejson.Client;
-
-...
+Setting a Redis key name _foo_ to the string _"bar"_, and reading it back:
+```java
+c.set("foo", "bar");
+String s0 = (String) c.get("foo");
+```
 
-Client client = new Client("localhost", 6379);
+Omitting the path (usually) defaults to the root path, so the call above to `get()` and the following ones are basically interchangeable:
 
+```java
+String s1 = (String) c.get("foo", new Path("."));
+String s2 = (String) c.get("foo", Path.RootPath());
 ```
 
-Setting a value:
-
-...
+Any Gson-able object can be set and updated:
+```java
+c.set("obj", new Object());                         // just an empty object
+c.set("obj", null, new Path(".zilch"));
+Path p = new Path(".whatevs");
+c.set("obj", true, p);
+c.set("obj", 42, p);
+c.del("obj", p);                                    // back to almost nothing
+```

src/test/java/io/rejson/UsageExampleTest.java

@@ -0,0 +1,36 @@
+package io.rejson;
+
+import org.junit.Before;
+import org.junit.Test;
+
+
+public class UsageExampleTest {
+    @Before
+    public void initialize() {
+        Client c = new Client("localhost", 6379);
+        c._conn().flushDB();
+    }
+
+    @Test
+    public void exampleShouldWork() throws Exception {
+        // Firstly, the client's initialization
+        Client c = new Client("localhost", 6379);
+
+        // Setting a Redis key name _foo_ to the string _"bar"_, and reading it back
+        c.set("foo", "bar");
+        String s0 = (String) c.get("foo");
+
+        // Omitting the path (usually) defaults to the root path, so the call above to `get()` and the following ones
+        // are basically interchangeable
+        String s1 = (String) c.get("foo", new Path("."));
+        String s2 = (String) c.get("foo", Path.RootPath());
+
+        // Any Gson-able object can be set and updated
+        c.set("obj", new Object());					         // just an empty object
+        c.set("obj", null, new Path(".zilch"));
+        Path p = new Path(".whatevs");
+        c.set("obj", true, p);
+        c.set("obj", 42, p);
+        c.del("obj", p);                                    // back to almost nothing
+    }
+}