[feat] maxFacetHits (#311)

Author: PLNech

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

@@ -813,6 +813,19 @@ public Polygon(Polygon other) {
         }
     }
 
+    private static final String KEY_MAX_FACET_HITS = "maxFacetHits";
+
+    /**
+     * Limit the number of facet values returned for each facet.
+     */
+    public @NonNull Query setMaxFacetHits(Integer n) {
+        return set(KEY_MAX_FACET_HITS, n);
+    }
+
+    public Integer getMaxFacetHits() {
+        return parseInt(get(KEY_MAX_FACET_HITS));
+    }
+
     private static final String KEY_MAX_VALUES_PER_FACET = "maxValuesPerFacet";
 
     /**

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

@@ -644,6 +644,16 @@ public void removeStopWordsInvalidClass() throws Exception {
         fail("setRemoveStopWords should throw when its parameter is neither Boolean nor String.");
     }
 
+    @Test
+    public void maxFacetHits() {
+        Query query = new Query();
+        assertNull(query.getMaxFacetHits());
+        query.setMaxFacetHits(456);
+        assertEquals(Integer.valueOf(456), query.getMaxFacetHits());
+        assertEquals("456", query.get("maxFacetHits"));
+        assertEquals(query.getMaxFacetHits(), Query.parse(query.build()).getMaxFacetHits());
+    }
+
     @Test
     public void maxValuesPerFacet() {
         Query query = new Query();