Merged HEAD (5.2) to 5.2.N (5.2.1)

126436 jkaabimofrad: Merged FILE-FOLDER-API (5.2.0) to HEAD (5.2)
      121917 jkaabimofrad: RA-778: Added support for QuickShare service to email users notifying them that a content has been shared with them.


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

source/java/org/alfresco/rest/api/QuickShareLinks.java

@@ -19,15 +19,18 @@
 package org.alfresco.rest.api;
 
 import org.alfresco.rest.api.model.QuickShareLink;
+import org.alfresco.rest.api.model.QuickShareLinkEmailRequest;
 import org.alfresco.rest.framework.core.exceptions.EntityNotFoundException;
 import org.alfresco.rest.framework.resource.content.BinaryResource;
 import org.alfresco.rest.framework.resource.parameters.Parameters;
+
 import java.util.List;
 
 /**
  * Centralises access to quick share services and maps between representations.
  *
  * @author janv
+ * @author Jamal Kaabi-Mofrad
  * 
  * @since publicapi1.0
  */
@@ -74,4 +77,13 @@ public interface QuickShareLinks
      * @return
      */
     List<QuickShareLink> create(List<QuickShareLink> nodeIds, Parameters parameters);
+
+    /**
+     * Notifies users by email that a content has been shared with them.
+     *
+     * @param nodeId       The content id
+     * @param emailRequest The email details including its template details
+     * @param parameters   The {@link Parameters} object to get the parameters passed into the request
+     */
+    void emailSharedLink(String nodeId, QuickShareLinkEmailRequest emailRequest, Parameters parameters);
 }