org.kuali.rice.krms.impl.repository
Interface ActionBoService

All Known Implementing Classes:

ActionBoServiceImpl

public interface ActionBoService

This is the interface for accessing KRMS repository Action related business objects.

Author:

Kuali Rice Team (rice.collab@kuali.org)

Method Summary

ActionDefinition	createAction(ActionDefinition action) This will create a ActionDefinition exactly like the parameter passed in.
ActionDefinition	getActionByActionId(String actionId) Retrieves an Action from the repository based on the given action id.
ActionDefinition	getActionByNameAndNamespace(String name, String namespace) Retrieves an Action from the repository based on the provided action name and namespace.
ActionDefinition	getActionByRuleIdAndSequenceNumber(String ruleId, Integer sequenceNumber) Retrieves an specific Action associated with a Rule.
List<ActionDefinition>	getActionsByRuleId(String ruleId) Retrieves an ordered List of Actions associated with a RuleDefinition.
void	updateAction(ActionDefinition action) This will update an existing ActionDefinition.

Method Detail

createAction

@CacheEvict(value={"http://rice.kuali.org/krms/v2_0/ActionType","http://rice.kuali.org/krms/v2_0/RuleType"},
            allEntries=true)
ActionDefinition createAction(ActionDefinition action)

This will create a ActionDefinition exactly like the parameter passed in.

Parameters:

action - The Action to create

Throws:

IllegalArgumentException - if the action is null

IllegalStateException - if the action already exists in the system

updateAction

@CacheEvict(value={"http://rice.kuali.org/krms/v2_0/ActionType","http://rice.kuali.org/krms/v2_0/RuleType"},
            allEntries=true)
void updateAction(ActionDefinition action)

This will update an existing ActionDefinition.

Parameters:

action - The Action to update

Throws:

IllegalArgumentException - if the Action is null

IllegalStateException - if the Action does not exists in the system

getActionByActionId

@Cacheable(value="http://rice.kuali.org/krms/v2_0/ActionType",
           key="\'actionId=\' + #p0")
ActionDefinition getActionByActionId(String actionId)

Retrieves an Action from the repository based on the given action id.

Parameters:

actionId - the id of the Action to retrieve

Returns:

an ActionDefinition identified by the given actionId. A null reference is returned if an invalid or non-existent id is supplied.

Throws:

IllegalArgumentException - if the actionId is null or blank.

getActionByNameAndNamespace

@Cacheable(value="http://rice.kuali.org/krms/v2_0/ActionType",
           key="\'name=\' + #p0 + \'|\' + \'namespace=\' + #p1")
ActionDefinition getActionByNameAndNamespace(String name,
                                                       String namespace)

Retrieves an Action from the repository based on the provided action name and namespace.

Parameters:

name - the name of the Action to retrieve.

namespace - the namespace that the action is under.

Returns:

an ActionDefinition identified by the given name and namespace. A null reference is returned if an invalid or non-existent name and namespace combination is supplied.

Throws:

IllegalArgumentException - if the either the name or the namespace is null or blank.

getActionsByRuleId

@Cacheable(value="http://rice.kuali.org/krms/v2_0/ActionType",
           key="\'ruleId=\' + #p0")
List<ActionDefinition> getActionsByRuleId(String ruleId)

Retrieves an ordered List of Actions associated with a RuleDefinition. The order of the list is determined by the sequenceNumber property of the Actions.

Parameters:

ruleId - the id of the rule

Returns:

a list of ActionDefinition associated with the given rule. A null reference is returned if an invalid or ruleId is supplied.

Throws:

IllegalArgumentException - if the ruleId is null or blank.

getActionByRuleIdAndSequenceNumber

@Cacheable(value="http://rice.kuali.org/krms/v2_0/ActionType",
           key="\'ruleId=\' + #p0 + \'|\' + \'sequenceNumber=\' + #p1")
ActionDefinition getActionByRuleIdAndSequenceNumber(String ruleId,
                                                              Integer sequenceNumber)

Retrieves an specific Action associated with a Rule.

Parameters:

ruleId - the id of the rule

sequenceNumber - an Integer that represents the sequence number of the action.

Returns:

an ActionDefinition identified associated with the Rule and identified by the given sequenceNumber A null reference is returned if an invalid or non-existent name and namespace combination is supplied.

Throws:

IllegalArgumentException - if the ruleId is null or blank. Or if the sequenceNumber is null.