PolicyComponent (Alfresco 5.1.4.1 Public Java API)

org.alfresco.repo.policy

Interface PolicyComponent

@org.alfresco.api.AlfrescoPublicApi
public interface PolicyComponent

Policy Component for managing Policies and Behaviours.

This component provides the ability to:

a) Register policies
b) Bind behaviours to policies
c) Invoke policy behaviours

A behaviour may be bound to a Policy before the Policy is registered. In this case, the behaviour is not validated (i.e. checked to determine if it supports the policy interface) until the Policy is registered. Otherwise, the behaviour is validated at bind-time. Policies may be selectively "turned off" by the Behaviour Filter.

Method Summary
BehaviourDefinition<ServiceBehaviourBinding>	bindAssociationBehaviour(QName policy, Object service, Behaviour behaviour) Bind a Service specific behaviour to an Association-level Policy
BehaviourDefinition<ClassFeatureBehaviourBinding>	bindAssociationBehaviour(QName policy, QName className, Behaviour behaviour) Bind an Association specific behaviour to an Association-level Policy (for all associations of a Class)
BehaviourDefinition<ClassFeatureBehaviourBinding>	bindAssociationBehaviour(QName policy, QName className, QName assocName, Behaviour behaviour) Bind an Association specific behaviour to an Association-level Policy
BehaviourDefinition<ServiceBehaviourBinding>	bindClassBehaviour(QName policy, Object service, Behaviour behaviour) Bind a Service behaviour to a Class-level Policy
BehaviourDefinition<ClassBehaviourBinding>	bindClassBehaviour(QName policy, QName className, Behaviour behaviour) Bind a Class specific behaviour to a Class-level Policy.
BehaviourDefinition<ServiceBehaviourBinding>	bindPropertyBehaviour(QName policy, Object service, Behaviour behaviour) Bind a Service specific behaviour to a Property-level Policy
BehaviourDefinition<ClassFeatureBehaviourBinding>	bindPropertyBehaviour(QName policy, QName className, Behaviour behaviour) Bind a Property specific behaviour to a Property-level Policy (for all properties of a Class)
BehaviourDefinition<ClassFeatureBehaviourBinding>	bindPropertyBehaviour(QName policy, QName className, QName propertyName, Behaviour behaviour) Bind a Property specific behaviour to a Property-level Policy
Collection<PolicyDefinition>	getRegisteredPolicies() Gets all registered Policies
PolicyDefinition<Policy>	getRegisteredPolicy(PolicyType policyType, QName policy) Gets the specified registered Policy
boolean	isRegisteredPolicy(PolicyType policyType, QName policy) Determine if the specified policy has been registered
<P extends AssociationPolicy> AssociationPolicyDelegate<P>	registerAssociationPolicy(Class<P> policy) Register a Association-level Policy
<P extends ClassPolicy> ClassPolicyDelegate<P>	registerClassPolicy(Class<P> policy) Register a Class-level Policy
<P extends PropertyPolicy> PropertyPolicyDelegate<P>	registerPropertyPolicy(Class<P> policy) Register a Property-level Policy
void	removeClassDefinition(BehaviourDefinition<ClassBehaviourBinding> definition) Unbind behaviour

ClassPolicyDelegate registerClassPolicy(Class policy)

P - the policy interface

policy - the policy interface class

A delegate for the class-level policy (typed by the policy interface)

registerPropertyPolicy

PropertyPolicyDelegate registerPropertyPolicy(Class policy)

P - the policy interface

policy - the policy interface class

A delegate for the property-level policy (typed by the policy interface)

registerAssociationPolicy

AssociationPolicyDelegate registerAssociationPolicy(Class policy)

P - the policy interface

policy - the policy interface class

A delegate for the association-level policy (typed by the policy interface)

getRegisteredPolicies

Collection<PolicyDefinition> getRegisteredPolicies()

Gets all registered Policies

the collection of registered policy definitions

PolicyDefinition<Policy> getRegisteredPolicy(PolicyType policyType,
QName policy)

Gets the specified registered Policy

policyType - the policy type

policy - the policy name

the policy definition (or null, if it has not been registered)

