Add support for Etherpad API version 1.2.13.

Author: Nils Fredrik Gjerull

Diff for: README.md

@@ -30,7 +30,7 @@ The methods are 1:1 with the EPLite API methods.
 Depends on JSON.simple (https://github.com/fangyidong/json-simple).
 
 ### NOTES ###
-HEAD currently targets Etherpad Lite API v1.2.12.
+Latest release currently targets Etherpad Lite API v1.2.12.
 The plan is to keep up with the most recent version of the Etherpad Lite API.
 (Note that we're talking about API versions here, not release versions).
 

Diff for: src/main/java/net/gjerull/etherpad/client/EPLiteClient.java

@@ -16,7 +16,7 @@
  * </code>
  */
 public class EPLiteClient {
-    private static final String DEFAULT_API_VERSION = "1.2.12";
+    private static final String DEFAULT_API_VERSION = "1.2.13";
     private static final String DEFAULT_ENCODING = "UTF-8";
     private final EPLiteConnection connection;
 
@@ -129,7 +129,8 @@ public Map listAllGroups() {
     }
 
     // Authors
-    // These authors are bound to the attributes the users choose (color and name). The author id is returned in "authorID".
+    // These authors are bound to the attributes the users choose (color and name).
+    // The author id is returned in "authorID".
 
     /**
      * Create a new author.
@@ -153,7 +154,8 @@ public Map createAuthor(String name) {
     }
 
     /**
-     * Creates a new Author for authorMapper if one doesn't already exist. Helps you map your application's authors to Etherpad Lite's authors.
+     * Creates a new Author for authorMapper if one doesn't already exist.
+     * Helps you map your application's authors to Etherpad Lite's authors.
      * The author id is returned in "authorID".
      * 
      * @param authorMapper string
@@ -166,7 +168,8 @@ public Map createAuthorIfNotExistsFor(String authorMapper) {
     }
 
     /**
-     * Creates a new Author for authorMapper if one doesn't already exist. Helps you map your application's authors to Etherpad Lite's authors.
+     * Creates a new Author for authorMapper if one doesn't already exist.
+     * Helps you map your application's authors to Etherpad Lite's authors.
      * The author id is returned in "authorID".
      * 
      * @param authorMapper string
@@ -363,7 +366,7 @@ public Map getText(String padId, long rev) {
     }
 
     /**
-     * Creates a new revision with the given text (or creates a new pad).
+     * Creates a new revision with the given text.
      * 
      * @param padId the pad's id string
      * @param text the pad's new text
@@ -375,6 +378,21 @@ public void setText(String padId, String text) {
         this.connection.post("setText", args);
     }
 
+    /**
+     * Creates a new revision with the given text appended to the existing text.
+     *
+     * API >= 1.2.13
+     *
+     * @param padId the pad's id string
+     * @param text the pad's new text
+     */
+    public void appendText(String padId, String text) {
+        Map<String,Object> args = new HashMap<>();
+        args.put("padID", padId);
+        args.put("text", text);
+        this.connection.post("appendText", args);
+    }
+
     /**
      * Returns a Map containing the current revision of the pad's text as HTML.
      * The html is stored under "html".
@@ -404,7 +422,7 @@ public Map getHTML(String padId, long rev) {
     }
 
     /**
-     * Creates a new revision with the given html (or creates a new pad).
+     * Creates a new revision with the given html.
      * 
      * @param padId the pad's id string
      * @param html the pad's new html text

Diff for: src/test/java/net/gjerull/etherpad/client/EPLiteClientIntegrationTest.java

@@ -143,7 +143,6 @@ public void create_author_with_author_mapper() throws Exception {
 
         assertEquals(secondAuthorName, thirdAuthorName);
     }
-
     @Test
     public void create_and_delete_session() throws Exception {
         String authorMapper = "username";
@@ -169,7 +168,7 @@ public void create_and_delete_session() throws Exception {
             Map sessionInfo = client.getSessionInfo(secondSessionId);
             assertEquals(groupId, sessionInfo.get("groupID"));
             assertEquals(authorId, sessionInfo.get("authorID"));
-            assertEquals(sessionValidUntil.getTime() / 1000, (long) sessionInfo.get("validUntil"));
+            assertEquals(sessionValidUntil.getTime() / 1000L, (long) sessionInfo.get("validUntil"));
 
             Map sessionsOfGroup = client.listSessionsOfGroup(groupId);
             sessionInfo = (Map) sessionsOfGroup.get(firstSessionId);
@@ -225,6 +224,10 @@ public void create_pad_set_and_get_content() {
                     "<span class=\"removed\">g&#229; &#229; gj&#248;r et &#230;rend</span>"
             ));
 
+            client.appendText(padID, "lagt til nå");
+            text = (String) client.getText(padID).get("text");
+            assertEquals("gå og gjøre et ærend igjen\nlagt til nå\n", text);
+
             Map attributePool = (Map) client.getAttributePool(padID).get("pool");
             assertTrue(attributePool.containsKey("attribToNum"));
             assertTrue(attributePool.containsKey("nextNum"));
@@ -239,7 +242,7 @@ public void create_pad_set_and_get_content() {
             List savedRevisions = (List) client.listSavedRevisions(padID).get("savedRevisions");
             assertEquals(2, savedRevisions.size());
             assertEquals(2L, savedRevisions.get(0));
-            assertEquals(3L, savedRevisions.get(1));
+            assertEquals(4L, savedRevisions.get(1));
 
             long padUsersCount = (long) client.padUsersCount(padID).get("padUsersCount");
             assertEquals(0, padUsersCount);