org.kuali.rice.krad.uif.container
Class CollectionGroupBuilder

java.lang.Object
  org.kuali.rice.krad.uif.container.CollectionGroupBuilder

All Implemented Interfaces:

Serializable

public class CollectionGroupBuilder
extends Object
implements Serializable

Builds out the Field instances for a collection group with a series of steps that interact with the configured CollectionLayoutManager to assemble the fields as necessary for the layout

Author:

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

See Also:

Serialized Form

Constructor Summary

CollectionGroupBuilder()

Method Summary

protected void	applyLineFieldAuthorizationAndPresentationLogic(View view, ViewModel model, CollectionGroup collectionGroup, Object line, boolean readOnlyLine, List<Field> lineFields, List<Action> actions) Iterates through the line fields and checks the view field authorization using the view's configured authorizer and presentation controller.
void	build(View view, Object model, CollectionGroup collectionGroup) Creates the Field instances that make up the table
protected void	buildAddLine(View view, Object model, CollectionGroup collectionGroup) Builds the fields for holding the collection add line and if necessary makes call to setup the new line instance
protected void	buildLine(View view, Object model, CollectionGroup collectionGroup, String bindingPath, List<Action> actions, boolean bindToForm, Object currentLine, int lineIndex) Builds the field instances for the collection line.
protected void	buildLinesForDisplayedRows(List<org.kuali.rice.krad.uif.container.CollectionGroupBuilder.IndexedElement> filteredIndexedElements, View view, Object model, CollectionGroup collectionGroup) Build the lines for the collection rows to be rendered.
protected boolean	checkEditLineAuthorizationAndPresentationLogic(View view, ViewModel model, CollectionGroup collectionGroup, Object line) Invokes the view's configured authorizer and presentation controller to determine if the user has permission to edit the line (if a permission has been established)
protected boolean	checkSubCollectionRender(View view, Object model, CollectionGroup collectionGroup, CollectionGroup subCollectionGroup) Checks whether the given sub-collection should be rendered, any conditional render string is evaluated
protected boolean	checkViewLineAuthorizationAndPresentationLogic(View view, ViewModel model, CollectionGroup collectionGroup, Object line) Invokes the view's configured authorizer and presentation controller to determine if the user has permission to view the line (if a permission has been established)
protected List<Action>	getAddLineActions(View view, Object model, CollectionGroup collectionGroup) Creates new Action instances for the add line
protected Map<String,Object>	getContextForField(View view, CollectionGroup collectionGroup, Field field) Helper method to build the context for a field (needed because the apply model phase for line fields has not been applied yet and their full context not set)
protected List<Action>	initializeLineActions(List<Action> lineActions, View view, Object model, CollectionGroup collectionGroup, Object collectionLine, int lineIndex) Creates new Action instances for the line
void	initializeNewCollectionLine(View view, Object model, CollectionGroup collectionGroup, boolean clearExistingLine) Initializes a new instance of the collection class
protected List<Integer>	performCollectionFiltering(View view, Object model, CollectionGroup collectionGroup, Collection<?> collection) Performs any filtering necessary on the collection before building the collection fields
protected List<Field>	processAnyRemoteFieldsHolder(View view, Object model, CollectionGroup group, List<? extends Component> items) Iterates through the given items checking for RemotableFieldsHolder, if found the holder is invoked to retrieved the remotable fields and translate to attribute fields.
protected List<Field>	removeNonRenderLineFields(View view, Object model, CollectionGroup collectionGroup, List<Field> lineFields, Object currentLine, int lineIndex) Evaluates the render property for the given list of Field instances for the line and removes any fields from the returned list that have render false.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CollectionGroupBuilder

public CollectionGroupBuilder()

Method Detail

build

public void build(View view,
                  Object model,
                  CollectionGroup collectionGroup)

Creates the Field instances that make up the table

The corresponding collection is retrieved from the model and iterated over to create the necessary fields. The binding path for fields that implement DataBinding is adjusted to point to the collection line it is apart of. For example, field 'number' of collection 'accounts' for line 1 will be set to 'accounts[0].number', and for line 2 'accounts[1].number'. Finally parameters are set on the line's action fields to indicate what collection and line they apply to.

