org.alfresco.service.cmr.quickshare

Interface QuickShareService

All Known Implementing Classes:

QuickShareServiceImpl

public interface QuickShareService

The QuickShare service. Responsible for creating, updating and retrieving Quick share metadata,

Since:

Cloud/4.2

Author:

Alex Miller, janv

Method Summary

Modifier and Type	Method and Description
boolean	canDeleteSharedLink(NodeRef nodeRef, String sharedByUserId) Determine if the current user has permission to delete the shared link.
boolean	canRead(String sharedId) Determine if the current user has permission to read the shared content.
void	deleteQuickShareLinkExpiryAction(QuickShareLinkExpiryAction quickShareLinkExpiryAction) Removes (hard deletes) the previously persisted QuickShareLinkExpiryAction and its related schedule ScheduledPersistedAction from the repository.
Map<String,Object>	getMetaData(NodeRef nodeRef) Get QuickShare related metadata for the given node.
Map<String,Object>	getMetaData(String shareId) Get QuickShare related metadata for the given shareId.
Pair<String,NodeRef>	getTenantNodeRefFromSharedId(String sharedId) Get the tenant domain and node reference for the the given share id.
boolean	isQuickShareEnabled() Whether the quick share is enabled or not.
void	sendEmailNotification(QuickShareServiceImpl.QuickShareEmailRequest emailRequest) Notifies users by email that a content has been shared with them, and the details of it.
QuickShareDTO	shareContent(NodeRef nodeRef) Share content identified by nodeRef.
QuickShareDTO	shareContent(NodeRef nodeRef, Date expiryDate) Share content identified by nodeRef and optionally set an expiry date for the shared link.
void	unshareContent(String sharedId) Unshare the content identified by sharedId

Method Detail

shareContent

QuickShareDTO shareContent(NodeRef nodeRef)
                    throws QuickShareDisabledException,
                           InvalidNodeRefException

Share content identified by nodeRef.

Parameters:

nodeRef - The NodeRef of the content to share

Returns:

QuickDTO with details of the share

Throws:

QuickShareDisabledException

InvalidNodeRefException

shareContent

QuickShareDTO shareContent(NodeRef nodeRef,
                           Date expiryDate)
                    throws QuickShareDisabledException,
                           InvalidNodeRefException

Share content identified by nodeRef and optionally set an expiry date for the shared link.

Parameters:

nodeRef - The NodeRef of the content to share

expiryDate - The expiry date of the shared link

Returns:

QuickDTO with details of the share

Throws:

QuickShareDisabledException

InvalidNodeRefException

getMetaData

Map<String,Object> getMetaData(NodeRef nodeRef)
                        throws QuickShareDisabledException,
                               InvalidNodeRefException

Get QuickShare related metadata for the given node.

Parameters:

nodeRef - NodeRef

Returns:

Map

Throws:

QuickShareDisabledException

InvalidNodeRefException

getMetaData

Map<String,Object> getMetaData(String shareId)
                        throws QuickShareDisabledException,
                               InvalidSharedIdException

Get QuickShare related metadata for the given shareId.

Parameters:

shareId - String

Returns:

Map

Throws:

QuickShareDisabledException

InvalidSharedIdException

getTenantNodeRefFromSharedId

Pair<String,NodeRef> getTenantNodeRefFromSharedId(String sharedId)
                                           throws QuickShareDisabledException,
                                                  InvalidSharedIdException

Get the tenant domain and node reference for the the given share id.

Parameters:

sharedId - String

Returns:

Pair

Throws:

QuickShareDisabledException

InvalidSharedIdException

unshareContent

void unshareContent(String sharedId)
             throws QuickShareDisabledException,
                    InvalidSharedIdException

Unshare the content identified by sharedId

Parameters:

sharedId - The shared id of the content to unshare.

Throws:

QuickShareDisabledException

InvalidSharedIdException

canRead

boolean canRead(String sharedId)

Determine if the current user has permission to read the shared content.

sendEmailNotification

void sendEmailNotification(QuickShareServiceImpl.QuickShareEmailRequest emailRequest)

Notifies users by email that a content has been shared with them, and the details of it.

Parameters:

emailRequest - The email details including its template details

canDeleteSharedLink

boolean canDeleteSharedLink(NodeRef nodeRef,
                            String sharedByUserId)

Determine if the current user has permission to delete the shared link.

isQuickShareEnabled

boolean isQuickShareEnabled()

Whether the quick share is enabled or not.

Returns:

true if quick share is enabled, false otherwise.

Since:

5.2

deleteQuickShareLinkExpiryAction

void deleteQuickShareLinkExpiryAction(QuickShareLinkExpiryAction quickShareLinkExpiryAction)

Removes (hard deletes) the previously persisted QuickShareLinkExpiryAction and its related schedule ScheduledPersistedAction from the repository.

Parameters:

quickShareLinkExpiryAction - The QuickShareLinkExpiryAction to be deleted.