org.alfresco.service.cmr.rule
Interface RuleService

All Known Implementing Classes:

RuleServiceImpl

@PublicService
public interface RuleService

Rule service interface.

Method Summary

int	countRules(NodeRef nodeRef) Count the number of rules associated with an actionable node.
void	disableRule(Rule rule) Disables a rule, preventing it from being fired.
void	disableRules() Diable rules for the current thread
void	disableRules(NodeRef nodeRef) Disables the rules for a given node reference.
void	enableRule(Rule rule) Enables a rule previously disabled.
void	enableRules() Enable rules for the current thread
void	enableRules(NodeRef nodeRef) Enables the rules for a given node reference.
java.util.List	getLinkedFromRuleNodes(NodeRef nodeRef) Get a list of the all the rule nodes that link to the passed rule node.
NodeRef	getLinkedToRuleNode(NodeRef nodeRef) Get the node reference to the rule node which the rule node links to.
NodeRef	getOwningNodeRef(Action action) Returns the owning node reference for an action.
NodeRef	getOwningNodeRef(Rule rule) Returns the owning node reference for a rule.
Rule	getRule(NodeRef nodeRef) Get the rule given its node reference
java.util.List	getRules(NodeRef nodeRef) Get all the rules associated with an actionable node, including those inherited from parents.
java.util.List	getRules(NodeRef nodeRef, boolean includeInhertied) Get the rules associated with an actionable node.
java.util.List	getRules(NodeRef nodeRef, boolean includeInhertiedRuleType, java.lang.String ruleTypeName) Get the rules associated with an actionable node that are of a specific rule type.
RuleType	getRuleType(java.lang.String name) Gets a rule type by name.
java.util.List	getRuleTypes() Get the rule types currently defined in the repository.
boolean	hasRules(NodeRef nodeRef) Indicates whether the node in question has any rules associated with it.
boolean	isEnabled() Indicates whether rules are currently enabled or not
boolean	isLinkedToRuleNode(NodeRef nodeRef) Indicates whether the passed rule node reference is linked to another rule node.
void	removeAllRules(NodeRef nodeRef) Removes all the rules associated with an actionable node
void	removeRule(NodeRef nodeRef, Rule rule) Removes a rule from the given rule actionable node
boolean	rulesEnabled(NodeRef nodeRef) Indicates wether the rules for a given node are enabled or not.
void	saveRule(NodeRef nodeRef, Rule rule) Saves the details of the rule to the specified node reference.
void	saveRule(NodeRef nodeRef, Rule rule, int index)
void	setRulePosition(NodeRef nodeRef, NodeRef ruleNodeRef, int index)
void	setRulePosition(NodeRef nodeRef, Rule rule, int index)

Method Detail

getRuleTypes

@Auditable
java.util.List getRuleTypes()

Get the rule types currently defined in the repository.

Returns:

a list of rule types

getRuleType

@Auditable(parameters="name")
RuleType getRuleType(java.lang.String name)

Gets a rule type by name.

Parameters:

name - the name of the rule type

Returns:

the rule type, null if not found

enableRules

@Auditable
void enableRules()

Enable rules for the current thread

disableRules

@Auditable
void disableRules()

Diable rules for the current thread

isEnabled

@Auditable
boolean isEnabled()

Indicates whether rules are currently enabled or not

Returns:

true if rules are enabled, false otherwise

rulesEnabled

@Auditable(key=ARG_0,
           parameters="nodeRef")
boolean rulesEnabled(NodeRef nodeRef)

Indicates wether the rules for a given node are enabled or not. If the rules are not enabled then they will not be executed.

Parameters:

nodeRef - the node reference

Returns:

true if the rules are enabled, false otherwise

disableRules

@Auditable(key=ARG_0,
           parameters="nodeRef")
void disableRules(NodeRef nodeRef)

Disables the rules for a given node reference. When the rules are disabled they will not execute.

Parameters:

nodeRef - the node reference

enableRules

@Auditable(key=ARG_0,
           parameters="nodeRef")
void enableRules(NodeRef nodeRef)

Enables the rules for a given node reference. When the rules are enabled they will execute as usual. By default all rules are enabled.

Parameters:

nodeRef - the node reference

disableRule

@Auditable(parameters="rule")
void disableRule(Rule rule)

Disables a rule, preventing it from being fired.

Parameters:

rule - the rule to disable

enableRule

@Auditable(parameters="rule")
void enableRule(Rule rule)

Enables a rule previously disabled.

Parameters:

rule - the rule to enable

hasRules

@Auditable(key=ARG_0,
           parameters="nodeRef")
boolean hasRules(NodeRef nodeRef)

Indicates whether the node in question has any rules associated with it.

Parameters:

nodeRef - the node reference

Returns:

true if the node has rules associated, false otherwise

getRules

@Auditable(key=ARG_0,
           parameters="nodeRef")
java.util.List getRules(NodeRef nodeRef)

Get all the rules associated with an actionable node, including those inherited from parents.

