Package org.alfresco.repo.version

Class VersionableAspect

java.lang.Object

org.alfresco.repo.version.VersionableAspect

All Implemented Interfaces:

ContentServicePolicies.OnContentUpdatePolicy, CopyServicePolicies.OnCopyNodePolicy, DictionaryListener, NodeServicePolicies.BeforeAddAspectPolicy, NodeServicePolicies.OnAddAspectPolicy, NodeServicePolicies.OnDeleteNodePolicy, NodeServicePolicies.OnRemoveAspectPolicy, NodeServicePolicies.OnUpdatePropertiesPolicy, ClassPolicy, Policy, VersionServicePolicies.AfterCreateVersionPolicy

public class VersionableAspect
extends Object
implements ContentServicePolicies.OnContentUpdatePolicy, NodeServicePolicies.BeforeAddAspectPolicy, NodeServicePolicies.OnAddAspectPolicy, NodeServicePolicies.OnRemoveAspectPolicy, NodeServicePolicies.OnDeleteNodePolicy, NodeServicePolicies.OnUpdatePropertiesPolicy, VersionServicePolicies.AfterCreateVersionPolicy, CopyServicePolicies.OnCopyNodePolicy, DictionaryListener

Class containing behaviour for the versionable aspect

Author:

Roy Wetherall, janv

Nested Class Summary

Nested classes/interfaces inherited from interface org.alfresco.repo.policy.Policy

Policy.Arg

Field Summary

Fields

Modifier and Type	Field	Description
protected static org.apache.commons.logging.Log	logger

Fields inherited from interface org.alfresco.repo.content.ContentServicePolicies.OnContentUpdatePolicy

QNAME

Fields inherited from interface org.alfresco.repo.copy.CopyServicePolicies.OnCopyNodePolicy

ARG_0, ARG_1, QNAME

Fields inherited from interface org.alfresco.repo.node.NodeServicePolicies.BeforeAddAspectPolicy

QNAME

Fields inherited from interface org.alfresco.repo.node.NodeServicePolicies.OnAddAspectPolicy

QNAME

Fields inherited from interface org.alfresco.repo.node.NodeServicePolicies.OnDeleteNodePolicy

QNAME

Fields inherited from interface org.alfresco.repo.node.NodeServicePolicies.OnRemoveAspectPolicy

QNAME

Fields inherited from interface org.alfresco.repo.node.NodeServicePolicies.OnUpdatePropertiesPolicy

ARG_0, ARG_1, ARG_2, QNAME

Fields inherited from interface org.alfresco.repo.policy.Policy

NAMESPACE

Fields inherited from interface org.alfresco.repo.version.VersionServicePolicies.AfterCreateVersionPolicy

QNAME

Constructor Summary

Constructors

Constructor	Description
VersionableAspect()

Method Summary

Modifier and Type	Method	Description
void	afterCreateVersion(NodeRef versionableNode, Version version)	Called after the version has been created
void	afterDictionaryDestroy()
void	afterDictionaryInit()
void	beforeAddAspect(NodeRef nodeRef, QName aspectTypeQName)	Before add aspect policy behaviour
CopyBehaviourCallback	getCopyCallback(QName classRef, CopyDetails copyDetails)	Called for all types and aspects before copying a node.
List<String>	getExcludedOnUpdateProps()
void	init()	Initialise the versionable aspect policies
void	onAddAspect(NodeRef nodeRef, QName aspectTypeQName)	On add aspect policy behaviour
void	onContentUpdate(NodeRef nodeRef, boolean newContent)	On content update policy behaviour If applicable and "cm:autoVersion" is TRUE then version the node on content update (even if no property updates)
void	onDeleteNode(ChildAssociationRef childAssocRef, boolean isNodeArchived)	Called after a node is deleted.
void	onDictionaryInit()
void	onRemoveAspect(NodeRef nodeRef, QName aspectTypeQName)	Called after an aspect has been removed from a node
void	onUpdateProperties(NodeRef nodeRef, Map<QName,Serializable> before, Map<QName,Serializable> after)	On update properties policy behaviour If applicable and "cm:autoVersionOnUpdateProps" is TRUE then version the node on properties update (even if no content updates)
void	setDictionaryDAO(DictionaryDAO dictionaryDAO)	Sets the dictionary DAO.
void	setExcludedOnUpdateProps(List<String> excludedOnUpdateProps)
void	setLockService(LockService lockService)	Set the lock service
void	setNamespacePrefixResolver(NamespacePrefixResolver namespacePrefixResolver)	Sets the namespace prefix resolver.
void	setNodeService(NodeService nodeService)	Set the node service
void	setPolicyComponent(PolicyComponent policyComponent)	Set the policy component
void	setVersionService(VersionService versionService)	Set the version service

Methods inherited from class java.lang.Object

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

Field Details

logger

protected static org.apache.commons.logging.Log logger

Constructor Details

VersionableAspect

public VersionableAspect()

Method Details

setPolicyComponent

public void setPolicyComponent(PolicyComponent policyComponent)

Set the policy component

Parameters:

policyComponent - the policy component

setVersionService

public void setVersionService(VersionService versionService)

Set the version service

Parameters:

versionService - the version service

setNodeService

public void setNodeService(NodeService nodeService)

Set the node service

Parameters:

nodeService - the node service

setLockService

public void setLockService(LockService lockService)

Set the lock service

Parameters:

lockService - the lock service

setDictionaryDAO

public void setDictionaryDAO(DictionaryDAO dictionaryDAO)

Sets the dictionary DAO.

Parameters:

dictionaryDAO - the dictionary DAO

setNamespacePrefixResolver

public void setNamespacePrefixResolver(NamespacePrefixResolver namespacePrefixResolver)

Sets the namespace prefix resolver.

Parameters:

namespacePrefixResolver - the namespace prefix resolver

getExcludedOnUpdateProps

public List<String> getExcludedOnUpdateProps()

Returns:

Returns the current list of properties that do not trigger versioning

setExcludedOnUpdateProps

public void setExcludedOnUpdateProps(List<String> excludedOnUpdateProps)

Parameters:

excludedOnUpdateProps - the list of properties that force versioning to ignore changes

init

public void init()

Initialise the versionable aspect policies

onDeleteNode

public void onDeleteNode(ChildAssociationRef childAssocRef,
 boolean isNodeArchived)

Description copied from interface: NodeServicePolicies.OnDeleteNodePolicy

Called after a node is deleted. The reference given is for an association which has been deleted and cannot be used to retrieve node or associaton information from any of the services.

Specified by:

onDeleteNode in interface NodeServicePolicies.OnDeleteNodePolicy

Parameters:

childAssocRef - the primary parent-child association of the deleted node

isNodeArchived - indicates whether the node has been archived rather than purged

See Also:

• NodeServicePolicies.OnDeleteNodePolicy.onDeleteNode(org.alfresco.service.cmr.repository.ChildAssociationRef, boolean)

getCopyCallback

public CopyBehaviourCallback getCopyCallback(QName classRef,
 CopyDetails copyDetails)

Description copied from interface: CopyServicePolicies.OnCopyNodePolicy

Called for all types and aspects before copying a node.

Specified by:

getCopyCallback in interface CopyServicePolicies.OnCopyNodePolicy

Parameters:

classRef - the type or aspect qualified name

copyDetails - the details of the impending copy

Returns:

Returns the CopyBehaviourCallback

See Also:

• CopyServicePolicies

beforeAddAspect

public void beforeAddAspect(NodeRef nodeRef,
 QName aspectTypeQName)

Before add aspect policy behaviour

Specified by:

beforeAddAspect in interface NodeServicePolicies.BeforeAddAspectPolicy

Parameters:

nodeRef - NodeRef

aspectTypeQName - QName

onAddAspect

public void onAddAspect(NodeRef nodeRef,
 QName aspectTypeQName)

On add aspect policy behaviour

Specified by:

onAddAspect in interface NodeServicePolicies.OnAddAspectPolicy

Parameters:

nodeRef - NodeRef

aspectTypeQName - QName

onRemoveAspect

public void onRemoveAspect(NodeRef nodeRef,
 QName aspectTypeQName)

Description copied from interface: NodeServicePolicies.OnRemoveAspectPolicy

Called after an aspect has been removed from a node

Specified by:

onRemoveAspect in interface NodeServicePolicies.OnRemoveAspectPolicy

Parameters:

nodeRef - the node from which the aspect will be removed

aspectTypeQName - the type of the aspect

See Also:

• NodeServicePolicies.OnRemoveAspectPolicy.onRemoveAspect(org.alfresco.service.cmr.repository.NodeRef, org.alfresco.service.namespace.QName)

onContentUpdate

public void onContentUpdate(NodeRef nodeRef,
 boolean newContent)

On content update policy behaviour If applicable and "cm:autoVersion" is TRUE then version the node on content update (even if no property updates)

Specified by:

onContentUpdate in interface ContentServicePolicies.OnContentUpdatePolicy

Parameters:

nodeRef - the node reference

onUpdateProperties

public void onUpdateProperties(NodeRef nodeRef,
 Map<QName,Serializable> before,
 Map<QName,Serializable> after)

On update properties policy behaviour If applicable and "cm:autoVersionOnUpdateProps" is TRUE then version the node on properties update (even if no content updates)

Specified by:

onUpdateProperties in interface NodeServicePolicies.OnUpdatePropertiesPolicy

Parameters:

nodeRef - reference to the updated node

before - the node's properties before the change

after - the node's properties after the change

Since:

3.2

afterCreateVersion

public void afterCreateVersion(NodeRef versionableNode,
 Version version)

Description copied from interface: VersionServicePolicies.AfterCreateVersionPolicy

Called after the version has been created

Specified by:

afterCreateVersion in interface VersionServicePolicies.AfterCreateVersionPolicy

Parameters:

versionableNode - the node that has been versioned

version - the created version

See Also:

• VersionServicePolicies.OnCreateVersionPolicy.onCreateVersion(org.alfresco.service.namespace.QName, org.alfresco.service.cmr.repository.NodeRef, java.util.Map, org.alfresco.repo.policy.PolicyScope)

onDictionaryInit

public void onDictionaryInit()

Specified by:

onDictionaryInit in interface DictionaryListener

afterDictionaryInit

public void afterDictionaryInit()

Specified by:

afterDictionaryInit in interface DictionaryListener

afterDictionaryDestroy

public void afterDictionaryDestroy()

Specified by:

afterDictionaryDestroy in interface DictionaryListener