Merge DEV\WCM_SERVICES2 to HEAD

12513 Implementation of Asset.getProperties
    12469 Implement paths relative to web app.  And unit tests.   Asset Test is now clean of TODOs.
    12413  Implementation of WCM Asset.    Still work remaining but this is 80% of the implementation.
    12404 WCM Services
        - asset service - fix rename/move folder issue (folders are not locked)
        - sandbox service - fix delete sandbox test
    12374 WCM Services - optimise get/is web project
    12347  WCM Services - "asset service" - add/remove/has aspect, get aspects
    12341  WCM Services - "asset service" checkpoint (locking fixes, bulk import, more tests added)




git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@12547 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/wcm/asset/AssetService.java

@@ -28,6 +28,7 @@ import java.io.File;
 import java.io.Serializable;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 
 import org.alfresco.service.cmr.repository.ContentReader;
 import org.alfresco.service.cmr.repository.ContentWriter;
@@ -175,6 +176,40 @@ public interface AssetService
      */
     public void updateAssetProperties(AssetInfo asset, Map<QName, Serializable> properties);
     
+    /**
+     * Apply aspect to asset, with given properties (can be null)
+     * 
+     * @param asset
+     * @param aspectName
+     * @param properties
+     */
+    public void addAspect(AssetInfo asset, QName aspectName, Map<QName, Serializable> properties);
+    
+    /**
+     * Remove aspect from asset, and any related properties
+     * 
+     * @param asset
+     * @param aspectName
+     */
+    public void removeAspect(AssetInfo asset, QName aspectName);
+    
+    /**
+     * Get set of aspects applied to asset
+     * 
+     * @param asset
+     * @return list of aspects
+     */
+    public Set<QName> getAspects(AssetInfo asset);
+    
+    /**
+     * True, if asset has given aspect applied
+     * 
+     * @param asset
+     * @param aspectName
+     * @return
+     */
+    public boolean hasAspect(AssetInfo asset, QName aspectName);
+    
     /**
      * List assets within given sandbox and webApp and path (within webApp), optionally include deleted
      * 
@@ -182,7 +217,7 @@ public interface AssetService
      * @param webApp
      * @param parentFolderPathRelativeToWebApp
      * @param includeDeleted
-     * @return
+     * @return list of assets
      */
     public List<AssetInfo> listAssetsWebApp(String sbStoreId, String webApp, String parentFolderPathRelativeToWebApp, boolean includeDeleted);
     
@@ -192,7 +227,7 @@ public interface AssetService
      * @param sbStoreId
      * @param parentFolderPath
      * @param includeDeleted
-     * @return
+     * @return list of assets
      */
     public List<AssetInfo> listAssets(String sbStoreId, String parentFolderPath, boolean includeDeleted);
     
@@ -203,7 +238,7 @@ public interface AssetService
      * @param version
      * @param parentFolderPath
      * @param includeDeleted
-     * @return
+     * @return list of assets
      */
     public List<AssetInfo> listAssets(String sbStoreId, int version, String parentFolderPath, boolean includeDeleted);