Package 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

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>

Field Summary

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

HASH_FLOODING_FPP, MAX_RUN_MULTIPLIER, MAX_TABLE_SIZE, SPLITERATOR_CHARACTERISTICS

Constructor Summary

Constructors

Constructor	Description
ImmutableSortedSetFauxverideShim()

Method Summary

Modifier and Type	Method	Description
static <E> ImmutableSortedSet.Builder<E>	builder()	Deprecated. Use ImmutableSortedSet.naturalOrder(), which offers better type-safety.
static <E> ImmutableSortedSet.Builder<E>	builderWithExpectedSize(int expectedSize)	Deprecated. Not supported by ImmutableSortedSet.
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...).
static <E> java.util.stream.Collector<E,?,ImmutableSet<E>>	toImmutableSet()	Deprecated. Use ImmutableSortedSet.toImmutableSortedSet(java.util.Comparator<? super E>).

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

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

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

add, addAll, clear, contains, copyIntoArray, internalArray, internalArrayEnd, internalArrayStart, isPartialView, remove, removeAll, removeIf, retainAll, spliterator, 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.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.Set

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

Constructor Detail

ImmutableSortedSetFauxverideShim

ImmutableSortedSetFauxverideShim()

Method Detail

toImmutableSet

@Deprecated
public static <E> java.util.stream.Collector<E,?,ImmutableSet<E>> toImmutableSet()

Deprecated.

Use ImmutableSortedSet.toImmutableSortedSet(java.util.Comparator<? super E>).

Not supported. Use ImmutableSortedSet.toImmutableSortedSet(java.util.Comparator<? super E>) instead. This method exists only to hide ImmutableSet.toImmutableSet() from consumers of ImmutableSortedSet.

Throws:

java.lang.UnsupportedOperationException - always

Since:

21.0

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

builderWithExpectedSize

@Deprecated
public static <E> ImmutableSortedSet.Builder<E> builderWithExpectedSize(int expectedSize)

Deprecated.

Not supported by ImmutableSortedSet.

Not supported. This method exists only to hide ImmutableSet.builderWithExpectedSize(int) 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