Package io.jmix.groupgridflowui.data

Class EmptyGroupDataGridItems<T>

java.lang.Object

com.vaadin.flow.data.provider.AbstractDataProvider<T,Void>

io.jmix.flowui.data.grid.EmptyDataGridItems<T>

io.jmix.groupgridflowui.data.EmptyGroupDataGridItems<T>

All Implemented Interfaces:

com.vaadin.flow.data.provider.DataProvider<T,Void>, com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider<T,Void>, GroupDataGridItems<T>, DataUnit, EmptyDataUnit, EntityDataUnit, DataGridItems<T>, DataGridItems.Sortable<T>, EntityDataGridItems<T>, HasType<T>, Serializable

public class EmptyGroupDataGridItems<T>
extends EmptyDataGridItems<T>
implements GroupDataGridItems<T>

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface io.jmix.flowui.data.grid.DataGridItems

DataGridItems.ItemSetChangeEvent<T>, DataGridItems.SelectedItemChangeEvent<T>, DataGridItems.Sortable<T>, DataGridItems.ValueChangeEvent<T>

Nested classes/interfaces inherited from interface io.jmix.flowui.data.DataUnit

DataUnit.StateChangeEvent

Nested classes/interfaces inherited from interface io.jmix.flowui.component.groupgrid.data.GroupDataGridItems

GroupDataGridItems.GroupPropertyDescriptorsChangedEvent<T>

Constructor Summary

Constructors

Constructor	Description
EmptyGroupDataGridItems(MetaClass metaClass)

Method Summary

Modifier and Type	Method	Description
void	addGroupPropertyDescriptor(GroupPropertyDescriptor<T> groupPropertyDescriptor)	Adds a group property descriptor for a custom grouping property.
com.vaadin.flow.shared.Registration	addGroupPropertyDescriptorsChangedListener(Consumer<GroupDataGridItems.GroupPropertyDescriptorsChangedEvent<T>> listener)	Adds a listener to be notified when the group property descriptors are changed.
boolean	containsGroup(GroupInfo group)	Indicates that a group is contained in the group tree
Stream<T>	fetchChildren(com.vaadin.flow.data.provider.hierarchy.HierarchicalQuery<T,Void> query)
int	getChildCount(com.vaadin.flow.data.provider.hierarchy.HierarchicalQuery<T,Void> query)
List<T>	getChildItems(GroupInfo group)
List<GroupInfo>	getChildren(GroupInfo group)
GroupInfo	getGroup(T item)
GroupInfo	getGroupByItem(T groupItem)	Returns GroupInfo by a group item.
Collection<T>	getGroupItems(GroupInfo group)
int	getGroupItemsCount(GroupInfo group)
List<GroupInfo>	getGroupPath(T item)
Collection<GroupProperty>	getGroupProperties()
GroupPropertyDescriptor<T>	getGroupPropertyDescriptor(GroupProperty property)
T	getItemByGroup(GroupInfo group)	Returns a group item that corresponds to the provided GroupInfo.
List<T>	getOwnChildItems(GroupInfo group)
List<GroupInfo>	getRootGroups()
void	groupBy(List<GroupProperty> properties)	Perform grouping by the list of properties.
boolean	hasChildren(GroupInfo group)	Indicates that the group has nested groups
boolean	hasChildren(T item)
boolean	hasGroups()	Indicates that items have groups
void	removeAllGroupPropertyProviders()	Removes all group property descriptors previously added for grouping.
void	removeGroupPropertyDescriptor(GroupProperty property)	Removes a group property descriptor for a custom property that was previously added for grouping.

Methods inherited from class io.jmix.flowui.data.grid.EmptyDataGridItems

addItemSetChangeListener, addSelectedItemChangeListener, addStateChangeListener, addValueChangeListener, containsItem, fetch, getEntityMetaClass, getItem, getItems, getItemValue, getSelectedItem, getState, getType, isInMemory, resetSortOrder, setSelectedItem, size, sort

Methods inherited from class com.vaadin.flow.data.provider.AbstractDataProvider

addDataProviderListener, addListener, fireEvent, refreshAll, refreshItem, refreshItem

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.jmix.flowui.data.grid.DataGridItems

addItemSetChangeListener, addSelectedItemChangeListener, addValueChangeListener, containsItem, getItem, getItems, getItemValue, getSelectedItem, setSelectedItem

Methods inherited from interface io.jmix.flowui.data.grid.DataGridItems.Sortable

enableSorting, suppressSorting

Methods inherited from interface com.vaadin.flow.data.provider.DataProvider

addDataProviderListener, getId, isInMemory, refreshAll, refreshItem, refreshItem

Methods inherited from interface io.jmix.flowui.data.DataUnit

addStateChangeListener, getState

Methods inherited from interface io.jmix.flowui.data.HasType

getType

Methods inherited from interface com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider

fetch, size, withConfigurableFilter, withConfigurableFilter, withConvertedFilter

Constructor Details

EmptyGroupDataGridItems

public EmptyGroupDataGridItems(MetaClass metaClass)

Method Details

groupBy

public void groupBy(List<GroupProperty> properties)

Description copied from interface: GroupDataGridItems

Perform grouping by the list of properties. The available values for properties are:

• MetaPropertyPath can be a property of current or a reference entity.
• Column key (String) of a generated value.

Specified by:

groupBy in interface GroupDataGridItems<T>

getRootGroups

public List<GroupInfo> getRootGroups()

Specified by:

getRootGroups in interface GroupDataGridItems<T>

Returns:

the list of root groups

hasChildren

public boolean hasChildren(GroupInfo group)

Description copied from interface: GroupDataGridItems

Indicates that the group has nested groups

Specified by:

hasChildren in interface GroupDataGridItems<T>

Parameters:

group - group info

getChildren

public List<GroupInfo> getChildren(GroupInfo group)

Specified by:

getChildren in interface GroupDataGridItems<T>

Returns:

the list of own nested groups

getOwnChildItems

public List<T> getOwnChildItems(GroupInfo group)

Specified by:

getOwnChildItems in interface GroupDataGridItems<T>

Returns:

the list of nested items

getChildItems

public List<T> getChildItems(GroupInfo group)

Specified by:

getChildItems in interface GroupDataGridItems<T>

Returns:

the list of items from all nested group levels

getGroup

@Nullable
public GroupInfo getGroup(T item)

Specified by:

getGroup in interface GroupDataGridItems<T>

Returns:

a group that the passed item belongs to

getGroupPath

public List<GroupInfo> getGroupPath(T item)

Specified by:

getGroupPath in interface GroupDataGridItems<T>

Parameters:

item - item (leaf) to get all parent groups for

Returns:

the path through all parent groups

getGroupItems

public Collection<T> getGroupItems(GroupInfo group)

Specified by:

getGroupItems in interface GroupDataGridItems<T>

Returns:

items that are contained in the selected group

getGroupItemsCount

public int getGroupItemsCount(GroupInfo group)

Specified by:

getGroupItemsCount in interface GroupDataGridItems<T>

Returns:

a count of items that are contained in the selected group

hasGroups

public boolean hasGroups()

Description copied from interface: GroupDataGridItems

Indicates that items have groups

Specified by:

hasGroups in interface GroupDataGridItems<T>

getGroupProperties

public Collection<GroupProperty> getGroupProperties()

Specified by:

getGroupProperties in interface GroupDataGridItems<T>

Returns:

group properties

containsGroup

public boolean containsGroup(GroupInfo group)

Description copied from interface: GroupDataGridItems

Indicates that a group is contained in the group tree

Specified by:

containsGroup in interface GroupDataGridItems<T>

addGroupPropertyDescriptor

public void addGroupPropertyDescriptor(GroupPropertyDescriptor<T> groupPropertyDescriptor)

Description copied from interface: GroupDataGridItems

Adds a group property descriptor for a custom grouping property. This method enables defining custom logic for computing property values during data grouping.

For instance:

 customersDataGrid.getItems().addGroupPropertyDescriptor(
         new BaseGroupPropertyDescriptor<Customer>("fullName", context -> {
             Customer item = context.getItem();
             return item.getFirstName() + " " + item.getLastName();
         }).withSortProperties(List.of("firstName", "lastName")));
 

Specified by:

addGroupPropertyDescriptor in interface GroupDataGridItems<T>

Parameters:

groupPropertyDescriptor - implementation of GroupPropertyDescriptor

removeGroupPropertyDescriptor

public void removeGroupPropertyDescriptor(GroupProperty property)

Description copied from interface: GroupDataGridItems

Removes a group property descriptor for a custom property that was previously added for grouping.

Specified by:

removeGroupPropertyDescriptor in interface GroupDataGridItems<T>

Parameters:

property - the custom property

getGroupPropertyDescriptor

@Nullable
public GroupPropertyDescriptor<T> getGroupPropertyDescriptor(GroupProperty property)

Specified by:

getGroupPropertyDescriptor in interface GroupDataGridItems<T>

Parameters:

property - the custom property

Returns:

a group property descriptor for a custom property

removeAllGroupPropertyProviders

public void removeAllGroupPropertyProviders()

Description copied from interface: GroupDataGridItems

Removes all group property descriptors previously added for grouping.

Specified by:

removeAllGroupPropertyProviders in interface GroupDataGridItems<T>

addGroupPropertyDescriptorsChangedListener

public com.vaadin.flow.shared.Registration addGroupPropertyDescriptorsChangedListener(Consumer<GroupDataGridItems.GroupPropertyDescriptorsChangedEvent<T>> listener)

Description copied from interface: GroupDataGridItems

Adds a listener to be notified when the group property descriptors are changed.

Specified by:

addGroupPropertyDescriptorsChangedListener in interface GroupDataGridItems<T>

Parameters:

listener - the listener to add

Returns:

a registration object for removing the listener

getGroupByItem

@Nullable
public GroupInfo getGroupByItem(T groupItem)

Description copied from interface: GroupDataGridItems

Returns GroupInfo by a group item.

Group item is an empty entity object that represents a grouping row in a GroupListDataComponent. It does not exist in the data container.

Specified by:

getGroupByItem in interface GroupDataGridItems<T>

Parameters:

groupItem - a group item

Returns:

group info or null if there is no group info for the given item

getItemByGroup

@Nullable
public T getItemByGroup(GroupInfo group)

Description copied from interface: GroupDataGridItems

Returns a group item that corresponds to the provided GroupInfo.

Group item is an empty entity object that represents a grouping row in a GroupListDataComponent. It does not exist in the data container.

Specified by:

getItemByGroup in interface GroupDataGridItems<T>

Parameters:

group - group info

Returns:

group item or null if there is no item for the given group info

getChildCount

public int getChildCount(com.vaadin.flow.data.provider.hierarchy.HierarchicalQuery<T,Void> query)

Specified by:

getChildCount in interface com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider<T,Void>

fetchChildren

public Stream<T> fetchChildren(com.vaadin.flow.data.provider.hierarchy.HierarchicalQuery<T,Void> query)

Specified by:

fetchChildren in interface com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider<T,Void>

hasChildren

public boolean hasChildren(T item)

Specified by:

hasChildren in interface com.vaadin.flow.data.provider.hierarchy.HierarchicalDataProvider<T,Void>