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

All Known Implementing Classes:

AgendaBoServiceImpl

public interface AgendaBoService

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

Author:

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

Method Summary

void	addAgendaItem(AgendaItem agendaItem, String parentId, Boolean position) This will create an AgendaItem in the repository exactly like the parameter passed in.
AgendaDefinition	createAgenda(AgendaDefinition agenda) This will create a AgendaDefinition exactly like the parameter passed in.
AgendaItem	createAgendaItem(AgendaItem agendaItem) This will create an AgendaItem in the repository exactly like the parameter passed in.
org.kuali.rice.krms.impl.repository.AgendaBo	from(AgendaDefinition im) Converts a immutable object to it's mutable bo counterpart
AgendaDefinition	getAgendaByAgendaId(String agendaId) Retrieves an Agenda from the repository based on the given agenda id.
AgendaDefinition	getAgendaByNameAndContextId(String name, String contextId) Retrieves an Agenda from the repository based on the provided agenda name and context id.
AgendaItem	getAgendaItemById(String id) Retrieves an AgendaItem from the repository based on the given agenda id.
Set<AgendaDefinition>	getAgendasByContextId(String contextId) Retrieves a set of Agendas associated with a context.
AgendaDefinition	to(org.kuali.rice.krms.impl.repository.AgendaBo bo) Converts a mutable bo to it's immutable counterpart
void	updateAgenda(AgendaDefinition agenda) This will update an existing AgendaDefinition.
void	updateAgendaItem(AgendaItem agendaItem) This will update an existing AgendaItem.

Method Detail

createAgenda

AgendaDefinition createAgenda(AgendaDefinition agenda)

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

Parameters:

agenda - The Agenda to create

Throws:

IllegalArgumentException - if the Agenda is null

IllegalStateException - if the Agenda already exists in the system

updateAgenda

void updateAgenda(AgendaDefinition agenda)

This will update an existing AgendaDefinition.

Parameters:

agenda - The Agenda to update

Throws:

IllegalArgumentException - if the Agenda is null

IllegalStateException - if the Agenda does not exists in the system

getAgendaByAgendaId

AgendaDefinition getAgendaByAgendaId(String agendaId)

Retrieves an Agenda from the repository based on the given agenda id.

Parameters:

agendaId - the id of the Agenda to retrieve

Returns:

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

getAgendaByNameAndContextId

AgendaDefinition getAgendaByNameAndContextId(String name,
                                             String contextId)

Retrieves an Agenda from the repository based on the provided agenda name and context id.

Parameters:

name - the name of the Agenda to retrieve.

contextId - the id of the context that the agenda belongs to.

Returns:

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

getAgendasByContextId

Set<AgendaDefinition> getAgendasByContextId(String contextId)

Retrieves a set of Agendas associated with a context.

Parameters:

contextId - the id of the context

Returns:

a set of AgendaDefinition associated with the given context. A null reference is returned if an invalid or contextId is supplied.

createAgendaItem

AgendaItem createAgendaItem(AgendaItem agendaItem)

This will create an AgendaItem in the repository exactly like the parameter passed in.

Parameters:

agendaItem - The AgendaItem to create

Throws:

IllegalArgumentException - if the AgendaItem is null

IllegalStateException - if the AgendaItem already exists in the system

updateAgendaItem

void updateAgendaItem(AgendaItem agendaItem)

This will update an existing AgendaItem.

Parameters:

agendaItem - The AgendaItem to update

Throws:

IllegalArgumentException - if the AgendaItem is null

IllegalStateException - if the AgendaItem does not exists in the system

addAgendaItem

void addAgendaItem(AgendaItem agendaItem,
                   String parentId,
                   Boolean position)

This will create an AgendaItem in the repository exactly like the parameter passed in. The AgendaItem will be linked to an existing AgendaItem in the relationship provided. Linking the AgendaItems effectively builds a tree of AgendaItems that may be traversed by the engine.

Parameters:

agendaItem - The AgendaItem to create

parentId - The id of the existing AgendaItem to be linked with the newly created AgendaItem

position. - A boolean used to specify the relationship between the linked AgendaItems.

If the position parameter is true, the new AgendaItem is linked as the next AgendaItem to be evaluated if the parent AgendaItem evaluates to TRUE.

If the position parameter is false, the new AgendaItem is linked as the next AgendaItem to be evaluated if the parent AgendaItem evaluates to FALSE.

If the position parameter is null, the new AgendaItem is linked as the next AgendaItem to be evaluated after any true or false branches of the tree have been traversed.

Throws:

IllegalArgumentException - if the AgendaItem is null

IllegalStateException - if the parent AgendaItem does not already exists in the system

getAgendaItemById

AgendaItem getAgendaItemById(String id)

Retrieves an AgendaItem from the repository based on the given agenda id.

Parameters:

id - the id of the AgendaItem to retrieve

Returns:

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

to

AgendaDefinition to(org.kuali.rice.krms.impl.repository.AgendaBo bo)

Converts a mutable bo to it's immutable counterpart

Parameters:

bo - the mutable business object

Returns:

the immutable object

from

org.kuali.rice.krms.impl.repository.AgendaBo from(AgendaDefinition im)

Converts a immutable object to it's mutable bo counterpart

Parameters:

im - immutable object

Returns:

the mutable bo