org.ametys.cms.repository

Class ContentDAO

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.ametys.cms.repository.ContentDAO

All Implemented Interfaces:

Component, Contextualizable, LogEnabled, Serviceable

Direct Known Subclasses:

HierarchicalReferenceTablesDeleteContentDAO, WebContentDAO

public class ContentDAO
extends AbstractLogEnabled
implements Serviceable, Component, Contextualizable

DAO for manipulating contents

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ContentDAO.TagMode The mode for tag edition

Field Summary

Fields

Modifier and Type	Field and Description
protected ContentHelper	_contentHelper Content helper
protected ContentTypeExtensionPoint	_contentTypeEP Content-type extension point
protected ContentWorkflowHelper	_contentWorkflowHelper Workflow helper component
protected Context	_context Cocoon context
protected ContentTypesHelper	_cTypesHelper Content types helper
protected CurrentUserProvider	_currentUserProvider Component to get current user
protected HierarchicalReferenceTablesHelper	_hierarchicalSimpleContentsHelper The helper component for hierarchical simple contents
protected LockContentManager	_lockManager Component to manager lock
protected ModifiableContentHelper	_modifiableContentHelper The modifiable content helper
protected ObservationManager	_observationManager Ametys observation manger
protected AmetysObjectResolver	_resolver Ametys resolver
protected RightManager	_rightManager Rights manager
protected TagProviderExtensionPoint	_tagProvider Component to get tags
protected UserHelper	_userHelper Helper for users
protected UserManager	_usersManager The user manager
protected WorkflowProvider	_workflowProvider Workflow component
static String	ROLE Avalon Role

Constructor Summary

Constructors

Constructor and Description
ContentDAO()

Method Summary

Modifier and Type	Method and Description
private boolean	_addOrRemoveReaction(Content content, UserIdentity userIdentity, ReactionableObject.ReactionType reactionType, boolean remove)
protected void	_copyACL(Content srcContent, Content targetContent) Copy the ACL of a content
protected Map<String,Object>	_getEventParametersForDeletion(Content content) Get parameters for content deleted Event
protected boolean	_isContentReferenced(Content content) Test if content is still referenced before removing it
boolean	_isTagValid(String tagName, Map<String,Object> contextualParameters) Is the tag a content tag
protected void	_notifyContentCopied(Content content, boolean waitAsyncObservers) Notify observers that the content has been created
private void	_removeAllTagsInReplaceMode(TaggableAmetysObject mContent, ContentDAO.TagMode tagMode, Set<String> oldTags)
boolean	canDelete(Content content) Dertermines if the current user has right to delete the content
void	contextualize(Context context)
ModifiableContent	copy(DefaultContent originalContent, ModifiableTraversableAmetysObject parent, String name, int initWorkflowActionId) Copy a content.
ModifiableContent	copy(DefaultContent originalContent, ModifiableTraversableAmetysObject parent, String name, String lang, int initWorkflowActionId) Copy a content.
ModifiableContent	copy(DefaultContent originalContent, ModifiableTraversableAmetysObject parent, String name, String lang, int initWorkflowActionId, boolean notifyObservers, boolean waitAsyncObservers, boolean copyACL) Copy a content.
Map<String,Object>	deleteContents(List<String> contentsId) Delete contents
Map<String,Object>	deleteContents(List<String> contentsId, boolean ignoreRights) Delete contents
Map<String,Object>	getAttachmentsRootNode(String id) Returns the content's attachments root node
Map<String,Object>	getContentDescription(Content content) Get the content's properties for description
Map<String,Object>	getContentDescription(String contentId, String workspaceName) Get the content's properties for description
List<Map<String,Object>>	getContentMetadataSets(String contentId, boolean edition, boolean includeInternal) Get the metadata sets of a content
Map<String,Object>	getContentProperties(Content content) Get the content properties
Map<String,Object>	getContentProperties(String contentId, String workspaceName) Get the content properties
Map<String,Object>	getContentsProperties(List<String> contentIds, String workspaceName) Get the contents properties
Set<String>	getTags(List<String> contentIds) Get the tags of contents
protected Set<String>	getUserRights(Content content) Get the user rights on content
boolean	react(Content content, UserIdentity userIdentity, ReactionableObject.ReactionType reactionType) Add a reaction on a Content.
Map<String,Object>	react(String contentId, String reactionName, boolean remove) Add or remove a reaction on a content
void	service(ServiceManager smanager)
Map<String,Object>	tag(List<String> contentIds, List<String> tagNames, Map<String,Object> contextualParameters) Tag a list of contents with the given tags
Map<String,Object>	tag(List<String> contentIds, List<String> tagNames, String mode, Map<String,Object> contextualParameters) Tag a list of contents
boolean	unreact(Content content, UserIdentity userIdentity, ReactionableObject.ReactionType reactionType) Remove reaction if exists on a Content.

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

