org.exoplatform.clouddrive.ecms.action

Class CloudFileActionService

java.lang.Object

org.exoplatform.clouddrive.ecms.action.CloudFileActionService

All Implemented Interfaces:

org.picocontainer.Startable

public class CloudFileActionService
extends Object
implements org.picocontainer.Startable

Integration of Cloud Drive with eXo Platform apps.
Created by The eXo Platform SAS

Version:

$Id: CloudFileActionService.java 00000 Jul 6, 2015 pnedonosko $

Author:

Peter Nedonosko

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	CloudFileActionService.LinkRemoveListener Act on ecd:cloudFileLinkGroup property removal on a cloud file symlink and then unshare the file from the group where it was shared by the link.
protected class	CloudFileActionService.LinkTrashListener Act on Cloud File symlink trashing.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.exoplatform.clouddrive.CloudDriveService	cloudDrive
protected org.exoplatform.services.cms.CmsService	cmsService
protected org.exoplatform.services.cms.drives.ManageDriveService	documentDrives
protected static String	ECD_CLOUDFILELINK
protected static String	ECD_SHAREIDENTITY
protected static String	EXO_OWNEABLE
protected static String	EXO_PRIVILEGEABLE
protected static String	EXO_TRASHFOLDER
protected org.exoplatform.clouddrive.jcr.NodeFinder	finder Node finder facade on actual storage implementation.
protected String	groupsPath
protected org.exoplatform.services.jcr.ext.hierarchy.NodeHierarchyCreator	hierarchyCreator
protected org.exoplatform.services.jcr.RepositoryService	jcrService
protected org.exoplatform.services.cms.link.LinkManager	linkManager
protected org.exoplatform.services.listener.ListenerService	listenerService
protected static org.exoplatform.services.log.Log	LOG
protected static String[]	MANAGER_PERMISSION
protected static String	MIX_VERSIONABLE
protected org.exoplatform.services.organization.OrganizationService	orgService
protected static String[]	READER_PERMISSION
protected Map<String,String>	removedLinks Symlink to cloud file UUID mappings.
protected Map<String,String>	removedShared Cloud file UUID to shared group name mappings.
protected org.exoplatform.services.jcr.ext.app.SessionProviderService	sessionProviders
protected static String	SHARE_CLOUD_FILES_SPACES
protected static String	SPACES_GROUP
protected org.exoplatform.services.cms.documents.TrashService	trash
protected String	usersPath
protected org.exoplatform.clouddrive.ThreadExecutor	workerExecutor Trashed symlinks removal workers.

Constructor Summary

Constructors

Constructor and Description

CloudFileActionService(org.exoplatform.clouddrive.CloudDriveService cloudDrive, org.exoplatform.services.jcr.RepositoryService jcrService, org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders, org.exoplatform.services.organization.OrganizationService orgService, org.exoplatform.clouddrive.jcr.NodeFinder finder, org.exoplatform.services.jcr.ext.hierarchy.NodeHierarchyCreator hierarchyCreator, org.exoplatform.services.cms.link.LinkManager linkManager, org.exoplatform.services.cms.drives.ManageDriveService documentDrives, org.exoplatform.services.cms.documents.TrashService trash, org.exoplatform.services.listener.ListenerService listeners, org.exoplatform.services.cms.CmsService cmsService)

Method Summary

Methods

