org.zkoss.zul
Class GroupsModelArray<D,H,F,E>

java.lang.Object
  org.zkoss.zul.AbstractGroupsModel<D,H,F,E>
      org.zkoss.zul.GroupsModelArray<D,H,F,E>

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, ComponentCloneListener, GroupsSortableModel<D>, Selectable<E>, GroupsModel<D,H,F>

public class GroupsModelArray<D,H,F,E>
extends AbstractGroupsModel<D,H,F,E>
implements GroupsSortableModel<D>, ComponentCloneListener, java.lang.Cloneable

An array implementation of GroupsModel. This implementation takes a list of elements that are not grouped yet, and a comparator that will be used to group them. The c supports regroup array to groups depends on Comparator and GroupComparator. For immutable content (no re-grouping allowed), please use SimpleGroupsModel instead.

Generics:

D

The class of each data

H

The class of each group header

F

The class of each group footer

E

The class of each selection. It is the common base class of D, H, F. In other words, D, H and F must extend from E.

For more information, please refer to ZK Developer's Reference: Groups Model

By default, the model support cloneable when the component is cloned. (since 6.0.0)

Since:

5.0.5

Author:

Dennis.Chen

See Also:

GroupsModel, SimpleGroupsModel, GroupComparator, ComponentCloneListener, Serialized Form

Field Summary

protected java.util.Comparator<D>	_comparator member field to store Comparator for initial grouping.
protected D[][]	_data member field to store group data
protected java.lang.Object[]	_foots member field to store group foot data (generated in organizeGroup(java.util.Comparator, int))
protected java.lang.Object[]	_heads member field to store group head data (generated in organizeGroup(java.util.Comparator, int))
protected D[]	_nativedata member field to store native (original) array data
protected boolean[]	_opens member field to store group close status

Fields inherited from class org.zkoss.zul.AbstractGroupsModel

_selection

Constructor Summary

GroupsModelArray(D[] data, java.util.Comparator<D> cmpr)
Constructor with an array of data.

GroupsModelArray(D[] data, java.util.Comparator<D> cmpr, int col)
Constructor with an array of data.

GroupsModelArray(D[] data, java.util.Comparator<D> cmpr, int col, boolean clone)
Constructor with an array of data.

GroupsModelArray(java.util.List<D> data, java.util.Comparator cmpr)
Deprecated. As of release 6.0.1, there is no way to instantiate the array with the correct type.

GroupsModelArray(java.util.List<D> data, java.util.Comparator cmpr, int col)
Deprecated. As of release 6.0.1, there is no way to instantiate the array with the correct type.

Method Summary

boolean	addOpenGroup(int groupIndex) Opens the group at the specified index.
java.lang.Object	clone()
protected F	createGroupFoot(D[] groupdata, int index, int col) create group foot Object, default implementation return null, which means no foot .
protected H	createGroupHead(D[] groupdata, int index, int col) create group head Object, default implementation return first element of groupdata.
protected boolean	createGroupOpen(D[] groupdata, int index, int col) create group open status, default implementation return true, which means open the group.
boolean	equals(java.lang.Object o)
D	getChild(int groupIndex, int index) Returns the child value of the specified group at the specified index.
int	getChildCount(int groupIndex) Returns the number of children of the specified group.
H	getGroup(int groupIndex) Returns the group value at the specified index.
int	getGroupCount() Returns the number of groups.
F	getGroupfoot(int groupIndex) Returns the foot value of the specified group, or null if the specified group does not have any foot.
void	group(java.util.Comparator<D> cmpr, boolean ascending, int col) Groups and sorts the data by the specified column.
boolean	hasGroupfoot(int groupIndex) Returns if the specified group has a foot value.
int	hashCode()
boolean	isClose(int groupIndex) Deprecated. As of release 6.0.0, replace with isGroupOpened(int)
boolean	isGroupOpened(int groupIndex) Whether the group is open at the specified index.
protected void	organizeGroup(java.util.Comparator<D> cmpr, int col) Organizes groups based sorted data.
boolean	removeOpenGroup(int groupIndex) Closes the group at the specified index.
void	setClose(int groupIndex, boolean close) Deprecated. As of release 6.0.0, replace with addOpenGroup(int) and removeOpenGroup(int).
void	sort(java.util.Comparator<D> cmpr, boolean ascending, int col) It called when Listbox or Grid has to sort the content.
protected void	sortDataInGroupOrder(java.util.Comparator<D> cmpr, boolean ascending, int colIndex) Sorts the native data in the group order.
protected void	sortGroupData(H group, D[] groupdata, java.util.Comparator<D> cmpr, boolean ascending, int col) Sorts data within a group.
java.lang.String	toString()
java.lang.Object	willClone(Component comp) Allows the model to clone

