Class FilteringCollection

FilteringCollection is an extension of Collection which provides possibilities to

  • _filter_the elements to return a new FilteringCollectionwith a filtered set of elements
  • _sort_the elements to return a new FilteringCollectionwith a defined sort order
  • _transform_the elements to return a new FilteringCollectioncontaining related elements
  • _provide a map_of the elements against a predefined key

Usage - In the current version each FilteringCollection provides a set of predefined qualifier constants which can be passed into the select(Object) method used to filter the elements. Generally qualifiers have the prefix QUALIFIER_. A second method sort(Object) is used to create a new instance with a different element ordering, which takes an orderB< constant. Generally orderBys have the prefix ORDERBY_: examples are ShippingOrder.ORDERBY_ITEMID, ShippingOrder.ORDERBY_ITEMPOSITION, and ORDERBY_REVERSE can be used to provide a FilteringCollection with the reverse ordering. An example with method ShippingOrder.getItems():

`

var allItems : FilteringCollection = shippingOrder.items;

var productItems : FilteringCollection = allItems.select(ShippingOrder.QUALIFIER_PRODUCTITEMS);

var serviceItems : FilteringCollection = allItems.select(ShippingOrder.QUALIFIER_SERVICEITEMS);

var byPosition : FilteringCollection = productItems.sort(ShippingOrder.ORDERBY_ITEMPOSITION);

var revByPosition: FilteringCollection = byPosition.sort(FilteringCollection.ORDERBY_REVERSE);

var mapByItemID : Map = allItems.asMap(); `

ConstantDescription
ORDERBY_REVERSE: ObjectPass this orderBy with the sort(Object) method to obtain a new FilteringCollection with the reversed sort order.

This class does not have a constructor, so you cannot create it directly.

MethodDescription
asMap()Returns a Map containing the elements of this FilteringCollection against a predefined key.
select(Object)Select a new FilteringCollection instance by passing a predefined qualifier as an argument to this method.
sort(Object)Select a new FilteringCollection instance by passing a predefined orderBy as an argument to this method.

add, add1, addAll, clear, contains, containsAll, getLength, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

ORDERBY_REVERSE: Object

Pass this orderBy with the sort(Object) method to obtain a new FilteringCollection with the reversed sort order. Only use on a FilteringCollection which has been previously sorted.


asMap(): Map

Returns a Map containing the elements of this FilteringCollection against a predefined key. The key used is documented in the method returning the FilteringCollection and is typically the ItemID assigned to an element in the collection.

Returns:


select(qualifier: Object): FilteringCollection

Select a new FilteringCollection instance by passing a predefined qualifier as an argument to this method. See FilteringCollection.

Parameters:

  • qualifier - possible qualifiers are documented in the method returning the FilteringCollection

Returns:


sort(orderBy: Object): FilteringCollection

Select a new FilteringCollection instance by passing a predefined orderBy as an argument to this method. See FilteringCollection.

Parameters:

Returns: