Package org.alfresco.email.server

Class AliasableAspect

java.lang.Object

org.alfresco.email.server.AliasableAspect

All Implemented Interfaces:

CopyServicePolicies.OnCopyNodePolicy, NodeServicePolicies.BeforeDeleteNodePolicy, NodeServicePolicies.BeforeRemoveAspectPolicy, NodeServicePolicies.OnAddAspectPolicy, NodeServicePolicies.OnUpdatePropertiesPolicy, ClassPolicy, Policy

public class AliasableAspect
extends Object
implements NodeServicePolicies.OnAddAspectPolicy, NodeServicePolicies.BeforeRemoveAspectPolicy, NodeServicePolicies.OnUpdatePropertiesPolicy, NodeServicePolicies.BeforeDeleteNodePolicy, CopyServicePolicies.OnCopyNodePolicy

Class that supports functionality of email aliasable aspect.

Since:

2.2

Author:

mrogers

Nested Class Summary

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

Policy.Arg

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ALIASABLE_ATTRIBUTE_KEY_1	The first "key" into the attribute table - identifies that the attribute is for this class
static final String	ALIASABLE_ATTRIBUTE_KEY_2	The second "key" into the attribute table - identifies that the attribute is an alias

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

ARG_0, ARG_1, QNAME

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

QNAME

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

QNAME

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

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

Constructor Summary

Constructors

Constructor	Description
AliasableAspect()

Method Summary

Modifier and Type	Method	Description
void	addAlias(NodeRef nodeRef, String alias)	Set the email alias for the specified node.
void	beforeDeleteNode(NodeRef nodeRef)	Called before a node is deleted.
void	beforeRemoveAspect(NodeRef nodeRef, QName aspectTypeQName)	Called before an aspect is removed from a node
AttributeService	getAttributeService()
NodeRef	getByAlias(String alias)	Get a node ref by its email alias
CopyBehaviourCallback	getCopyCallback(QName classRef, CopyDetails copyDetails)	Called for all types and aspects before copying a node.
void	init()	Spring initilaise method used to register the policy behaviours
static String	normaliseAlias(String value)	method to normalise an email alias.
void	onAddAspect(NodeRef nodeRef, QName aspectTypeQName)	Called after an aspect has been added to a node
void	onUpdateProperties(NodeRef nodeRef, Map<QName,Serializable> before, Map<QName,Serializable> after)	Called after a node's properties have been changed.
void	removeAlias(String alias)	remove the specified alias
void	setAttributeService(AttributeService attributeService)
void	setNodeService(NodeService nodeService)
void	setPolicyComponent(PolicyComponent policyComponent)

Methods inherited from class java.lang.Object

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

Field Details

ALIASABLE_ATTRIBUTE_KEY_1

public static final String ALIASABLE_ATTRIBUTE_KEY_1

The first "key" into the attribute table - identifies that the attribute is for this class

See Also:

• Constant Field Values

ALIASABLE_ATTRIBUTE_KEY_2

public static final String ALIASABLE_ATTRIBUTE_KEY_2

The second "key" into the attribute table - identifies that the attribute is an alias

See Also:

• Constant Field Values

Constructor Details

AliasableAspect

public AliasableAspect()

Method Details

setNodeService

public void setNodeService(NodeService nodeService)

Parameters:

nodeService - Alfresco Node Service

setPolicyComponent

public void setPolicyComponent(PolicyComponent policyComponent)

Parameters:

policyComponent - Alfresco Policy Component

init

public void init()

Spring initilaise method used to register the policy behaviours

normaliseAlias

public static String normaliseAlias(String value)

method to normalise an email alias. Currently this involves trimmimg and lower casing, but it may change in future

Parameters:

value -

Returns:

the normalised value.

addAlias

public void addAlias(NodeRef nodeRef,
 String alias)

Set the email alias for the specified node. If the rule is broken, AlfrescoRuntimeException will be thrown.

Parameters:

nodeRef - Reference to target node

alias - Alias that we want to set to the target node

Throws:

org.alfresco.error.AlfrescoRuntimeException - if the alias property is duplicated by another node.

removeAlias

public void removeAlias(String alias)

remove the specified alias

Parameters:

alias - to remove

getByAlias

public NodeRef getByAlias(String alias)

Get a node ref by its email alias

Returns:

the node ref, or null if there is no node for that alias

onAddAspect

public void onAddAspect(NodeRef nodeRef,
 QName aspectTypeQName)

Description copied from interface: NodeServicePolicies.OnAddAspectPolicy

Called after an aspect has been added to a node

Specified by:

onAddAspect in interface NodeServicePolicies.OnAddAspectPolicy

Parameters:

nodeRef - the node to which the aspect was added

aspectTypeQName - the type of the aspect

Throws:

org.alfresco.error.AlfrescoRuntimeException - Throws if the alias property is duplicated.

See Also:

• NodeServicePolicies.OnAddAspectPolicy.onAddAspect(org.alfresco.service.cmr.repository.NodeRef, org.alfresco.service.namespace.QName)

onUpdateProperties

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

Description copied from interface: NodeServicePolicies.OnUpdatePropertiesPolicy

Called after a node's properties have been changed.

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

Throws:

org.alfresco.error.AlfrescoRuntimeException - Throws if the alias property is duplicated.

See Also:

• NodeServicePolicies.OnUpdatePropertiesPolicy.onUpdateProperties(org.alfresco.service.cmr.repository.NodeRef, java.util.Map, java.util.Map)

beforeRemoveAspect

public void beforeRemoveAspect(NodeRef nodeRef,
 QName aspectTypeQName)

Description copied from interface: NodeServicePolicies.BeforeRemoveAspectPolicy

Called before an aspect is removed from a node

Specified by:

beforeRemoveAspect in interface NodeServicePolicies.BeforeRemoveAspectPolicy

Parameters:

nodeRef - the node from which the aspect will be removed

aspectTypeQName - the type of the aspect

beforeDeleteNode

public void beforeDeleteNode(NodeRef nodeRef)

Description copied from interface: NodeServicePolicies.BeforeDeleteNodePolicy

Called before a node is deleted.

Specified by:

beforeDeleteNode in interface NodeServicePolicies.BeforeDeleteNodePolicy

Parameters:

nodeRef - the node reference

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:

Return the callback that will be used to modify the copy behaviour for this dictionary class. Return null to assume the default.

See Also:

• CopyServicePolicies

setAttributeService

public void setAttributeService(AttributeService attributeService)

getAttributeService

public AttributeService getAttributeService()