Class UnmodifiableList<E>

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Iterable<E>, java.util.Collection<E>, java.util.List<E>, Unmodifiable

    public final class UnmodifiableList<E>
    extends AbstractSerializableListDecorator<E>
    implements Unmodifiable
    Decorates another List to ensure it can't be altered.

    This class is Serializable from Commons Collections 3.1.

    Attempts to modify it will result in an UnsupportedOperationException.

    Since:
    3.0
    See Also:
    Serialized Form
    • Constructor Summary

      Constructors 
      Constructor Description
      UnmodifiableList​(java.util.List<? extends E> list)
      Constructor that wraps (not copies).
    • Constructor Detail

      • UnmodifiableList

        public UnmodifiableList​(java.util.List<? extends E> list)
        Constructor that wraps (not copies).
        Parameters:
        list - the list to decorate, must not be null
        Throws:
        java.lang.NullPointerException - if list is null
    • Method Detail

      • unmodifiableList

        public static <E> java.util.List<E> unmodifiableList​(java.util.List<? extends E> list)
        Factory method to create an unmodifiable list.
        Type Parameters:
        E - the type of the elements in the list
        Parameters:
        list - the list to decorate, must not be null
        Returns:
        a new unmodifiable list
        Throws:
        java.lang.NullPointerException - if list is null
        Since:
        4.0
      • iterator

        public java.util.Iterator<E> iterator()
        Specified by:
        iterator in interface java.util.Collection<E>
        Specified by:
        iterator in interface java.lang.Iterable<E>
        Specified by:
        iterator in interface java.util.List<E>
        Overrides:
        iterator in class AbstractCollectionDecorator<E>
      • add

        public boolean add​(java.lang.Object object)
        Specified by:
        add in interface java.util.Collection<E>
        Specified by:
        add in interface java.util.List<E>
        Overrides:
        add in class AbstractCollectionDecorator<E>
      • addAll

        public boolean addAll​(java.util.Collection<? extends E> coll)
        Specified by:
        addAll in interface java.util.Collection<E>
        Specified by:
        addAll in interface java.util.List<E>
        Overrides:
        addAll in class AbstractCollectionDecorator<E>
      • clear

        public void clear()
        Specified by:
        clear in interface java.util.Collection<E>
        Specified by:
        clear in interface java.util.List<E>
        Overrides:
        clear in class AbstractCollectionDecorator<E>
      • remove

        public boolean remove​(java.lang.Object object)
        Specified by:
        remove in interface java.util.Collection<E>
        Specified by:
        remove in interface java.util.List<E>
        Overrides:
        remove in class AbstractCollectionDecorator<E>
      • removeIf

        public boolean removeIf​(java.util.function.Predicate<? super E> filter)
        Specified by:
        removeIf in interface java.util.Collection<E>
        Overrides:
        removeIf in class AbstractCollectionDecorator<E>
        Since:
        4.4
      • removeAll

        public boolean removeAll​(java.util.Collection<?> coll)
        Specified by:
        removeAll in interface java.util.Collection<E>
        Specified by:
        removeAll in interface java.util.List<E>
        Overrides:
        removeAll in class AbstractCollectionDecorator<E>
      • retainAll

        public boolean retainAll​(java.util.Collection<?> coll)
        Specified by:
        retainAll in interface java.util.Collection<E>
        Specified by:
        retainAll in interface java.util.List<E>
        Overrides:
        retainAll in class AbstractCollectionDecorator<E>
      • listIterator

        public java.util.ListIterator<E> listIterator()
        Specified by:
        listIterator in interface java.util.List<E>
        Overrides:
        listIterator in class AbstractListDecorator<E>
      • listIterator

        public java.util.ListIterator<E> listIterator​(int index)
        Specified by:
        listIterator in interface java.util.List<E>
        Overrides:
        listIterator in class AbstractListDecorator<E>
      • add

        public void add​(int index,
                        E object)
        Specified by:
        add in interface java.util.List<E>
        Overrides:
        add in class AbstractListDecorator<E>
      • addAll

        public boolean addAll​(int index,
                              java.util.Collection<? extends E> coll)
        Specified by:
        addAll in interface java.util.List<E>
        Overrides:
        addAll in class AbstractListDecorator<E>
      • set

        public E set​(int index,
                     E object)
        Specified by:
        set in interface java.util.List<E>
        Overrides:
        set in class AbstractListDecorator<E>
      • subList

        public java.util.List<E> subList​(int fromIndex,
                                         int toIndex)
        Specified by:
        subList in interface java.util.List<E>
        Overrides:
        subList in class AbstractListDecorator<E>