boolean isRegisteredPolicy(PolicyType policyType,
QName policy)

Determine if the specified policy has been registered

policyType - the policy type

policy - the fully qualified name of the policy

true => registered, false => not yet

BehaviourDefinition<ClassBehaviourBinding> bindClassBehaviour(QName policy,
QName className,
Behaviour behaviour)

Bind a Class specific behaviour to a Class-level Policy.

So when the named policy, happens on the specified aspect or type, the specified behaviour is executed.

Example of calling this method

         this.policyComponent.bindClassBehaviour(
           NodeServicePolicies.BeforeUpdateNodePolicy.QNAME,
           ContentModel.ASPECT_LOCKABLE,
           new JavaBehaviour(this, "beforeUpdateNode"));

policy - the fully qualified policy name

className - the qualified name of a type or aspect that the policy is bound to

behaviour - the behaviour. What gets executed by the policy

the registered behaviour definition

BehaviourDefinition<ServiceBehaviourBinding> bindClassBehaviour(QName policy,
Object service,
Behaviour behaviour)

Bind a Service behaviour to a Class-level Policy

policy - the fully qualified policy name

service - the service (any object, in fact)

behaviour - the behaviour. What gets executed by the policy

the registered behaviour definition

bindPropertyBehaviour

BehaviourDefinition<ClassFeatureBehaviourBinding> bindPropertyBehaviour(QName policy,
 QName className,
 QName propertyName,
 Behaviour behaviour)

Bind a Property specific behaviour to a Property-level Policy

policy - the fully qualified policy name

className - the qualified name of the class (type or aspect) to bind against

propertyName - the name of the property to bind against

behaviour - the behaviour. What gets executed by the policy

the registered behaviour definition

bindPropertyBehaviour

BehaviourDefinition<ClassFeatureBehaviourBinding> bindPropertyBehaviour(QName policy,
QName className,
Behaviour behaviour)

Bind a Property specific behaviour to a Property-level Policy (for all properties of a Class)

policy - the fully qualified policy name

className - the name of the class (type or aspect) to bind against

behaviour - the behaviour, what gets executed by the policy

the registered behaviour definition

bindPropertyBehaviour

BehaviourDefinition<ServiceBehaviourBinding> bindPropertyBehaviour(QName policy,
Object service,
Behaviour behaviour)

Bind a Service specific behaviour to a Property-level Policy

policy - the fully qualified policy name

service - the binding service

behaviour - the behaviour

the registered behaviour definition

bindAssociationBehaviour

BehaviourDefinition<ClassFeatureBehaviourBinding> bindAssociationBehaviour(QName policy,
 QName className,
 QName assocName,
 Behaviour behaviour)

Bind an Association specific behaviour to an Association-level Policy

For example, before a rule folder association is created.

         policyComponent.bindAssociationBehaviour(
           NodeServicePolicies.OnCreateChildAssociationPolicy.QNAME,
           RuleModel.ASPECT_RULES,
           RuleModel.ASSOC_RULE_FOLDER,
           new JavaBehaviour(this, "OnCreateChildAssociation"));

policy - the policy name

className - the name of the class (type or aspect) to bind against

assocName - the name of the association to bind against

behaviour - the behaviour. What gets executed by the policy

the registered behaviour definition

bindAssociationBehaviour

BehaviourDefinition<ClassFeatureBehaviourBinding> bindAssociationBehaviour(QName policy,
QName className,
Behaviour behaviour)

Bind an Association specific behaviour to an Association-level Policy (for all associations of a Class)

policy - the policy name

className - the name of the class (type or aspect) to bind against

behaviour - the behaviour. What gets executed by the policy

the registered behaviour definition

bindAssociationBehaviour

BehaviourDefinition<ServiceBehaviourBinding> bindAssociationBehaviour(QName policy,
Object service,
Behaviour behaviour)

Bind a Service specific behaviour to an Association-level Policy

policy - the policy name

service - the binding service

behaviour - the behaviour. What gets executed by the policy

the registered behaviour definition

removeClassDefinition

void removeClassDefinition(BehaviourDefinition<ClassBehaviourBinding> definition)

definition - BehaviourDefinition

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