Merge pull request #17 from algolia/feat-snippet-ellipsis-text

New `snippetEllipsisText` search parameter exposed

Author: ElPicador

README.md

@@ -351,6 +351,7 @@ You can use the following optional arguments:
  * **setAttributesToSnippet**: The list of attributes to snippet alongside the number of words to return (syntax is `attributeName:nbWords`). By default, no snippet is computed.
  * **getRankingInfo**: If set to true, the result hits will contain ranking information in the **_rankingInfo** attribute.
  * **setHighlightingTags**: (string, string) Specify the string that is inserted before the highlighted parts in the query result (defaults to "<em>") and the string that is inserted after the highlighted parts in the query result (defaults to "</em>")..
+ * **setSnippetEllipsisText**: (string) String used as an ellipsis indicator when a snippet is truncated (defaults to empty).
 
 
 #### Numeric Search Parameters

algoliasearch/src/main/java/com/algolia/search/saas/Query.java

@@ -97,6 +97,7 @@ public enum TypoTolerance {
     protected String tags;
     protected String highlightPreTag;
     protected String highlightPostTag;
+    protected String snippetEllipsisText;
     protected Integer minProximity;
     protected String numerics;
     protected String insideBoundingBox;
@@ -167,6 +168,7 @@ public Query(Query other) {
         minProximity = other.minProximity;
         highlightPreTag = other.highlightPreTag;
         highlightPostTag = other.highlightPostTag;
+        snippetEllipsisText = other.snippetEllipsisText;
         distinct = other.distinct;
         advancedSyntax = other.advancedSyntax;
 	removeStopWords = other.removeStopWords;
@@ -407,6 +409,15 @@ public Query setHighlightingTags(String preTag, String postTag) {
         return this;
     }
 
+    /**
+     * Specify the string that is used as an ellipsis indicator when a snippet
+     * is truncated (defaults to the empty string).
+     */
+    public Query setSnippetEllipsisText(String snippetEllipsisText) {
+        this.snippetEllipsisText = snippetEllipsisText;
+        return this;
+    }
+
     /**
      * Specify the minimum number of characters in a query word to accept two
      * typos in this word. Defaults to 7.
@@ -954,6 +965,12 @@ protected String getQueryString() {
                 stringBuilder.append("&highlightPostTag=");
                 stringBuilder.append(highlightPostTag);
             }
+            if (snippetEllipsisText != null) {
+                if (stringBuilder.length() > 0)
+                    stringBuilder.append('&');
+                stringBuilder.append("snippetEllipsisText=");
+                stringBuilder.append(URLEncoder.encode(snippetEllipsisText, "UTF-8"));
+            }
             if (hitsPerPage != null) {
                 if (stringBuilder.length() > 0)
                     stringBuilder.append('&');