Coleções do Apache Commons - Interface do saco

Novas interfaces são adicionadas aos sacos de suporte. Um Bag define uma coleção que conta o número de vezes que um objeto aparece na coleção. Por exemplo, se um Bag contém {a, a, b, c} então getCount ("a") retornará 2 enquanto uniqueSet () retorna os valores únicos.

Declaração de Interface

A seguir está a declaração para a interface org.apache.commons.collections4.Bag <E> -

public interface Bag<E>
   extends Collection<E>

Métodos

Os métodos para inferência de bolsa são os seguintes -

Sr. Não.	Método e Descrição
1	boolean add(E object) (Violação) Adiciona uma cópia do objeto especificado ao Saco.
2	boolean add(E object, int nCopies) Adiciona nCopies cópias do objeto especificado ao Bag.
3	boolean containsAll(Collection<?> coll) (Violação) Retorna verdadeiro se a bolsa contiver todos os elementos da coleção fornecida, respeitando a cardinalidade.
4	int getCount(Object object) Retorna o número de ocorrências (cardinalidade) do objeto fornecido atualmente na bolsa.
5	Iterator<E> iterator() Retorna um Iterator sobre todo o conjunto de membros, incluindo cópias devido à cardinalidade.
6	boolean remove(Object object) (Violação) Remove todas as ocorrências do objeto fornecido da bolsa.
7	boolean remove(Object object, int nCopies) Remove nCopies cópias do objeto especificado do Bag.
8	boolean removeAll(Collection<?> coll) (Violação) Remova todos os elementos representados na coleção em questão, respeitando a cardinalidade.
9	boolean retainAll(Collection<?> coll) (Violação) Retirar quaisquer membros da bolsa que não façam parte do acervo, respeitando a cardinalidade.
10	int size() Retorna o número total de itens na sacola em todos os tipos.
11	Set<E> uniqueSet() Retorna um conjunto de elementos exclusivos na bolsa.

Métodos herdados

Esta interface herda métodos da seguinte interface -

• java.util.Collection

Exemplo de interface de bolsa

Um exemplo de BagTester.java é o seguinte -

import org.apache.commons.collections4.Bag;
import org.apache.commons.collections4.bag.HashBag;
public class BagTester {
   public static void main(String[] args) {
      Bag<String> bag = new HashBag<>();
      //add "a" two times to the bag.
      bag.add("a" , 2);
      //add "b" one time to the bag.
      bag.add("b");
      //add "c" one time to the bag.
      bag.add("c");
      //add "d" three times to the bag.
      bag.add("d",3
      //get the count of "d" present in bag.
      System.out.println("d is present " + bag.getCount("d") + " times.");
      System.out.println("bag: " +bag);
      //get the set of unique values from the bag
      System.out.println("Unique Set: " +bag.uniqueSet());
      //remove 2 occurrences of "d" from the bag
      bag.remove("d",2);
      System.out.println("2 occurences of d removed from bag: " +bag);
      System.out.println("d is present " + bag.getCount("d") + " times.");
      System.out.println("bag: " +bag);
      System.out.println("Unique Set: " +bag.uniqueSet());
   }
}

Resultado

Você verá a seguinte saída -

d is present 3 times.
bag: [2:a,1:b,1:c,3:d]
Unique Set: [a, b, c, d]
2 occurences of d removed from bag: [2:a,1:b,1:c,1:d]
d is present 1 times.
bag: [2:a,1:b,1:c,1:d]
Unique Set: [a, b, c, d]