Antes do Java SE 8, a maioria das implementações de Collection.removeAll(Collection) e
retainAll(Collection) retorna false e ignora silenciosamente um parâmetro nulo se a coleção
em si estava vazia. No Java 8, todas as implementações de coleção lançam um
NullPointerException se null for fornecido como um parâmetro.
Para identificar onde essas exceções podem ocorrer, essa regra sinaliza a chamada dos
métodos removeAll(Collection) e retainAll(Collection)
nas implementações e interfaces a seguir para que seja
possível avaliar sua lógica para evitar um NullPointerException inesperado.
- java.util.ArrayDeque
- java.util.ArrayList
- java.util.Collection
- java.util.Deque
- java.util.EnumSet
- java.util.LinkedList
- java.util.List
- java.util.NavigableSet
- java.util.PriorityQueue
- java.util.PriorityQueue
- java.util.Queue
- java.util.Set
- java.util.SortedSet
- java.util.Stack
- java.util.Vector
- java.util.concurrent.ArrayBlockingQueue
- java.util.concurrent.BlockingDeque
- java.util.concurrent.BlockingQueue
- java.util.concurrent.ConcurrentLinkedDeque
- java.util.concurrent.ConcurrentLinkedQueue
- java.util.concurrent.CopyOnWriteArrayList
- java.util.concurrent.CopyOnWriteArraySet
- java.util.concurrent.DelayQueue
- java.util.concurrent.LinkedBlockingDeque
- java.util.concurrent.LinkedBlockingQueue
- java.util.concurrent.LinkedTransferQueue
- java.util.concurrent.PriorityBlockingQueue
- java.util.concurrent.TransferQueue
- javax.management.AttributeList
- javax.management.relation.RoleList
- javax.management.relation.RoleList
- javax.management.relation.RoleUnresolvedList
O método retainAll(Collection)
é sinalizado para as implementações a seguir. Para elas, o método removeAll(Collection)
já lança um NullPointerExceptions no Java 6 e Java 7.
- java.util.concurrent.ConcurrentSkipListSet
- java.util.HashSet
- java.util.LinkedHashSet
- java.util.TreeSet
- javax.print.attribute.standard.JobStateReasons
O Java 8 não introduz uma mudança de comportamento para as implementações de coleção a seguir,
portanto, elas não são sinalizadas por essa regra:
- java.beans.beancontext.BeanContextServicesSupport - continua a lançar
UnsupportedOperationException
- java.beans.beancontext.BeanContextSupport - continua a lançar
UnsupportedOperationException
- java.util.concurrent.SynchronousQueue - continua a ter o comportamento do Java 7 e não lança um
NullPointerException
Para obter informações adicionais sobre a interface java.util.Collection e suas implementações,
consulte a documentação Java
Interface java.util.Collection.