Only the lines that are to be rendered (as specified by the displayStart and displayLength properties of the CollectionGroup) will be built.

Parameters:

view - View instance the collection belongs to

model - Top level object containing the data

collectionGroup - CollectionGroup component for the collection

buildLinesForDisplayedRows

protected void buildLinesForDisplayedRows(List<org.kuali.rice.krad.uif.container.CollectionGroupBuilder.IndexedElement> filteredIndexedElements,
                                          View view,
                                          Object model,
                                          CollectionGroup collectionGroup)

Build the lines for the collection rows to be rendered.

Parameters:

filteredIndexedElements - a filtered and indexed list of the model collection elements

view - View instance the collection belongs to

model - Top level object containing the data

collectionGroup - CollectionGroup component for the collection

performCollectionFiltering

protected List<Integer> performCollectionFiltering(View view,
                                                   Object model,
                                                   CollectionGroup collectionGroup,
                                                   Collection<?> collection)

Performs any filtering necessary on the collection before building the collection fields

If showInactive is set to false and the collection line type implements Inactivatable, invokes the active collection filter. Then any CollectionFilter instances configured for the collection group are invoked to filter the collection. Collections lines must pass all filters in order to be displayed

Parameters:

view - view instance that contains the collection

model - object containing the views data

collectionGroup - collection group component instance that will display the collection

collection - collection instance that will be filtered

buildAddLine

protected void buildAddLine(View view,
                            Object model,
                            CollectionGroup collectionGroup)

Builds the fields for holding the collection add line and if necessary makes call to setup the new line instance

Parameters:

view - view instance the collection belongs to

collectionGroup - collection group the layout manager applies to

model - Object containing the view data, should extend UifFormBase if using framework managed new lines

buildLine

protected void buildLine(View view,
                         Object model,
                         CollectionGroup collectionGroup,
                         String bindingPath,
                         List<Action> actions,
                         boolean bindToForm,
                         Object currentLine,
                         int lineIndex)

Builds the field instances for the collection line. A copy of the configured items on the CollectionGroup is made and adjusted for the line (id and binding). Then a call is made to the CollectionLayoutManager to assemble the line as necessary for the layout

Parameters:

view - view instance the collection belongs to

model - top level object containing the data

collectionGroup - collection group component for the collection

bindingPath - binding path for the line fields (if DataBinding)

actions - List of actions to set in the lines action column

bindToForm - whether the bindToForm property on the items bindingInfo should be set to true (needed for add line)

currentLine - object instance for the current line, or null if add line

lineIndex - index of the line in the collection, or -1 if we are building the add line

processAnyRemoteFieldsHolder

protected List<Field> processAnyRemoteFieldsHolder(View view,
                                                   Object model,
                                                   CollectionGroup group,
                                                   List<? extends Component> items)

Iterates through the given items checking for RemotableFieldsHolder, if found the holder is invoked to retrieved the remotable fields and translate to attribute fields. The translated list is then inserted into the returned list at the position of the holder

Parameters:

view - view instance containing the container

model - object instance containing the view data

group - collection group instance to check for any remotable fields holder

items - list of items to process

removeNonRenderLineFields

protected List<Field> removeNonRenderLineFields(View view,
                                                Object model,
                                                CollectionGroup collectionGroup,
                                                List<Field> lineFields,
                                                Object currentLine,
                                                int lineIndex)

Evaluates the render property for the given list of Field instances for the line and removes any fields from the returned list that have render false. The conditional render string is also taken into account. This needs to be done here as opposed to during the normal condition evaluation so the the fields are not used while building the collection lines

Parameters:

view - view instance the collection group belongs to

model - object containing the view data

collectionGroup - collection group for the line fields

lineFields - list of fields configured for the line

currentLine - object containing the line data

lineIndex - index of the line in the collection

Returns:

list of field instances that should be rendered

checkViewLineAuthorizationAndPresentationLogic

protected boolean checkViewLineAuthorizationAndPresentationLogic(View view,
                                                                 ViewModel model,
                                                                 CollectionGroup collectionGroup,
                                                                 Object line)

