diff options
Diffstat (limited to 'guava/src/com/google/common/collect/ImmutableSortedSetFauxverideShim.java')
| -rw-r--r-- | guava/src/com/google/common/collect/ImmutableSortedSetFauxverideShim.java | 208 |
1 files changed, 0 insertions, 208 deletions
diff --git a/guava/src/com/google/common/collect/ImmutableSortedSetFauxverideShim.java b/guava/src/com/google/common/collect/ImmutableSortedSetFauxverideShim.java deleted file mode 100644 index ff3ac12d5..000000000 --- a/guava/src/com/google/common/collect/ImmutableSortedSetFauxverideShim.java +++ /dev/null @@ -1,208 +0,0 @@ -/* - * Copyright (C) 2009 The Guava Authors - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package com.google.common.collect; - -import com.google.common.annotations.GwtIncompatible; -import com.google.errorprone.annotations.DoNotCall; -import java.util.stream.Collector; - -/** - * "Overrides" the {@link ImmutableSet} static methods that lack {@link ImmutableSortedSet} - * equivalents with deprecated, exception-throwing versions. This prevents accidents like the - * following: - * - * <pre>{@code - * List<Object> objects = ...; - * // Sort them: - * Set<Object> sorted = ImmutableSortedSet.copyOf(objects); - * // BAD CODE! The returned set is actually an unsorted ImmutableSet! - * }</pre> - * - * <p>While we could put the overrides in {@link ImmutableSortedSet} itself, it seems clearer to - * separate these "do not call" methods from those intended for normal use. - * - * @author Chris Povirk - */ -@GwtIncompatible -@ElementTypesAreNonnullByDefault -abstract class ImmutableSortedSetFauxverideShim<E> extends ImmutableSet.CachingAsList<E> { - /** - * Not supported. Use {@link ImmutableSortedSet#toImmutableSortedSet} instead. This method exists - * only to hide {@link ImmutableSet#toImmutableSet} from consumers of {@code ImmutableSortedSet}. - * - * @throws UnsupportedOperationException always - * @deprecated Use {@link ImmutableSortedSet#toImmutableSortedSet}. - * @since 21.0 - */ - @DoNotCall("Use toImmutableSortedSet") - @Deprecated - public static <E> Collector<E, ?, ImmutableSet<E>> toImmutableSet() { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. Use {@link ImmutableSortedSet#naturalOrder}, which offers better type-safety, - * instead. This method exists only to hide {@link ImmutableSet#builder} from consumers of {@code - * ImmutableSortedSet}. - * - * @throws UnsupportedOperationException always - * @deprecated Use {@link ImmutableSortedSet#naturalOrder}, which offers better type-safety. - */ - @DoNotCall("Use naturalOrder") - @Deprecated - public static <E> ImmutableSortedSet.Builder<E> builder() { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. This method exists only to hide {@link ImmutableSet#builderWithExpectedSize} - * from consumers of {@code ImmutableSortedSet}. - * - * @throws UnsupportedOperationException always - * @deprecated Not supported by ImmutableSortedSet. - */ - @DoNotCall("Use naturalOrder (which does not accept an expected size)") - @Deprecated - public static <E> ImmutableSortedSet.Builder<E> builderWithExpectedSize(int expectedSize) { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. <b>You are attempting to create a set that may contain a non-{@code Comparable} - * element.</b> Proper calls will resolve to the version in {@code ImmutableSortedSet}, not this - * dummy version. - * - * @throws UnsupportedOperationException always - * @deprecated <b>Pass a parameter of type {@code Comparable} to use {@link - * ImmutableSortedSet#of(Comparable)}.</b> - */ - @DoNotCall("Pass a parameter of type Comparable") - @Deprecated - public static <E> ImmutableSortedSet<E> of(E element) { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. <b>You are attempting to create a set that may contain a non-{@code Comparable} - * element.</b> Proper calls will resolve to the version in {@code ImmutableSortedSet}, not this - * dummy version. - * - * @throws UnsupportedOperationException always - * @deprecated <b>Pass the parameters of type {@code Comparable} to use {@link - * ImmutableSortedSet#of(Comparable, Comparable)}.</b> - */ - @DoNotCall("Pass parameters of type Comparable") - @Deprecated - public static <E> ImmutableSortedSet<E> of(E e1, E e2) { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. <b>You are attempting to create a set that may contain a non-{@code Comparable} - * element.</b> Proper calls will resolve to the version in {@code ImmutableSortedSet}, not this - * dummy version. - * - * @throws UnsupportedOperationException always - * @deprecated <b>Pass the parameters of type {@code Comparable} to use {@link - * ImmutableSortedSet#of(Comparable, Comparable, Comparable)}.</b> - */ - @DoNotCall("Pass parameters of type Comparable") - @Deprecated - public static <E> ImmutableSortedSet<E> of(E e1, E e2, E e3) { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. <b>You are attempting to create a set that may contain a non-{@code Comparable} - * element.</b> Proper calls will resolve to the version in {@code ImmutableSortedSet}, not this - * dummy version. - * - * @throws UnsupportedOperationException always - * @deprecated <b>Pass the parameters of type {@code Comparable} to use {@link - * ImmutableSortedSet#of(Comparable, Comparable, Comparable, Comparable)}. </b> - */ - @DoNotCall("Pass parameters of type Comparable") - @Deprecated - public static <E> ImmutableSortedSet<E> of(E e1, E e2, E e3, E e4) { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. <b>You are attempting to create a set that may contain a non-{@code Comparable} - * element.</b> Proper calls will resolve to the version in {@code ImmutableSortedSet}, not this - * dummy version. - * - * @throws UnsupportedOperationException always - * @deprecated <b>Pass the parameters of type {@code Comparable} to use {@link - * ImmutableSortedSet#of( Comparable, Comparable, Comparable, Comparable, Comparable)}. </b> - */ - @DoNotCall("Pass parameters of type Comparable") - @Deprecated - public static <E> ImmutableSortedSet<E> of(E e1, E e2, E e3, E e4, E e5) { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. <b>You are attempting to create a set that may contain a non-{@code Comparable} - * element.</b> Proper calls will resolve to the version in {@code ImmutableSortedSet}, not this - * dummy version. - * - * @throws UnsupportedOperationException always - * @deprecated <b>Pass the parameters of type {@code Comparable} to use {@link - * ImmutableSortedSet#of(Comparable, Comparable, Comparable, Comparable, Comparable, - * Comparable, Comparable...)}. </b> - */ - @DoNotCall("Pass parameters of type Comparable") - @Deprecated - public static <E> ImmutableSortedSet<E> of(E e1, E e2, E e3, E e4, E e5, E e6, E... remaining) { - throw new UnsupportedOperationException(); - } - - /** - * Not supported. <b>You are attempting to create a set that may contain non-{@code Comparable} - * elements.</b> Proper calls will resolve to the version in {@code ImmutableSortedSet}, not this - * dummy version. - * - * @throws UnsupportedOperationException always - * @deprecated <b>Pass parameters of type {@code Comparable} to use {@link - * ImmutableSortedSet#copyOf(Comparable[])}.</b> - */ - @DoNotCall("Pass parameters of type Comparable") - @Deprecated - public static <E> ImmutableSortedSet<E> copyOf(E[] elements) { - throw new UnsupportedOperationException(); - } - - /* - * We would like to include an unsupported "<E> copyOf(Iterable<E>)" here, - * providing only the properly typed - * "<E extends Comparable<E>> copyOf(Iterable<E>)" in ImmutableSortedSet (and - * likewise for the Iterator equivalent). However, due to a change in Sun's - * interpretation of the JLS (as described at - * http://bugs.sun.com/view_bug.do?bug_id=6182950), the OpenJDK 7 compiler - * available as of this writing rejects our attempts. To maintain - * compatibility with that version and with any other compilers that interpret - * the JLS similarly, there is no definition of copyOf() here, and the - * definition in ImmutableSortedSet matches that in ImmutableSet. - * - * The result is that ImmutableSortedSet.copyOf() may be called on - * non-Comparable elements. We have not discovered a better solution. In - * retrospect, the static factory methods should have gone in a separate class - * so that ImmutableSortedSet wouldn't "inherit" too-permissive factory - * methods from ImmutableSet. - */ -} |