com.google.common.collect

Class ImmutableSortedSetFauxverideShim<E>

java.lang.Object

java.util.AbstractCollection<E>

com.google.common.collect.ImmutableCollection<E>

com.google.common.collect.ImmutableSet<E>

com.google.common.collect.ImmutableSortedSetFauxverideShim<E>

All Implemented Interfaces:

java.io.Serializable, java.lang.Iterable<E>, java.util.Collection<E>, java.util.Set<E>

Direct Known Subclasses:

ImmutableSortedSet

@GwtIncompatible
abstract class ImmutableSortedSetFauxverideShim<E>
extends ImmutableSet<E>

"Overrides" the ImmutableSet static methods that lack ImmutableSortedSet equivalents with deprecated, exception-throwing versions. This prevents accidents like the following:

   

   List<Object> objects = ...;
   // Sort them:
   Set<Object> sorted = ImmutableSortedSet.copyOf(objects);
   // BAD CODE! The returned set is actually an unsorted ImmutableSet!

While we could put the overrides in ImmutableSortedSet itself, it seems clearer to separate these "do not call" methods from those intended for normal use.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.common.collect.ImmutableSet

ImmutableSet.Builder<E>, ImmutableSet.Indexed<E>

Nested classes/interfaces inherited from class com.google.common.collect.ImmutableCollection

ImmutableCollection.ArrayBasedBuilder<E>

Field Summary

Fields inherited from class com.google.common.collect.ImmutableSet

MAX_TABLE_SIZE

Constructor Summary

Constructors

Constructor and Description
ImmutableSortedSetFauxverideShim()

Method Summary

Modifier and Type	Method and Description
static <E> ImmutableSortedSet.Builder<E>	builder() Deprecated. Use ImmutableSortedSet.naturalOrder(), which offers better type-safety.
static <E> ImmutableSortedSet<E>	copyOf(E[] elements) Deprecated. Pass parameters of type Comparable to use ImmutableSortedSet.copyOf(Comparable[]).
static <E> ImmutableSortedSet<E>	of(E element) Deprecated. Pass a parameter of type Comparable to use ImmutableSortedSet.of(Comparable).
static <E> ImmutableSortedSet<E>	of(E e1, E e2) Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable).
static <E> ImmutableSortedSet<E>	of(E e1, E e2, E e3) Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable).
static <E> ImmutableSortedSet<E>	of(E e1, E e2, E e3, E e4) Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable).
static <E> ImmutableSortedSet<E>	of(E e1, E e2, E e3, E e4, E e5) Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of( Comparable, Comparable, Comparable, Comparable, Comparable).
static <E> ImmutableSortedSet<E>	of(E e1, E e2, E e3, E e4, E e5, E e6, E... remaining) Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable, Comparable, Comparable, Comparable...).

Methods inherited from class com.google.common.collect.ImmutableSet

asList, chooseTableSize, copyOf, copyOf, copyOf, createAsList, equals, hashCode, isHashCodeFast, iterator, of, writeReplace

Methods inherited from class com.google.common.collect.ImmutableCollection

add, addAll, clear, contains, copyIntoArray, isPartialView, remove, removeAll, retainAll, toArray, toArray

Methods inherited from class java.util.AbstractCollection

containsAll, isEmpty, size, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Set

add, addAll, clear, contains, containsAll, isEmpty, remove, removeAll, retainAll, size, spliterator, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

ImmutableSortedSetFauxverideShim

ImmutableSortedSetFauxverideShim()

Method Detail

builder

@Deprecated
public static <E> ImmutableSortedSet.Builder<E> builder()

Deprecated. Use ImmutableSortedSet.naturalOrder(), which offers better type-safety.

Not supported. Use ImmutableSortedSet.naturalOrder(), which offers better type-safety, instead. This method exists only to hide ImmutableSet.builder() from consumers of ImmutableSortedSet.

Throws:

java.lang.UnsupportedOperationException - always

of

@Deprecated
public static <E> ImmutableSortedSet<E> of(E element)

Deprecated. Pass a parameter of type Comparable to use ImmutableSortedSet.of(Comparable).

Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.

Throws:

java.lang.UnsupportedOperationException - always

of

@Deprecated
public static <E> ImmutableSortedSet<E> of(E e1,
                                                       E e2)

Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable).

Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.

Throws:

java.lang.UnsupportedOperationException - always

of

@Deprecated
public static <E> ImmutableSortedSet<E> of(E e1,
                                                       E e2,
                                                       E e3)

Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable).

Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.

Throws:

java.lang.UnsupportedOperationException - always

of

@Deprecated
public static <E> ImmutableSortedSet<E> of(E e1,
                                                       E e2,
                                                       E e3,
                                                       E e4)

Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable).

Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.

Throws:

java.lang.UnsupportedOperationException - always

of

@Deprecated
public static <E> ImmutableSortedSet<E> of(E e1,
                                                       E e2,
                                                       E e3,
                                                       E e4,
                                                       E e5)

Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of( Comparable, Comparable, Comparable, Comparable, Comparable).

Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.

Throws:

java.lang.UnsupportedOperationException - always

of

@Deprecated
public static <E> ImmutableSortedSet<E> of(E e1,
                                                       E e2,
                                                       E e3,
                                                       E e4,
                                                       E e5,
                                                       E e6,
                                                       E... remaining)

Deprecated. Pass the parameters of type Comparable to use ImmutableSortedSet.of(Comparable, Comparable, Comparable, Comparable, Comparable, Comparable, Comparable...).

Not supported. You are attempting to create a set that may contain a non-Comparable element. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.

Throws:

java.lang.UnsupportedOperationException - always

copyOf

@Deprecated
public static <E> ImmutableSortedSet<E> copyOf(E[] elements)

Deprecated. Pass parameters of type Comparable to use ImmutableSortedSet.copyOf(Comparable[]).

Not supported. You are attempting to create a set that may contain non-Comparable elements. Proper calls will resolve to the version in ImmutableSortedSet, not this dummy version.

Throws:

java.lang.UnsupportedOperationException - always