Add analytics support to url-gen

Author: adimiz1

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

@@ -5,6 +5,7 @@
 import com.cloudinary.strategies.AbstractApiStrategy;
 import com.cloudinary.strategies.AbstractUploaderStrategy;
 import com.cloudinary.strategies.StrategyLoader;
+import com.cloudinary.utils.AnalyticsUtils;
 import com.cloudinary.utils.ObjectUtils;
 import com.cloudinary.utils.StringUtils;
 
@@ -153,6 +154,14 @@ public void setUserAgent(String prefix, String version){
         userAgent = prefix+"/"+ version + " ("+USER_AGENT_PREFIX+ " "+VERSION+") " + USER_AGENT_JAVA_VERSION;
     }
 
+    /**
+     * Set the analytics token that will be sent with every URL generate call
+     * @param token - the analytics token to be set
+     */
+    public void setAnalyticsToken(String token) {
+        AnalyticsUtils.token = token;
+    }
+
     /**
      * Verifies that Cloudinary notification request is genuine by checking its signature.
      *

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

@@ -13,6 +13,7 @@
 import java.util.regex.Pattern;
 import java.util.zip.CRC32;
 
+import com.cloudinary.utils.AnalyticsUtils;
 import com.cloudinary.utils.Base64Coder;
 import com.cloudinary.utils.ObjectUtils;
 import com.cloudinary.utils.StringUtils;
@@ -417,6 +418,9 @@ public String generate(String source) {
             } catch (MalformedURLException ignored) {
             }
         }
+        if (AnalyticsUtils.token != null) {
+            url = (new StringBuilder()).append(url).append(AnalyticsUtils.analyticsPrefix).append(AnalyticsUtils.token).toString();
+        }
         return url;
     }
 

cloudinary-core/src/main/java/com/cloudinary/utils/AnalyticsUtils.java

@@ -0,0 +1,6 @@
+package com.cloudinary.utils;
+
+public class AnalyticsUtils {
+    public static String analyticsPrefix = "?_a=";
+    public static String token = null;
+}

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

@@ -2,6 +2,7 @@
 
 import com.cloudinary.*;
 import com.cloudinary.transformation.*;
+import com.cloudinary.utils.AnalyticsUtils;
 import com.cloudinary.utils.ObjectUtils;
 import junitparams.JUnitParamsRunner;
 import junitparams.Parameters;
@@ -1454,4 +1455,19 @@ private void setRandomValue(Random rand, Field field, Object instance) throws Il
     private <T extends Enum<?>> T randomEnum(Class<T> clazz, Random random) {
         return clazz.getEnumConstants()[random.nextInt(clazz.getEnumConstants().length)];
     }
+
+    @Test
+    public void testUrlWithAnalytics() {
+        AnalyticsUtils.token = "AFAACAI0";
+        String url = cloudinary.url().generate("test");
+        assertEquals(url,"http://res.cloudinary.com/test123/image/upload/test?_a=AFAACAI0");
+        AnalyticsUtils.token = null;
+    }
+
+    @Test
+    public void testUrlWithNoAnalytics() {
+        AnalyticsUtils.token = null;
+        String url = cloudinary.url().generate("test");
+        assertEquals(url,"http://res.cloudinary.com/test123/image/upload/test");
+    }
 }