[feat] facetingAfterDistinct (#300)

* [feat] implement facetingAfterDistinct in Query

* [feat] facetingAfterDistinct: better warning about parameter

* chore: Update link to target API Client doc

Author: PLNech

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

@@ -373,6 +373,22 @@ public String[] getFacets() {
         return null;
     }
 
+    private static final String KEY_FACETING_AFTER_DISTINCT = "facetingAfterDistinct";
+
+    public @Nullable Boolean getFacetingAfterDistinct() {
+        return parseBoolean(get(KEY_FACETING_AFTER_DISTINCT));
+    }
+
+    /**
+     * Force faceting to be applied after de-duplication. Please check <a href="https://www.algolia.com/doc/rest-api/search/#facetingafterdistinct">documentation</a> for consequences and limitations
+     *
+     * @param enabled if {@code true}, facets will be computed after de-duplication is applied.
+     * @see <a href="https://www.algolia.com/doc/api-client/android/parameters/#facetingafterdistinct">facetingAfterDistinct's documentation</a>
+     */
+    public @NonNull Query setFacetingAfterDistinct(Boolean enabled) {
+        return set(KEY_FACETING_AFTER_DISTINCT, enabled);
+    }
+
     private static final String KEY_FILTERS = "filters";
 
     /**

algoliasearch/src/test/java/com/algolia/search/saas/QueryTest.java

@@ -763,4 +763,15 @@ public void responseFields() throws UnsupportedEncodingException {
         expected = "responseFields=" + URLEncoder.encode("[\"hits\",\"page\"]", "UTF-8");
         assertTrue("The built query should contain \"" + expected + "\", but contains _" + queryStr + "_.", queryStr.contains(expected));
     }
+
+
+    @Test
+    public void facetingAfterDistinct() {
+        Query query = new Query();
+        assertNull(query.getFacetingAfterDistinct());
+        query.setFacetingAfterDistinct(true);
+        assertEquals(Boolean.TRUE, query.getFacetingAfterDistinct());
+        assertEquals("true", query.get("facetingAfterDistinct"));
+        assertEquals(query.getFacetingAfterDistinct(), Query.parse(query.build()).getFacetingAfterDistinct());
+    }
 }