An exception is raised if the actionable aspect is not present on the passed node.

Parameters:

nodeRef - the node reference

Returns:

a list of the rules associated with the node

getRules

@Auditable(key=ARG_0,
           parameters={"nodeRef", "includeInhertied"})
java.util.List getRules(NodeRef nodeRef,
                                                    boolean includeInhertied)

Get the rules associated with an actionable node.

Optionally this list includes rules inherited from its parents.

An exception is raised if the actionable aspect is not present on the passed node.

Parameters:

nodeRef - the node reference

includeInhertied - indicates whether the inherited rules should be included in the result list or not

Returns:

a list of the rules associated with the node

getRules

@Auditable(key=ARG_0,
           parameters={"nodeRef", "includeInhertiedRuleType", "ruleTypeName"})
java.util.List getRules(NodeRef nodeRef,
                                                    boolean includeInhertiedRuleType,
                                                    java.lang.String ruleTypeName)

Get the rules associated with an actionable node that are of a specific rule type.

Parameters:

nodeRef - the node reference

includeInhertiedRuleType - indicates whether the inherited rules should be included in the result list or not

ruleTypeName - the name of the rule type, if null is passed all rule types are returned

Returns:

a list of the rules associated with the node

countRules

@Auditable(key=ARG_0,
           parameters="nodeRef")
int countRules(NodeRef nodeRef)

Count the number of rules associated with an actionable node.

Parameters:

nodeRef - the node reference

Returns:

a list of the rules associated with the node

getRule

@Auditable(key=ARG_0,
           parameters="nodeRef")
Rule getRule(NodeRef nodeRef)

Get the rule given its node reference

Parameters:

nodeRef - the node reference

Returns:

the rule corresponding to the node reference

saveRule

@Auditable(key=ARG_0,
           parameters={"nodeRef", "rule"})
void saveRule(NodeRef nodeRef,
                                          Rule rule)

Saves the details of the rule to the specified node reference.

If the rule is already associated with the node, the details are updated with those specified.

Parameters:

nodeRef -

rule -

saveRule

@Auditable(key=ARG_0,
           parameters={"nodeRef", "rule", "index"})
void saveRule(NodeRef nodeRef,
                                          Rule rule,
                                          int index)

Parameters:

nodeRef -

rule -

index -

setRulePosition

@Auditable(key=ARG_0,
           parameters={"nodeRef", "ruleNodeRef", "index"})
void setRulePosition(NodeRef nodeRef,
                                                 NodeRef ruleNodeRef,
                                                 int index)

Parameters:

nodeRef -

ruleNodeRef -

index -

setRulePosition

@Auditable(key=ARG_0,
           parameters={"nodeRef", "rule", "index"})
void setRulePosition(NodeRef nodeRef,
                                                 Rule rule,
                                                 int index)

Parameters:

nodeRef -

rule -

index -

removeRule

@Auditable(key=ARG_0,
           parameters={"nodeRef", "rule"})
void removeRule(NodeRef nodeRef,
                                            Rule rule)

Removes a rule from the given rule actionable node

Parameters:

nodeRef - the actionable node reference

removeAllRules

@Auditable(key=ARG_0,
           parameters="nodeRef")
void removeAllRules(NodeRef nodeRef)

Removes all the rules associated with an actionable node

Parameters:

nodeRef - the actionable node reference

getOwningNodeRef

@Auditable(key=RETURN,
           parameters="rule")
NodeRef getOwningNodeRef(Rule rule)

Returns the owning node reference for a rule.

Parameters:

rule - the rule

Returns:

the owning node reference

getOwningNodeRef

@Auditable(key=RETURN,
           parameters="action")
NodeRef getOwningNodeRef(Action action)

Returns the owning node reference for an action. Returns null for an unsaved action or one that is not parented by a rule. NOTE: this method is temporary and will be removed in future versions. It should only be used with good reason.

Parameters:

action - the action

Returns:

the owning node reference

isLinkedToRuleNode

@Auditable(key=RETURN,
           parameters="nodeRef")
boolean isLinkedToRuleNode(NodeRef nodeRef)

Indicates whether the passed rule node reference is linked to another rule node.

Parameters:

nodeRef - rule node reference

Returns:

boolean true if linked, false otherwise

getLinkedToRuleNode

@Auditable(key=RETURN,
           parameters="nodeRef")
NodeRef getLinkedToRuleNode(NodeRef nodeRef)

Get the node reference to the rule node which the rule node links to. Returns null if rules are not linked.

Parameters:

nodeRef - node reference of a rule node

Returns:

NodeRef reference to the

getLinkedFromRuleNodes

@Auditable(key=RETURN,
           parameters="nodeRef")
java.util.List getLinkedFromRuleNodes(NodeRef nodeRef)

Get a list of the all the rule nodes that link to the passed rule node. Returns an empty list if none link.

Parameters:

nodeRef - node reference of a rule node

Returns:

List list of rule nodes that link to this passed rule node, empty if none