BehaviourFilter (Alfresco 5.2.4 Public Java API)

org.alfresco.repo.policy

Interface BehaviourFilter

@org.alfresco.api.AlfrescoPublicApi
public interface BehaviourFilter

Contract disabling and enabling policy behaviours.

Since 4.0, the behaviour enabling/disabling is recorded using reference counting, meaning that the outermost disable call in a stack has an effective veto. Use proper try-finally patterns to ensure behaviour is released after it is no longer needed.


 behaviourFilter.disableBehaviour(abc);
 try
 {
    behaviourFilter.disableBehaviour(abc);
    try
    {
       // Do something that might have triggered 'abc' but will not
    }
    finally
    {
        behaviourFilter.enableBehaviour(abc);
    }
    // Do something that might have triggered 'abc' but will not despite the last enable call
 }
 finally
 {
     behaviourFilter.enableBehaviour(abc);
 }

Method Summary
void	disableAllBehaviours() Deprecated. Since 4.0 use enableBehaviour(NodeRef)
void	disableBehaviour() Disable behaviour for all types
void	disableBehaviour(NodeRef nodeRef) Disable all behaviours for a given node
void	disableBehaviour(NodeRef nodeRef, QName className) Disable behaviour for specific node and class
void	disableBehaviour(QName className) Disable behaviour for a type or aspect for all nodes.
void	disableBehaviour(QName className, boolean includeSubClasses) Disable behaviour for a type or aspect for all nodes.
void	enableAllBehaviours() Deprecated. Since 4.0 use disableBehaviour()
void	enableBehaviour() Enable behaviours for all classes.
void	enableBehaviour(NodeRef nodeRef) Enable behaviour for a specific node
void	enableBehaviour(NodeRef nodeRef, QName className) Enable behaviour for specific node
void	enableBehaviour(QName className) Enable behaviour for all nodes This is also applied to the to the disabled behaviours with disableBehaviour(QName, boolean)
void	enableBehaviours(NodeRef nodeRef) Deprecated. Since 4.0 use enableBehaviour(NodeRef)
boolean	isActivated() Determine if any behaviours have been disabled or altered.
boolean	isEnabled() Determine if behaviour is globally enabled.
boolean	isEnabled(NodeRef nodeRef) Determine if behaviour is enabled for a specific node.
boolean	isEnabled(NodeRef nodeRef, QName className) Determine if behaviour is enabled for specific node and class.
boolean	isEnabled(QName className) Determine if behaviour is enabled for a class.

void enableBehaviours(NodeRef nodeRef)

Deprecated. Since 4.0 use enableBehaviour(NodeRef)

disableAllBehaviours

void disableAllBehaviours()

Deprecated. Since 4.0 use enableBehaviour(NodeRef)

void enableAllBehaviours()

Deprecated. Since 4.0 use disableBehaviour()

void disableBehaviour()

Disable behaviour for all types

The change applies ONLY to the current transaction.

void disableBehaviour(QName className)

Disable behaviour for a type or aspect for all nodes.
Given a direct instance of className (ie. not a subclass) all behaviour is disabled (including superclass behaviour).

The same as calling disableBehaviour(QName, boolean) with false

The change applies ONLY to the current transaction.

className - the type/aspect behaviour to disable

void disableBehaviour(QName className,
boolean includeSubClasses)

Disable behaviour for a type or aspect for all nodes.
Given an instance of className (including instances that are subclasses of className, if includeSubClasses is true) all behaviour is disabled (including superclass behaviour).

Successive calls (within the current transaction) will overwrite the filter for this class.
The change applies ONLY to the current transaction.

className - the type/aspect behaviour to disable

includeSubClasses - set to true to disable the behaviours of subclasses

void disableBehaviour(NodeRef nodeRef,
QName className)

Disable behaviour for specific node and class

The change applies ONLY to the current transaction.

nodeRef - the node to disable for

className - the type/aspect behaviour to disable

void disableBehaviour(NodeRef nodeRef)

Disable all behaviours for a given node

nodeRef - the node to disable for

void enableBehaviour()

Enable behaviours for all classes.

The change applies ONLY to the current transaction.

void enableBehaviour(QName className)

Enable behaviour for all nodes
This is also applied to the to the disabled behaviours with disableBehaviour(QName, boolean)

The change applies ONLY to the current transaction.

className - the type/aspect behaviour to enable

void enableBehaviour(NodeRef nodeRef,
QName className)

Enable behaviour for specific node

The change applies ONLY to the current transaction.

nodeRef - the node to enable for

className - the type/aspect behaviour to enable or null for all classes

void enableBehaviour(NodeRef nodeRef)

Enable behaviour for a specific node

The change applies ONLY to the current transaction.

nodeRef - the node to enable for

Determine if behaviour is globally enabled.

The change applies ONLY to the current transaction.

true => behaviour is enabled

boolean isEnabled(QName className)

Determine if behaviour is enabled for a class.

The change applies ONLY to the current transaction.

className - the behaviour to test for

true => behaviour is enabled

boolean isEnabled(NodeRef nodeRef,
QName className)

Determine if behaviour is enabled for specific node and class.

Note: A node behaviour is enabled only when: a) the behaviour is not disabled across all nodes b) the behaviour is not disabled specifically for the provided node

The change applies ONLY to the current transaction.

nodeRef - the node to test for

className - the behaviour to test for

true => behaviour is enabled

boolean isEnabled(NodeRef nodeRef)

Determine if behaviour is enabled for a specific node.

The change applies ONLY to the current transaction.

nodeRef - the node to test for

true => behaviour is enabled

boolean isActivated()

Determine if any behaviours have been disabled or altered.

The change applies ONLY to the current transaction.

true => behaviours have been altered

Java API documentation generated with DocFlex/Javadoc 1.6.1 using JavadocPro template set.