Merged WEBAPP-API (5.2.1) to 5.2.N (5.2.1)

135505 jkaabimofrad: APPSREPO-137: Made quick-share email template configurable via properties file. The template path property value could be an XPATH, a NodeRef of the template or a class path of the template.
       - Added a helper class to provide email template related utility functions
       - Added share as a default registered client for sending email - the template assets (images) will be available in share.


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/BRANCHES/DEV/5.2.N/root@135566 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/util/UrlUtil.java

@@ -2,7 +2,7 @@
  * #%L
  * Alfresco Repository
  * %%
- * Copyright (C) 2005 - 2016 Alfresco Software Limited
+ * Copyright (C) 2005 - 2017 Alfresco Software Limited
  * %%
  * This file is part of the Alfresco software. 
  * If the software was purchased under a paid Alfresco license, the terms of 
@@ -28,6 +28,7 @@ package org.alfresco.util;
 
 import org.alfresco.repo.admin.SysAdminParams;
 
+import java.util.regex.Pattern;
 
 /**
  * Alfresco URL related utility functions.
@@ -36,6 +37,9 @@ import org.alfresco.repo.admin.SysAdminParams;
  */
 public class UrlUtil
 {
+    // ${shareUrl} placeholder
+    public static final Pattern PATTERN = Pattern.compile("\\$\\{shareUrl\\}");
+
     /**
      * Builds up the Url to Alfresco based on the settings in the 
      *  {@link SysAdminParams}. 
@@ -65,7 +69,25 @@ public class UrlUtil
                 sysAdminParams.getSharePort(),
                 sysAdminParams.getShareContext());
     }
-    
+
+    /**
+     * Replaces the share url placeholder, namely {@literal ${shareUrl}}, with <b>share</b> url.
+     *
+     * @param value          the string value which contains the share url placeholder
+     * @param sysAdminParams the {@code SysAdminParams} object
+     * @return if the given {@code value} contains share url placeholder,
+     * the placeholder is replaced with share url; otherwise, the given {@code value} is simply returned
+     */
+    public static String replaceShareUrlPlaceholder(String value, SysAdminParams sysAdminParams)
+    {
+        if (value != null)
+        {
+            return PATTERN.matcher(value).replaceAll(
+                        getShareUrl(sysAdminParams));
+        }
+        return value;
+    }
+
     protected static String buildUrl(String protocol, String host, int port, String context)
     {
         StringBuilder url = new StringBuilder();