Package org.apache.commons.collections.bag

Class TreeBag

java.lang.Object

org.apache.commons.collections.bag.AbstractMapBag

org.apache.commons.collections.bag.TreeBag

All Implemented Interfaces:

Serializable, Iterable, Collection, Bag, SortedBag

@Deprecated(since="2021-04-30")
public class TreeBag
extends AbstractMapBag
implements SortedBag, Serializable

Deprecated.

Apache Commons Collections version 3.x is being deprecated from AEMaaCS. The upgraded version 4.4 of Commons Collections is already included as replacement. Customers are advised to upgrade to this version of the library. Please note: the package name was changed to org.apache.commons.collections4. Further note that there are AEM APIs currently exposing the old collections classes; these will be updated in upcoming releases.

Implements SortedBag, using a TreeMap to provide the data storage. This is the standard implementation of a sorted bag.

Order will be maintained among the bag members and can be viewed through the iterator.

A Bag stores each object in the collection together with a count of occurrences. Extra methods on the interface allow multiple copies of an object to be added or removed at once. It is important to read the interface javadoc carefully as several methods violate the Collection interface specification.

Since:

Commons Collections 3.0 (previously in main package v2.0)

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TreeBag()	Deprecated. Constructs an empty TreeBag.
TreeBag(Collection coll)	Deprecated. Constructs a TreeBag containing all the members of the specified collection.
TreeBag(Comparator comparator)	Deprecated. Constructs an empty bag that maintains order on its unique representative members according to the given Comparator.

Method Summary

Modifier and Type	Method	Description
Comparator	comparator()	Deprecated. Returns the comparator associated with this sorted set, or null if it uses its elements' natural ordering.
Object	first()	Deprecated. Returns the first (lowest) member.
Object	last()	Deprecated. Returns the last (highest) member.

Methods inherited from class org.apache.commons.collections.bag.AbstractMapBag

add, add, addAll, clear, contains, containsAll, equals, getCount, hashCode, isEmpty, iterator, remove, remove, removeAll, retainAll, size, toArray, toArray, toString, uniqueSet

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.commons.collections.Bag

add, add, containsAll, getCount, iterator, remove, remove, removeAll, retainAll, size, uniqueSet

Methods inherited from interface java.util.Collection

addAll, clear, contains, equals, hashCode, isEmpty, parallelStream, removeIf, spliterator, stream, toArray, toArray, toArray

Methods inherited from interface java.lang.Iterable

forEach

Constructor Details

TreeBag

public TreeBag()

Deprecated.

Constructs an empty TreeBag.

TreeBag

public TreeBag(Comparator comparator)

Deprecated.

Constructs an empty bag that maintains order on its unique representative members according to the given Comparator.

Parameters:

comparator - the comparator to use

TreeBag

public TreeBag(Collection coll)

Deprecated.

Constructs a TreeBag containing all the members of the specified collection.

Parameters:

coll - the collection to copy into the bag

Method Details

first

public Object first()

Deprecated.

Description copied from interface: SortedBag

Returns the first (lowest) member.

Specified by:

first in interface SortedBag

Returns:

the first element in the sorted bag

last

public Object last()

Deprecated.

Description copied from interface: SortedBag

Returns the last (highest) member.

Specified by:

last in interface SortedBag

Returns:

the last element in the sorted bag

comparator

public Comparator comparator()

Deprecated.

Description copied from interface: SortedBag

Returns the comparator associated with this sorted set, or null if it uses its elements' natural ordering.

Specified by:

comparator in interface SortedBag

Returns:

the comparator in use, or null if natural ordering