Methods inherited from class org.zkoss.zul.AbstractGroupsModel

addGroupsDataListener, addToSelection, clearSelection, fireEvent, fireSelectionEvent, getSelection, isMultiple, isSelected, isSelectionEmpty, newEmptySelection, readSelection, removeAllSelection, removeFromSelection, removeGroupsDataListener, retainAllSelection, setMultiple, setSelection, writeSelection

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

_nativedata

protected D[] _nativedata

member field to store native (original) array data

_comparator

protected java.util.Comparator<D> _comparator

member field to store Comparator for initial grouping.

_data

protected D[][] _data

member field to store group data

_heads

protected java.lang.Object[] _heads

member field to store group head data (generated in organizeGroup(java.util.Comparator, int))

_foots

protected java.lang.Object[] _foots

member field to store group foot data (generated in organizeGroup(java.util.Comparator, int))

_opens

protected boolean[] _opens

member field to store group close status

Constructor Detail

GroupsModelArray

public GroupsModelArray(D[] data,
                        java.util.Comparator<D> cmpr)

Constructor with an array of data.

Parameters:

data - an array data to be grouping.

cmpr - a comparator implementation help group the data. you could implements GroupComparator to do more grouping control.
At 1st phase, it calls Comparator.compare(Object, Object) or GroupComparator.compareGroup(Object, Object) to sort the data.
At 2nd phase, it calls Comparator.compare(Object, Object) or GroupComparator.compareGroup(Object, Object) to decide which data belong to which group. In this phase it also invoke createGroupHead(Object[], int, int) and createGroupFoot(Object[], int, int) to create head of foot Object of each group.
At 3rd phase, it calls Comparator.compare(Object, Object) to sort data in each group.

GroupsModelArray

public GroupsModelArray(D[] data,
                        java.util.Comparator<D> cmpr,
                        int col)

Constructor with an array of data. It is the same as GroupsModelArray(data, cmpr, col, true), i.e., data will be cloned first, so data's content won't be changed.

Parameters:

data - an array data to be grouping.

cmpr - a comparator implementation help group the data. you could implements GroupComparator to do more grouping control.
At 1st phase, it calls Comparator.compare(Object, Object) or GroupComparator.compareGroup(Object, Object) to sort the data.
At 2nd phase, it calls Comparator.compare(Object, Object) or GroupComparator.compareGroup(Object, Object) to decide which data belong to which group. In this phase it also invoke createGroupHead(Object[], int, int) and createGroupFoot(Object[], int, int) to create head of foot Object of each group.
At 3rd phase, it calls Comparator.compare(Object, Object) to sort data in each group.

col - column index associate with cmpr.

GroupsModelArray

public GroupsModelArray(D[] data,
                        java.util.Comparator<D> cmpr,
                        int col,
                        boolean clone)

Constructor with an array of data.

Parameters:

data - an array data to be grouping.

cmpr - a comparator implementation help group the data. you could implements GroupComparator to do more grouping control.
At 1st phase, it calls Comparator.compare(Object, Object) or GroupComparator.compareGroup(Object, Object) to sort the data.
At 2nd phase, it calls Comparator.compare(Object, Object) or GroupComparator.compareGroup(Object, Object) to decide which data belong to which group. In this phase it also invoke createGroupHead(Object[], int, int) and createGroupFoot(Object[], int, int) to create head of foot Object of each group.
At 3rd phase, it calls Comparator.compare(Object, Object) to sort data in each group.

col - column index associate with cmpr.

clone - whether to clone data. If not cloning, data's content will be changed.

Since:

5.0.6

GroupsModelArray

public GroupsModelArray(java.util.List<D> data,
                        java.util.Comparator cmpr,
                        int col)

