Add downloadFolder method (#219)

Author: RTLcoil

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

@@ -284,6 +284,31 @@ public String downloadMulti(String[] urls, Map options) throws IOException {
         return buildUrl(cloudinaryApiUrl("multi", options), params);
     }
 
+    /**
+     * Generates URL for executing "Download Folder" operation on Cloudinary site.
+     * 
+     * @param folderPath path of folder to generate download URL for
+     * @param options    optional, holds hints for URL generation procedure, see documentation for full list
+     * @return generated URL for downloading specified folder as ZIP archive
+     */
+    public String downloadFolder(String folderPath, Map options) throws UnsupportedEncodingException {
+        if (StringUtils.isEmpty(folderPath)) {
+            throw new IllegalArgumentException("Folder path parameter value is required");
+        }
+
+        Map adjustedOptions = new HashMap();
+        if (options != null) {
+            adjustedOptions.putAll(options);
+        }
+
+        adjustedOptions.put("prefixes", folderPath);
+
+        final Object resourceType = adjustedOptions.get("resource_type");
+        adjustedOptions.put("resource_type", resourceType != null ? resourceType : "all");
+
+        return downloadArchive(adjustedOptions, (String) adjustedOptions.get("target_format"));
+    }
+
     private String buildUrl(String base, Map<String, Object> params) throws UnsupportedEncodingException {
         StringBuilder urlBuilder = new StringBuilder();
         urlBuilder.append(base);

cloudinary-core/src/test/java/com/cloudinary/test/CloudinaryTest.java

@@ -702,6 +702,37 @@ public void testDownloadMulti() throws Exception{
         assertNotNull(parameters.get("signature"));
 
     }
+
+    @Test
+    public void testDownloadFolderShouldReturnURLWithResourceTypeAllByDefault() throws UnsupportedEncodingException {
+        String url = cloudinary.downloadFolder("folder", null);
+        assertTrue(url.contains("all"));
+    }
+
+    @Test
+    public void testDownloadFolderShouldAllowToOverrideResourceType() throws UnsupportedEncodingException {
+        String url = cloudinary.downloadFolder("folder", Collections.singletonMap("resource_type", "audio"));
+        assertTrue(url.contains("audio"));
+    }
+
+    @Test
+    public void testDownloadFolderShouldPutFolderPathAsPrefixes() throws UnsupportedEncodingException {
+        String url = cloudinary.downloadFolder("folder", null);
+        assertTrue(url.contains("prefixes[]=folder"));
+    }
+
+    @Test
+    public void testDownloadFolderShouldIncludeSpecifiedTargetFormat() throws UnsupportedEncodingException {
+        String url = cloudinary.downloadFolder("folder", Collections.singletonMap("target_format", "rar"));
+        assertTrue(url.contains("target_format=rar"));
+    }
+
+    @Test
+    public void testDownloadFolderShouldNotIncludeTargetFormatIfNotSpecified() throws UnsupportedEncodingException {
+        String url = cloudinary.downloadFolder("folder", null);
+        assertFalse(url.contains("target_format"));
+    }
+
     @Test
     public void testSpriteCss() {
         String result = cloudinary.url().generateSpriteCss("test");