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]