Add Search folders functionality

Author: adimiz1

cloudinary-core/src/main/java/com/cloudinary/Cloudinary.java

@@ -59,6 +59,10 @@ public Search search() {
         return new Search(this);
     }
 
+    public SearchFolders searchFolders() {
+        return new SearchFolders(this);
+    }
+
     public static void registerUploaderStrategy(String className) {
         if (!UPLOAD_STRATEGIES.contains(className)) {
             UPLOAD_STRATEGIES.add(className);

cloudinary-core/src/main/java/com/cloudinary/Search.java

@@ -10,7 +10,7 @@
 
 public class Search {
 
-    private final Api api;
+    protected final Api api;
     private ArrayList<HashMap<String, Object>> sortByParam;
     private ArrayList<String> aggregateParam;
     private ArrayList<String> withFieldParam;

cloudinary-core/src/main/java/com/cloudinary/SearchFolders.java

@@ -0,0 +1,19 @@
+package com.cloudinary;
+
+import com.cloudinary.api.ApiResponse;
+import com.cloudinary.utils.ObjectUtils;
+
+import java.util.Arrays;
+import java.util.Map;
+
+public class SearchFolders extends Search {
+
+    public SearchFolders(Cloudinary cloudinary) {
+        super(cloudinary);
+    }
+
+    public ApiResponse execute() throws Exception {
+        Map<String, String> options = ObjectUtils.asMap("content_type", "json");
+        return this.api.callApi(Api.HttpMethod.POST, Arrays.asList("folders", "search"), this.toQuery(), options);
+    }
+}

cloudinary-test-common/src/main/java/com/cloudinary/test/AbstractSearchTest.java

@@ -9,6 +9,9 @@
 import java.lang.reflect.Field;
 import java.util.*;
 
+import static org.hamcrest.Matchers.hasEntry;
+import static org.hamcrest.Matchers.hasItem;
+import static org.hamcrest.core.AllOf.allOf;
 import static org.junit.Assert.*;
 import static org.junit.Assume.assumeNotNull;
 
@@ -19,6 +22,7 @@ abstract public class AbstractSearchTest extends MockableTest {
     private static final String SEARCH_TAG = "search_test_tag_" + SUFFIX;
     public static final String[] UPLOAD_TAGS = {SDK_TEST_TAG, SEARCH_TAG};
     private static final String SEARCH_TEST = "search_test_" + SUFFIX;
+    private static final String SEARCH_FOLDER = "search_folder_" + SUFFIX;
     private static final String SEARCH_TEST_1 = SEARCH_TEST + "_1";
     private static final String SEARCH_TEST_2 = SEARCH_TEST + "_2";
     private static String SEARCH_TEST_ASSET_ID_1;
@@ -44,6 +48,11 @@ public static void setUpClass() throws Exception {
     public static void tearDownClass() throws Exception {
         Cloudinary cloudinary = new Cloudinary();
         cloudinary.api().deleteResourcesByTag(SEARCH_TAG, null);
+        try {
+            cloudinary.api().deleteFolder(SEARCH_FOLDER, null);
+        } catch (Exception e){
+            System.err.println(e.getMessage());
+        }
     }
 
     @Before
@@ -60,6 +69,14 @@ public void shouldFindResourcesByTag() throws Exception {
         assertEquals(3, resources.size());
     }
 
+    @Test
+    public void shouldFindFolders() throws Exception {
+        cloudinary.api().createFolder(SEARCH_FOLDER, null);
+        Map result = cloudinary.searchFolders().expression(String.format("name:%s", SEARCH_FOLDER)).execute();
+        final List<Map> folders = (List) result.get("folders");
+        assertThat(folders, hasItem(hasEntry("name", SEARCH_FOLDER)));
+    }
+
     @Test
     public void shouldFindResourceByPublicId() throws Exception {
         Map result = cloudinary.search().expression(String.format("public_id:%s", SEARCH_TEST_1)).execute();