enableLogging, getLogger, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

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

Field Detail

ROLE

public static final String ROLE

Avalon Role

_resolver

protected AmetysObjectResolver _resolver

Ametys resolver

_observationManager

protected ObservationManager _observationManager

Ametys observation manger

_currentUserProvider

protected CurrentUserProvider _currentUserProvider

Component to get current user

_tagProvider

protected TagProviderExtensionPoint _tagProvider

Component to get tags

_workflowProvider

protected WorkflowProvider _workflowProvider

Workflow component

_contentWorkflowHelper

protected ContentWorkflowHelper _contentWorkflowHelper

Workflow helper component

_lockManager

protected LockContentManager _lockManager

Component to manager lock

_contentTypeEP

protected ContentTypeExtensionPoint _contentTypeEP

Content-type extension point

_contentHelper

protected ContentHelper _contentHelper

Content helper

_cTypesHelper

protected ContentTypesHelper _cTypesHelper

Content types helper

_rightManager

protected RightManager _rightManager

Rights manager

_context

protected Context _context

Cocoon context

_usersManager

protected UserManager _usersManager

The user manager

_userHelper

protected UserHelper _userHelper

Helper for users

_hierarchicalSimpleContentsHelper

protected HierarchicalReferenceTablesHelper _hierarchicalSimpleContentsHelper

The helper component for hierarchical simple contents

_modifiableContentHelper

protected ModifiableContentHelper _modifiableContentHelper

The modifiable content helper

Constructor Detail

ContentDAO

public ContentDAO()

Method Detail

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

service