Invokes the view's configured authorizer and presentation controller to determine if the user has permission to view the line (if a permission has been established)

Parameters:

view - view instance the collection belongs to and from which the authorizer/presentation controller will be pulled

model - object containing the view's data

collectionGroup - collection group containing the line

line - object containing the lines data

Returns:

true if the user can view the line, false if not

checkEditLineAuthorizationAndPresentationLogic

protected boolean checkEditLineAuthorizationAndPresentationLogic(View view,
                                                                 ViewModel model,
                                                                 CollectionGroup collectionGroup,
                                                                 Object line)

Invokes the view's configured authorizer and presentation controller to determine if the user has permission to edit the line (if a permission has been established)

Parameters:

view - view instance the collection belongs to and from which the authorizer/presentation controller will be pulled

model - object containing the view's data

collectionGroup - collection group containing the line

line - object containing the lines data

Returns:

true if the user can edit the line, false if not

applyLineFieldAuthorizationAndPresentationLogic

protected void applyLineFieldAuthorizationAndPresentationLogic(View view,
                                                               ViewModel model,
                                                               CollectionGroup collectionGroup,
                                                               Object line,
                                                               boolean readOnlyLine,
                                                               List<Field> lineFields,
                                                               List<Action> actions)

Iterates through the line fields and checks the view field authorization using the view's configured authorizer and presentation controller. If the field is viewable, then sets the edit field authorization. Finally iterates through the line actions invoking the authorizer and presentation controller to authorizer the action

Parameters:

view - view instance the collection belongs to and from which the authorizer/presentation controller will be pulled

model - object containing the view's data

collectionGroup - collection group containing the line

line - object containing the lines data

readOnlyLine - flag indicating whether the line has been marked as read only (which will force the fields to be read only)

lineFields - list of fields instances for the line

actions - list of action field instances for the line

checkSubCollectionRender

protected boolean checkSubCollectionRender(View view,
                                           Object model,
                                           CollectionGroup collectionGroup,
                                           CollectionGroup subCollectionGroup)

Checks whether the given sub-collection should be rendered, any conditional render string is evaluated

Parameters:

view - view instance the sub collection belongs to

model - object containing the view data

collectionGroup - collection group the sub collection belongs to

subCollectionGroup - sub collection group to check render status for

Returns:

true if sub collection should be rendered, false if it should not be rendered

initializeLineActions

protected List<Action> initializeLineActions(List<Action> lineActions,
                                             View view,
                                             Object model,
                                             CollectionGroup collectionGroup,
                                             Object collectionLine,
                                             int lineIndex)

Creates new Action instances for the line

Adds context to the action fields for the given line so that the line the action was performed on can be determined when that action is selected

Parameters:

lineActions - the actions to copy

view - view instance the collection belongs to

model - top level object containing the data

collectionGroup - collection group component for the collection

collectionLine - object instance for the current line

lineIndex - index of the line the actions should apply to

getAddLineActions

protected List<Action> getAddLineActions(View view,
                                         Object model,
                                         CollectionGroup collectionGroup)

Creates new Action instances for the add line

Adds context to the action fields for the add line so that the collection the action was performed on can be determined

Parameters:

view - view instance the collection belongs to

model - top level object containing the data

collectionGroup - collection group component for the collection

getContextForField

protected Map<String,Object> getContextForField(View view,
                                                CollectionGroup collectionGroup,
                                                Field field)

Helper method to build the context for a field (needed because the apply model phase for line fields has not been applied yet and their full context not set)

Parameters:

view - view instance the field belongs to

collectionGroup - collection group instance the field belongs to

field - field instance to build context for

Returns:

Map context for field

initializeNewCollectionLine

public void initializeNewCollectionLine(View view,
                                        Object model,
                                        CollectionGroup collectionGroup,
                                        boolean clearExistingLine)

Initializes a new instance of the collection class

If the add line property was not specified for the collection group the new lines will be added to the generic map on the UifFormBase, else it will be added to the property given by the addLineBindingInfo

New line will only be created if the current line property is null or clearExistingLine is true. In the case of a new line default values are also applied

See Also:

initializeNewCollectionLine(View, Object, CollectionGroup, boolean)