Deprecated. As of release 6.0.1, there is no way to instantiate the array with the correct type.

GroupsModelArray

public GroupsModelArray(java.util.List<D> data,
                        java.util.Comparator cmpr)

Deprecated. As of release 6.0.1, there is no way to instantiate the array with the correct type.

Method Detail

getChild

public D getChild(int groupIndex,
                  int index)

Description copied from interface: GroupsModel

Returns the child value of the specified group at the specified index.

Specified by:

getChild in interface GroupsModel<D,H,F>

Parameters:

groupIndex - the index of the group.

index - the index of the element in the group.

getChildCount

public int getChildCount(int groupIndex)

Description copied from interface: GroupsModel

Returns the number of children of the specified group.

Note: it does not include the group foot (GroupsModel.getGroupfoot(int)).

Specified by:

getChildCount in interface GroupsModel<D,H,F>

Parameters:

groupIndex - the index of the group.

getGroup

public H getGroup(int groupIndex)

Description copied from interface: GroupsModel

Returns the group value at the specified index. It is used to render Group and Listgroup.

Specified by:

getGroup in interface GroupsModel<D,H,F>

Parameters:

groupIndex - the index of the group.

getGroupCount

public int getGroupCount()

Description copied from interface: GroupsModel

Returns the number of groups.

Specified by:

getGroupCount in interface GroupsModel<D,H,F>

getGroupfoot

public F getGroupfoot(int groupIndex)

Description copied from interface: GroupsModel

Returns the foot value of the specified group, or null if the specified group does not have any foot. It is used to render Groupfoot and Listgroupfoot.

Note: it is ignored if GroupsModel.hasGroupfoot(int) returns false.

Specified by:

getGroupfoot in interface GroupsModel<D,H,F>

Parameters:

groupIndex - the index of the group.

hasGroupfoot

public boolean hasGroupfoot(int groupIndex)

Description copied from interface: GroupsModel

Returns if the specified group has a foot value.

Specified by:

hasGroupfoot in interface GroupsModel<D,H,F>

Parameters:

groupIndex - the index of the group.

sort

public void sort(java.util.Comparator<D> cmpr,
                 boolean ascending,
                 int col)

Description copied from interface: GroupsSortableModel

It called when Listbox or Grid has to sort the content.

After sorting, this model shall notify the instances of ListDataListener (registered thru ListModel.addListDataListener(org.zkoss.zul.event.ListDataListener)) to update the content. Typically you have to notify with

new ListDataEvent(this, ListDataEvent.CONTENTS_CHANGED, -1, -1)

to denote all data are changed (and reloading is required).

The comparator assigned to, say, Listheader.setSortAscending(java.util.Comparator) is passed to method as the cmpr argument. Thus, developers could use it as a tag to know which column or what kind of order to sort. Notice that the comparator is capable to sort under the order specified in the ascending parameter. In other words, you could ignore the ascending parameter (which is used only for providing additional information)

Specified by:

sort in interface GroupsSortableModel<D>

Parameters:

cmpr - the comparator assigned to Listheader.setSortAscending(java.util.Comparator) and other relative methods. If developers didn't assign any one, the default comparator is used. Notice that it is capable to sort the data in the correct order, you could ignore the ascending parameter.

ascending - whether to sort in the ascending order (or in the descending order, if false). Notice that it is used only to provide additional information. To sort the data correctly, you could count on the cmpr parameter only.

col - the index of the column

group

public void group(java.util.Comparator<D> cmpr,
                  boolean ascending,
                  int col)

Description copied from interface: GroupsSortableModel

Groups and sorts the data by the specified column. It only called when Listbox or Grid has the sort function.

Specified by:

group in interface GroupsSortableModel<D>

Parameters:

cmpr - the comparator assigned to Column.setSortAscending(java.util.Comparator) and other relative methods. If developers didn't assign any one, the method is returned directly.

ascending - whether to sort in the ascending order (or in the descending order)

col - the index of the column

isClose

public boolean isClose(int groupIndex)

Deprecated. As of release 6.0.0, replace with isGroupOpened(int)

setClose

public void setClose(int groupIndex,
                     boolean close)

Deprecated. As of release 6.0.0, replace with addOpenGroup(int) and removeOpenGroup(int).

addOpenGroup

public boolean addOpenGroup(int groupIndex)

Description copied from interface: GroupsModel

Opens the group at the specified index.

Specified by:

addOpenGroup in interface GroupsModel<D,H,F>

Parameters:

groupIndex - the index of the group.

Returns:

if it has been added successfully; false if it was opened.

removeOpenGroup

public boolean removeOpenGroup(int groupIndex)

Description copied from interface: GroupsModel

Closes the group at the specified index.

Specified by:

removeOpenGroup in interface GroupsModel<D,H,F>

Parameters:

groupIndex - the index of the group.

Returns:

if it has been removed successfully; false if it was closed.

isGroupOpened

public boolean isGroupOpened(int groupIndex)

Description copied from interface: GroupsModel

Whether the group is open at the specified index. It is used to render Group and Listgroup.

Default: true

Specified by:

isGroupOpened in interface GroupsModel<D,H,F>

Parameters:

groupIndex - the index of the group.

sortGroupData

protected void sortGroupData(H group,
                             D[] groupdata,
                             java.util.Comparator<D> cmpr,
                             boolean ascending,
                             int col)

Sorts data within a group. Notice that this method doesn't fire event.

There are three steps to re-group data: sortDataInGroupOrder(java.util.Comparator, boolean, int), organizeGroup(java.util.Comparator, int) and then sortGroupData(H, D[], java.util.Comparator, boolean, int).

It is the last step of grouping. It sorts data in the specified group.

organizeGroup

protected void organizeGroup(java.util.Comparator<D> cmpr,
                             int col)

Organizes groups based sorted data.

There are three steps to re-group data: sortDataInGroupOrder(java.util.Comparator, boolean, int), organizeGroup(java.util.Comparator, int) and then sortGroupData(H, D[], java.util.Comparator, boolean, int).

It is the second step of grouping. It creates group data based on the data sorted in the group order by sortDataInGroupOrder(java.util.Comparator, boolean, int).

Parameters:

cmpr - the comparator used to compare data in the group order. Notice that the comparator is never an instance of GroupComparator. The implementation just uses Comparator.compare(T, T) to sort the data.

col - column index

createGroupHead

protected H createGroupHead(D[] groupdata,
                            int index,
                            int col)

create group head Object, default implementation return first element of groupdata. you can override this method to return your Object.

Parameters:

groupdata - data the already in a group.

index - group index

col - column to group

createGroupFoot

protected F createGroupFoot(D[] groupdata,
                            int index,
                            int col)

create group foot Object, default implementation return null, which means no foot . you can override this method to return your Object.

Parameters:

groupdata - data the already in a group.

index - group index

col - column to group

sortDataInGroupOrder

protected void sortDataInGroupOrder(java.util.Comparator<D> cmpr,
                                    boolean ascending,
                                    int colIndex)

Sorts the native data in the group order. After sorted, all data in the first group shall be placed in front of the second group, and so on.

There are three steps to re-group data: sortDataInGroupOrder(java.util.Comparator, boolean, int), organizeGroup(java.util.Comparator, int) and then sortGroupData(H, D[], java.util.Comparator, boolean, int).

Parameters:

cmpr - the comparator used to compare data in the group order. Notice that the comparator is never an instance of GroupComparator. The implementation just uses Comparator.compare(T, T) to sort the data.

createGroupOpen

protected boolean createGroupOpen(D[] groupdata,
                                  int index,
                                  int col)

create group open status, default implementation return true, which means open the group. you can override this method to return your group open status.

Parameters:

groupdata - data the already in a group.

index - group index

col - column to group

Since:

6.0.0

clone

public java.lang.Object clone()

Overrides:

clone in class AbstractGroupsModel<D,H,F,E>

willClone

public java.lang.Object willClone(Component comp)

Allows the model to clone

Specified by:

willClone in interface ComponentCloneListener

Parameters:

comp - the cloned component (not the original one)

Returns:

the object to be used in the cloned component. If this object is returned, the same object is shared by the cloned and original components. If other object is returned, it is used by the cloned component. If null is returned, it is not used by the cloned component at all.

Since:

6.0.0

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object