public void service(ServiceManager smanager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

deleteContents

public Map<String,Object> deleteContents(List<String> contentsId)

Delete contents

Parameters:

contentsId - The ids of contents to delete

Returns:

the deleted and undeleted contents

deleteContents

public Map<String,Object> deleteContents(List<String> contentsId,
                                         boolean ignoreRights)

Delete contents

Parameters:

contentsId - The ids of contents to delete

ignoreRights - true to ignore user rights

Returns:

the deleted and undeleted contents

_isContentReferenced

protected boolean _isContentReferenced(Content content)

Test if content is still referenced before removing it

Parameters:

content - The content to remove

Returns:

true if content is still referenced

_getEventParametersForDeletion

protected Map<String,Object> _getEventParametersForDeletion(Content content)

Get parameters for content deleted Event

Parameters:

content - the removed content

Returns:

the event's parameters

getContentsProperties

public Map<String,Object> getContentsProperties(List<String> contentIds,
                                                String workspaceName)

Get the contents properties

Parameters:

contentIds - The ids of contents

workspaceName - The workspace name. Can be null to get contents in current workspace.

Returns:

The contents' properties

getContentProperties

public Map<String,Object> getContentProperties(String contentId,
                                               String workspaceName)

Get the content properties

Parameters:

contentId - The id of content

workspaceName - The workspace name. Can be null to get content in current workspace.

Returns:

The content's properties

getContentProperties

public Map<String,Object> getContentProperties(Content content)

Get the content properties

Parameters:

content - The content

Returns:

The content properties

getContentDescription

public Map<String,Object> getContentDescription(String contentId,
                                                String workspaceName)

Get the content's properties for description

Parameters:

contentId - The id of content

workspaceName - The workspace name. Can be null to get content in current workspace.

Returns:

The content's properties for description

getContentDescription

public Map<String,Object> getContentDescription(Content content)

Get the content's properties for description

Parameters:

content - The content

Returns:

The content's properties for description

getContentMetadataSets

public List<Map<String,Object>> getContentMetadataSets(String contentId,
                                                       boolean edition,
                                                       boolean includeInternal)

Get the metadata sets of a content

Parameters:

contentId - the content's id

edition - Set to true to get edition metadata set. False otherwise.

includeInternal - Set to true to include internal metadata sets.

Returns:

the metadata sets

getUserRights

protected Set<String> getUserRights(Content content)

Get the user rights on content

Parameters:

content - The content

Returns:

The user's rights

getTags

public Set<String> getTags(List<String> contentIds)

Get the tags of contents

Parameters:

contentIds - The content's ids

Returns:

the tags

tag

public Map<String,Object> tag(List<String> contentIds,
                              List<String> tagNames,
                              Map<String,Object> contextualParameters)

Tag a list of contents with the given tags

Parameters:

contentIds - The ids of contents to tag

tagNames - The tags

contextualParameters - The contextual parameters

Returns:

the result

tag

public Map<String,Object> tag(List<String> contentIds,
                              List<String> tagNames,
                              String mode,
                              Map<String,Object> contextualParameters)

Tag a list of contents

Parameters:

contentIds - The ids of contents to tag

tagNames - The tags

mode - The mode for updating tags: 'REPLACE' to replace tags, 'INSERT' to add tags or 'REMOVE' to remove tags.

contextualParameters - The contextual parameters

Returns:

the result

_removeAllTagsInReplaceMode

private void _removeAllTagsInReplaceMode(TaggableAmetysObject mContent,
                                         ContentDAO.TagMode tagMode,
                                         Set<String> oldTags)

_isTagValid

public boolean _isTagValid(String tagName,
                           Map<String,Object> contextualParameters)

Is the tag a content tag

Parameters:

tagName - The tag name

contextualParameters - The contextual parameters

Returns:

true if the tag is a valid content tag

copy

public ModifiableContent copy(DefaultContent originalContent,
                              ModifiableTraversableAmetysObject parent,
                              String name,
                              int initWorkflowActionId)
                       throws AmetysRepositoryException

Copy a content.

Parameters:

originalContent - the original content.

parent - the object in which to create a content.

name - the content name.

initWorkflowActionId - The initial workflow action id

Returns:

the copied content.

Throws:

AmetysRepositoryException - If an error occured

copy

public ModifiableContent copy(DefaultContent originalContent,
                              ModifiableTraversableAmetysObject parent,
                              String name,
                              String lang,
                              int initWorkflowActionId)
                       throws AmetysRepositoryException

Copy a content.

Parameters:

originalContent - the original content.

parent - the object in which to create a content.

name - the content name.

lang - the content language. If null, the content language will be the same of the original content

initWorkflowActionId - The initial workflow action id

Returns:

the copied content.

Throws:

AmetysRepositoryException - If an error occured

copy

public ModifiableContent copy(DefaultContent originalContent,
                              ModifiableTraversableAmetysObject parent,
                              String name,
                              String lang,
                              int initWorkflowActionId,
                              boolean notifyObservers,
                              boolean waitAsyncObservers,
                              boolean copyACL)
                       throws AmetysRepositoryException

Copy a content.

Parameters:

originalContent - the original content.

parent - the object in which to create a content.

name - the content name.

lang - the content language. If null, the content language will be the same of the original content

initWorkflowActionId - The initial workflow action id

notifyObservers - Set to false to do not fire observer events

waitAsyncObservers - true to wait for asynchronous observers to complete

copyACL - true to copy ACL of source content

Returns:

the copied content.

Throws:

AmetysRepositoryException - If an error occured

_copyACL

protected void _copyACL(Content srcContent,
                        Content targetContent)

Copy the ACL of a content

Parameters:

srcContent - The source content

targetContent - The target content

_notifyContentCopied

protected void _notifyContentCopied(Content content,
                                    boolean waitAsyncObservers)
                             throws com.opensymphony.workflow.WorkflowException

Notify observers that the content has been created

Parameters:

content - The content added

waitAsyncObservers - true to wait for asynchonous observers to finish

Throws:

com.opensymphony.workflow.WorkflowException - If an error occurred

getAttachmentsRootNode

public Map<String,Object> getAttachmentsRootNode(String id)

Returns the content's attachments root node

Parameters:

id - the content's id

Returns:

The attachments' root node informations

canDelete

public boolean canDelete(Content content)

Dertermines if the current user has right to delete the content

Parameters:

content - The content

Returns:

true if current user is authorized to delete the content

react

public Map<String,Object> react(String contentId,
                                String reactionName,
                                boolean remove)

Add or remove a reaction on a content

Parameters:

contentId - The content id

reactionName - the reaction name (ex: LIKE)

remove - true to remove the reaction, false to add reaction

Returns:

the result with the current actors of this reaction

react

public boolean react(Content content,
                     UserIdentity userIdentity,
                     ReactionableObject.ReactionType reactionType)

Add a reaction on a Content.

Parameters:

content - the content

userIdentity - the issuer of reaction

reactionType - the reaction type

Returns:

true if a change was made

unreact

public boolean unreact(Content content,
                       UserIdentity userIdentity,
                       ReactionableObject.ReactionType reactionType)

Remove reaction if exists on a Content.

Parameters:

content - the content

userIdentity - the issuer of reaction

reactionType - the reaction type

Returns:

true if a change was made

_addOrRemoveReaction

private boolean _addOrRemoveReaction(Content content,
                                     UserIdentity userIdentity,
                                     ReactionableObject.ReactionType reactionType,
                                     boolean remove)