Modifier and Type	Method and Description
protected String	documentName(javax.jcr.Node document) Find pretty name of the document.
protected javax.jcr.NodeIterator	getCloudFileLinks(javax.jcr.Node targetNode, String shareIdentity, boolean useSystemSession)
String	getDriveNameFromPath(String nodePath) Deprecated.
org.exoplatform.services.cms.drives.DriveData	getNodeDrive(javax.jcr.Node node)
org.exoplatform.services.cms.drives.DriveData	getUserDrive(String userName)
javax.jcr.Node	getUserPublicNode(String userName)
boolean	isGroupDrive(org.exoplatform.services.cms.drives.DriveData drive)
boolean	isUserDrive(org.exoplatform.services.cms.drives.DriveData drive)
javax.jcr.Node	linkFile(javax.jcr.Node srcNode, javax.jcr.Node destNode, String destIdentity)
javax.jcr.Node	linkShareToUser(javax.jcr.Node fileNode, org.exoplatform.clouddrive.CloudDrive fileDrive, String userName)
protected void	listenFileLinks()
javax.jcr.Node	markRemoveLink(javax.jcr.Node linkNode)
String	postSharedActivity(javax.jcr.Node node, javax.jcr.Node link, String comment)
void	removeLinks(javax.jcr.Node fileNode, String shareIdentity)
protected void	removePermissions(javax.jcr.Node node, boolean deep, String... identities) Remove read permissions on the target node for all given identities (e.g.
protected void	setAllPermissions(javax.jcr.Node node, String... identities) Set all available permissions to given node for given identities.
protected void	setParentPermissions(javax.jcr.Node parent, String... identities) Set permissions on a parent node of a link target: all child nodes will become exo:privilegeable (thus copy permissions from its priviligeable parent).
protected void	setPermissions(javax.jcr.Node node, boolean deep, boolean forcePrivilegeable, String... identities) Set read permissions on the target node to all given identities (e.g.
protected void	setPermissions(javax.jcr.Node node, String... identities) Set read permissions on the target node to all given identities (e.g.
void	shareCloudFile(javax.jcr.Node fileNode, org.exoplatform.clouddrive.CloudDrive cloudDrive, String... identities)
void	start()
void	stop()
protected javax.jcr.Session	systemSession() System session in default workspace of current JCR repository.
void	unshareCloudFile(javax.jcr.Node fileNode, org.exoplatform.clouddrive.CloudDrive cloudDrive, String... identities)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOG

protected static final org.exoplatform.services.log.Log LOG

SPACES_GROUP

protected static final String SPACES_GROUP

See Also:

Constant Field Values

SHARE_CLOUD_FILES_SPACES

protected static final String SHARE_CLOUD_FILES_SPACES

See Also:

Constant Field Values

EXO_OWNEABLE

protected static final String EXO_OWNEABLE

See Also:

Constant Field Values

EXO_PRIVILEGEABLE

protected static final String EXO_PRIVILEGEABLE

See Also:

Constant Field Values

ECD_CLOUDFILELINK

protected static final String ECD_CLOUDFILELINK

See Also:

Constant Field Values

ECD_SHAREIDENTITY

protected static final String ECD_SHAREIDENTITY

See Also:

Constant Field Values

MIX_VERSIONABLE

protected static final String MIX_VERSIONABLE

See Also:

Constant Field Values

EXO_TRASHFOLDER

protected static final String EXO_TRASHFOLDER

See Also:

Constant Field Values

READER_PERMISSION

protected static final String[] READER_PERMISSION

MANAGER_PERMISSION

protected static final String[] MANAGER_PERMISSION

cloudDrive

protected final org.exoplatform.clouddrive.CloudDriveService cloudDrive

jcrService

protected final org.exoplatform.services.jcr.RepositoryService jcrService

hierarchyCreator

protected final org.exoplatform.services.jcr.ext.hierarchy.NodeHierarchyCreator hierarchyCreator

sessionProviders

protected final org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders

orgService

protected final org.exoplatform.services.organization.OrganizationService orgService

linkManager

protected final org.exoplatform.services.cms.link.LinkManager linkManager

documentDrives

protected final org.exoplatform.services.cms.drives.ManageDriveService documentDrives

trash

protected final org.exoplatform.services.cms.documents.TrashService trash

listenerService

protected final org.exoplatform.services.listener.ListenerService listenerService

cmsService

protected final org.exoplatform.services.cms.CmsService cmsService

removedLinks

protected final Map<String,String> removedLinks

Symlink to cloud file UUID mappings.

removedShared

protected final Map<String,String> removedShared

Cloud file UUID to shared group name mappings.

finder

protected final org.exoplatform.clouddrive.jcr.NodeFinder finder

Node finder facade on actual storage implementation.

workerExecutor

protected final org.exoplatform.clouddrive.ThreadExecutor workerExecutor

Trashed symlinks removal workers.

groupsPath

protected final String groupsPath

usersPath

protected final String usersPath

Constructor Detail

CloudFileActionService

public CloudFileActionService(org.exoplatform.clouddrive.CloudDriveService cloudDrive,
                      org.exoplatform.services.jcr.RepositoryService jcrService,
                      org.exoplatform.services.jcr.ext.app.SessionProviderService sessionProviders,
                      org.exoplatform.services.organization.OrganizationService orgService,
                      org.exoplatform.clouddrive.jcr.NodeFinder finder,
                      org.exoplatform.services.jcr.ext.hierarchy.NodeHierarchyCreator hierarchyCreator,
                      org.exoplatform.services.cms.link.LinkManager linkManager,
                      org.exoplatform.services.cms.drives.ManageDriveService documentDrives,
                      org.exoplatform.services.cms.documents.TrashService trash,
                      org.exoplatform.services.listener.ListenerService listeners,
                      org.exoplatform.services.cms.CmsService cmsService)

Method Detail

isGroupDrive

public boolean isGroupDrive(org.exoplatform.services.cms.drives.DriveData drive)

isUserDrive

public boolean isUserDrive(org.exoplatform.services.cms.drives.DriveData drive)

linkShareToUser

public javax.jcr.Node linkShareToUser(javax.jcr.Node fileNode,
                             org.exoplatform.clouddrive.CloudDrive fileDrive,
                             String userName)
                               throws Exception

Throws:

Exception

getUserDrive

public org.exoplatform.services.cms.drives.DriveData getUserDrive(String userName)
                                                           throws Exception

Throws:

Exception

getUserPublicNode

public javax.jcr.Node getUserPublicNode(String userName)
                                 throws Exception

Throws:

Exception

removeLinks

public void removeLinks(javax.jcr.Node fileNode,
               String shareIdentity)
                 throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException

getNodeDrive

public org.exoplatform.services.cms.drives.DriveData getNodeDrive(javax.jcr.Node node)
                                                           throws Exception

Throws:

Exception

getDriveNameFromPath

@Deprecated
public String getDriveNameFromPath(String nodePath)
                            throws CloudFileActionException

Deprecated.

Throws:

CloudFileActionException

linkFile

public javax.jcr.Node linkFile(javax.jcr.Node srcNode,
                      javax.jcr.Node destNode,
                      String destIdentity)
                        throws org.exoplatform.clouddrive.NotCloudDriveException,
                               org.exoplatform.clouddrive.DriveRemovedException,
                               javax.jcr.RepositoryException,
                               org.exoplatform.clouddrive.CloudDriveException

Throws:

org.exoplatform.clouddrive.NotCloudDriveException

org.exoplatform.clouddrive.DriveRemovedException

javax.jcr.RepositoryException

org.exoplatform.clouddrive.CloudDriveException

markRemoveLink

public javax.jcr.Node markRemoveLink(javax.jcr.Node linkNode)
                              throws org.exoplatform.clouddrive.NotCloudDriveException,
                                     org.exoplatform.clouddrive.DriveRemovedException,
                                     javax.jcr.RepositoryException,
                                     org.exoplatform.clouddrive.CloudDriveException

Throws:

org.exoplatform.clouddrive.NotCloudDriveException

org.exoplatform.clouddrive.DriveRemovedException

javax.jcr.RepositoryException

org.exoplatform.clouddrive.CloudDriveException

shareCloudFile

public void shareCloudFile(javax.jcr.Node fileNode,
                  org.exoplatform.clouddrive.CloudDrive cloudDrive,
                  String... identities)
                    throws org.exoplatform.clouddrive.NotCloudDriveException,
                           org.exoplatform.clouddrive.DriveRemovedException,
                           javax.jcr.RepositoryException,
                           org.exoplatform.clouddrive.CloudDriveException

Throws:

org.exoplatform.clouddrive.NotCloudDriveException

org.exoplatform.clouddrive.DriveRemovedException

javax.jcr.RepositoryException

org.exoplatform.clouddrive.CloudDriveException

unshareCloudFile

public void unshareCloudFile(javax.jcr.Node fileNode,
                    org.exoplatform.clouddrive.CloudDrive cloudDrive,
                    String... identities)
                      throws org.exoplatform.clouddrive.NotCloudDriveException,
                             org.exoplatform.clouddrive.DriveRemovedException,
                             javax.jcr.RepositoryException,
                             org.exoplatform.clouddrive.CloudDriveException

Throws:

org.exoplatform.clouddrive.NotCloudDriveException

org.exoplatform.clouddrive.DriveRemovedException

javax.jcr.RepositoryException

org.exoplatform.clouddrive.CloudDriveException

postSharedActivity

public String postSharedActivity(javax.jcr.Node node,
                        javax.jcr.Node link,
                        String comment)
                          throws org.exoplatform.clouddrive.CloudDriveException

Throws:

org.exoplatform.clouddrive.CloudDriveException

start

public void start()

Specified by:

start in interface org.picocontainer.Startable

stop

public void stop()

Specified by:

stop in interface org.picocontainer.Startable

listenFileLinks

protected void listenFileLinks()
                        throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException

setPermissions

protected void setPermissions(javax.jcr.Node node,
                  String... identities)
                       throws AccessControlException,
                              javax.jcr.RepositoryException

Set read permissions on the target node to all given identities (e.g. space group members). If node not yet exo:privilegeable it will add such mixin to allow set the permissions first. Requested permissions will be set to all children nodes if the child already exo:privilegeable.

Parameters:

node - Node link target node

identities - array of String with user identifiers (names or memberships)

Throws:

AccessControlException

javax.jcr.RepositoryException

setPermissions

protected void setPermissions(javax.jcr.Node node,
                  boolean deep,
                  boolean forcePrivilegeable,
                  String... identities)
                       throws AccessControlException,
                              javax.jcr.RepositoryException

Set read permissions on the target node to all given identities (e.g. space group members). Permissions will not be set if target not exo:privilegeable and forcePrivilegeable is false. If deep is true the target children nodes will be checked also for a need to set the requested permissions.

Parameters:

node - Node link target node

deep - Boolean if true then also children nodes will be set to the requested permissions

forcePrivilegeable - Boolean if true and node not yet exo:privilegeable it will add such mixin to allow set the permissions.

identities - array of String with user identifiers (names or memberships)

Throws:

AccessControlException

javax.jcr.RepositoryException

removePermissions

protected void removePermissions(javax.jcr.Node node,
                     boolean deep,
                     String... identities)
                          throws AccessControlException,
                                 javax.jcr.RepositoryException

Remove read permissions on the target node for all given identities (e.g. space group members). If deep is true then permissions will be removed on all ancestor nodes (sub-tree for folders).

Parameters:

node - Node link target node

deep - Boolean if true then also remove the permissions from children nodes

identities - array of String with user identifiers (names or memberships)

Throws:

AccessControlException

javax.jcr.RepositoryException

setParentPermissions

protected void setParentPermissions(javax.jcr.Node parent,
                        String... identities)
                             throws AccessControlException,
                                    javax.jcr.RepositoryException

Set permissions on a parent node of a link target: all child nodes will become exo:privilegeable (thus copy permissions from its priviligeable parent). If a child already of priviligeable type - nothing will be performed, by this we assume its permissions already handled as required. After this read permissions will be added to the parent node.
This method SHOULD be used before setting permissions to a link target node in this parent. In this way we will keep permission of the target in consistent state.

Parameters:

parent -

identities -

Throws:

AccessControlException

javax.jcr.RepositoryException

setAllPermissions

protected void setAllPermissions(javax.jcr.Node node,
                     String... identities)
                          throws AccessControlException,
                                 javax.jcr.RepositoryException

Set all available permissions to given node for given identities.

Parameters:

node -

identities -

Throws:

AccessControlException

javax.jcr.RepositoryException

documentName

protected String documentName(javax.jcr.Node document)
                       throws javax.jcr.RepositoryException

Find pretty name of the document.

Parameters:

document -

Returns:

Throws:

javax.jcr.RepositoryException

systemSession

protected javax.jcr.Session systemSession()
                                   throws javax.jcr.RepositoryException

System session in default workspace of current JCR repository.

Returns:

Throws:

javax.jcr.RepositoryException

getCloudFileLinks

protected javax.jcr.NodeIterator getCloudFileLinks(javax.jcr.Node targetNode,
                                       String shareIdentity,
                                       boolean useSystemSession)
                                            throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException