de.hybris.platform.order

Interface EntryGroupService

All Known Implementing Classes:

DefaultEntryGroupService

public interface EntryGroupService

Service that exposes methods to deal with EntryGroup operations.

Method Summary

Modifier and Type	Method and Description
int	findMaxGroupNumber(java.util.List<EntryGroup> roots) Searches for maximum value of EntryGroup.getGroupNumber().
void	forceOrderSaving(AbstractOrderModel order) As EntryGroup is not a DB entity, changing it does not cause parent order to save.
EntryGroup	getGroup(AbstractOrderModel order, java.lang.Integer groupNumber) Returns EntryGroup by groupNumber
EntryGroup	getGroupOfType(AbstractOrderModel order, java.util.Collection<java.lang.Integer> groupNumbers, GroupType type) Find entry group in the cart by number and type.
java.util.List<EntryGroup>	getLeaves(EntryGroup entryGroup) Returns all leaf EntryGroups of given one.
java.util.List<EntryGroup>	getNestedGroups(EntryGroup entryGroup) Gets all nested EntryGroups of given one, including the given one.
EntryGroup	getParent(AbstractOrderModel order, java.lang.Integer groupNumber) Returns parent entry group of the tree within the order's entry group trees which has given group.
EntryGroup	getRoot(AbstractOrderModel order, java.lang.Integer groupNumber) Returns root of the tree within the order's entry group trees which has given group.

Method Detail

getNestedGroups

java.util.List<EntryGroup> getNestedGroups(EntryGroup entryGroup)

Gets all nested EntryGroups of given one, including the given one.

Parameters:

entryGroup - root EntryGroup

Returns:

all EntryGroups for subtree where the given EntryGroup is root, including the root

getLeaves

java.util.List<EntryGroup> getLeaves(EntryGroup entryGroup)

Returns all leaf EntryGroups of given one. If that one is already leaf it will return itself.

Parameters:

entryGroup - root EntryGroup

Returns:

all leaf EntryGroups for subtree where the given EntryGroup is root or given EntryGroup if it is a leaf.

getGroup

EntryGroup getGroup(AbstractOrderModel order,
                    java.lang.Integer groupNumber)

Returns EntryGroup by groupNumber

Parameters:

groupNumber - number of the group to search for

order - order containing entry group trees

Returns:

EntryGroup with given groupNumber from the order

Throws:

java.lang.IllegalArgumentException - if no group with given groupNumber in the order

getRoot

EntryGroup getRoot(AbstractOrderModel order,
                   java.lang.Integer groupNumber)

Returns root of the tree within the order's entry group trees which has given group.

Parameters:

order - order to take trees from

groupNumber - number of group to search for

Returns:

root of the tree that contains groupNumber

Throws:

java.lang.IllegalArgumentException - if group is not found

getParent

EntryGroup getParent(AbstractOrderModel order,
                     java.lang.Integer groupNumber)

Returns parent entry group of the tree within the order's entry group trees which has given group.

Parameters:

order - order to take trees from

groupNumber - number of group to search for

Returns:

parent of the groupNumber or null if it is root

Throws:

java.lang.IllegalArgumentException - if group is not found in the cart

forceOrderSaving

void forceOrderSaving(AbstractOrderModel order)

As EntryGroup is not a DB entity, changing it does not cause parent order to save. This method updates the whole entryGroups field, so the order is marked as changes and correctly saved to DB.

Parameters:

order - order to save

findMaxGroupNumber

int findMaxGroupNumber(java.util.List<EntryGroup> roots)

Searches for maximum value of EntryGroup.getGroupNumber(). Is useful for assigning unique values to entry group numbers.

Parameters:

roots - list of root groups

Returns:

maximum value of groupNumber field

getGroupOfType

EntryGroup getGroupOfType(AbstractOrderModel order,
                          java.util.Collection<java.lang.Integer> groupNumbers,
                          GroupType type)

Find entry group in the cart by number and type.

Parameters:

order - user's cart

groupNumbers - group numbers of the entry

type - group type

Returns:

EntryGroup object or null if no groups of given type in collection

Throws:

AmbiguousIdentifierException - if more than one EntryGroup with provided group type was found