Deprecated List (Guava: Google Core Libraries for Java 25.0-jre API)

Deprecated Interfaces
Interface and Description
com.google.common.util.concurrent.CheckedFuture `CheckedFuture` cannot properly support the chained operations that are the primary goal of `ListenableFuture`. `CheckedFuture` also encourages users to rethrow exceptions from one thread in another thread, producing misleading stack traces. Additionally, it has a surprising policy about which exceptions to map and which to leave untouched. Guava users who want a `CheckedFuture` can fork the classes for their own use, possibly specializing them to the particular exception type they use. We recommend that most people use `ListenableFuture` and perform any exception wrapping themselves. This class is scheduled for removal from Guava in February 2018.

Deprecated Classes
Class and Description
com.google.common.util.concurrent.AbstractCheckedFuture `CheckedFuture` cannot properly support the chained operations that are the primary goal of `ListenableFuture`. `CheckedFuture` also encourages users to rethrow exceptions from one thread in another thread, producing misleading stack traces. Additionally, it has a surprising policy about which exceptions to map and which to leave untouched. Guava users who want a `CheckedFuture` can fork the classes for their own use, possibly specializing them to the particular exception type they use. We recommend that most people use `ListenableFuture` and perform any exception wrapping themselves. This class is scheduled for removal from Guava in February 2018.
com.google.common.collect.ForwardingBlockingDeque This class has moved to `com.google.common.util.concurrent`. Please use `ForwardingBlockingDeque` instead.
com.google.common.util.concurrent.ForwardingCheckedFuture `CheckedFuture` cannot properly support the chained operations that are the primary goal of `ListenableFuture`. `CheckedFuture` also encourages users to rethrow exceptions from one thread in another thread, producing misleading stack traces. Additionally, it has a surprising policy about which exceptions to map and which to leave untouched. Guava users who want a `CheckedFuture` can fork the classes for their own use, possibly specializing them to the particular exception type they use. We recommend that most people use `ListenableFuture` and perform any exception wrapping themselves. This class is scheduled for removal from Guava in February 2018.
com.google.common.util.concurrent.ForwardingCheckedFuture.SimpleForwardingCheckedFuture `CheckedFuture` cannot properly support the chained operations that are the primary goal of `ListenableFuture`. `CheckedFuture` also encourages users to rethrow exceptions from one thread in another thread, producing misleading stack traces. Additionally, it has a surprising policy about which exceptions to map and which to leave untouched. Guava users who want a `CheckedFuture` can fork the classes for their own use, possibly specializing them to the particular exception type they use. We recommend that most people use `ListenableFuture` and perform any exception wrapping themselves. This class is scheduled for removal from Guava in February 2018.
com.google.common.collect.TreeTraverser Use `Traverser` instead. All instance methods have their equivalent on the result of `Traverser.forTree(tree)` where `tree` implements `SuccessorsFunction`, which has a similar API as `TreeTraverser.children(T)` or can be the same lambda function as passed into `TreeTraverser.using(Function)`. This class is scheduled to be removed in July 2018.

Deprecated Fields
Field and Description
com.google.common.base.CharMatcher.ANY Use `CharMatcher.any()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.ASCII Use `CharMatcher.ascii()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.BREAKING_WHITESPACE Use `CharMatcher.breakingWhitespace()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.DIGIT Many digits are supplementary characters; see the class documentation. If you need to use this, use `CharMatcher.digit()` instead. This . constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.INVISIBLE Most invisible characters are supplementary characters; see the class documentation. If you need to use this, use `CharMatcher.invisible()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_DIGIT Many digits are supplementary characters; see the class documentation. If you need to use this, use `CharMatcher.javaDigit()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_ISO_CONTROL Use `CharMatcher.javaIsoControl()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_LETTER Most letters are supplementary characters; see the class documentation. If you need to use this, use `CharMatcher.javaLetter()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_LETTER_OR_DIGIT Most letters and digits are supplementary characters; see the class documentation. If you need to use this, use `CharMatcher.javaLetterOrDigit()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_LOWER_CASE Some lowercase letters are supplementary characters; see the class documentation. If you need to use this, use `CharMatcher.javaLowerCase()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_UPPER_CASE Some uppercase letters are supplementary characters; see the class documentation. If you need to use this, use `CharMatcher.javaUpperCase()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.NONE Use `CharMatcher.none()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.SINGLE_WIDTH Many such characters are supplementary characters; see the class documentation. If you need to use this, use `CharMatcher.singleWidth()` instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.WHITESPACE Use `CharMatcher.whitespace()` instead. This constant is scheduled to be removed in June 2018.

Deprecated Methods
Method and Description
com.google.common.collect.UnmodifiableListIterator.add(E) Unsupported operation.
com.google.common.collect.Sets.SetView.add(E) Unsupported operation.
com.google.common.collect.ImmutableCollection.add(E) Unsupported operation.
com.google.common.collect.ImmutableMultiset.add(E, int) Unsupported operation.
com.google.common.collect.ImmutableList.add(int, E) Unsupported operation.
com.google.common.collect.ImmutableRangeSet.add(Range<C>) Unsupported operation.
com.google.common.collect.Sets.SetView.addAll(Collection<? extends E>) Unsupported operation.
com.google.common.collect.ImmutableCollection.addAll(Collection<? extends E>) Unsupported operation.
com.google.common.collect.ImmutableList.addAll(int, Collection<? extends E>) Unsupported operation.
com.google.common.collect.ImmutableRangeSet.addAll(Iterable<Range<C>>) Unsupported operation.
com.google.common.collect.ImmutableRangeSet.addAll(RangeSet<C>) Unsupported operation.
com.google.common.util.concurrent.Futures.addCallback(ListenableFuture<V>, FutureCallback<? super V>) Use the overload that requires an executor. For identical behavior, pass `MoreExecutors.directExecutor()`, but consider whether another executor would be safer, as discussed in the `ListenableFuture.addListener` documentation. This method is scheduled to be removed in July 2018.
com.google.common.io.Files.append(CharSequence, File, Charset) Prefer `asCharSink(to, charset, FileWriteMode.APPEND).write(from)`. This method is scheduled to be removed in January 2019.
com.google.common.base.Converter.apply(A) Provided to satisfy the `Function` interface; use `Converter.convert(A)` instead.
com.google.common.collect.Range.apply(C) Provided only to satisfy the `Predicate` interface; use `Range.contains(C)` instead.
com.google.common.base.CharMatcher.apply(Character) Provided only to satisfy the `Predicate` interface; use `CharMatcher.matches(char)` instead.
com.google.common.cache.LoadingCache.apply(K) Provided to satisfy the `Function` interface; use `LoadingCache.get(K)` or `LoadingCache.getUnchecked(K)` instead.
com.google.common.hash.BloomFilter.apply(T) Provided only to satisfy the `Predicate` interface; use `BloomFilter.mightContain(T)` instead.
com.google.common.collect.Ordering.binarySearch(List<? extends T>, T) Use `Collections.binarySearch(List, Object, Comparator)` directly.
com.google.common.collect.TreeTraverser.breadthFirstTraversal(T) Use `Traverser.breadthFirst(N)` instead, which has the same behavior.
com.google.common.collect.ContiguousSet.builder() Use `ContiguousSet.create(com.google.common.collect.Range<C>, com.google.common.collect.DiscreteDomain<C>)`.
com.google.common.util.concurrent.Futures.FutureCombiner.call(Callable<C>) Use the overload that requires an executor. For identical behavior, pass `MoreExecutors.directExecutor()`, but consider whether another executor would be safer, as discussed in the `ListenableFuture.addListener` documentation. This method is scheduled to be removed in July 2018.
com.google.common.util.concurrent.Futures.FutureCombiner.callAsync(AsyncCallable<C>) Use the overload that requires an executor. For identical behavior, pass `MoreExecutors.directExecutor()`, but consider whether another executor would be safer, as discussed in the `ListenableFuture.addListener` documentation. This method is scheduled to be removed in July 2018.
com.google.common.util.concurrent.Futures.catching(ListenableFuture<? extends V>, Class<X>, Function<? super X, ? extends V>) Use the overload that requires an executor. For identical behavior, pass `MoreExecutors.directExecutor()`, but consider whether another executor would be safer, as discussed in the `ListenableFuture.addListener` documentation. This method is scheduled to be removed in July 2018.
com.google.common.util.concurrent.Futures.catchingAsync(ListenableFuture<? extends V>, Class<X>, AsyncFunction<? super X, ? extends V>) Use the overload that requires an executor. For identical behavior, pass `MoreExecutors.directExecutor()`, but consider whether another executor would be safer, as discussed in the `ListenableFuture.addListener` documentation. This method is scheduled to be removed in July 2018.
com.google.common.collect.ImmutableRangeMap.clear() Unsupported operation.
com.google.common.collect.Sets.SetView.clear() Unsupported operation.
com.google.common.collect.ImmutableMultimap.clear() Unsupported operation.
com.google.common.collect.ArrayTable.clear() Use `ArrayTable.eraseAll()`
com.google.common.collect.ImmutableTable.clear() Unsupported operation.
com.google.common.collect.ImmutableCollection.clear() Unsupported operation.
com.google.common.collect.ImmutableMap.clear() Unsupported operation.
com.google.common.collect.TreeBasedTable.columnComparator() Store the `Comparator` alongside the `Table`. Or, if you know that the `Table` contains at least one value, you can retrieve the `Comparator` with: `((SortedMap<C, V>) table.rowMap().values().iterator().next()).comparator();`.
com.google.common.collect.ComparisonChain.compare(Boolean, Boolean) Use `ComparisonChain.compareFalseFirst(boolean, boolean)`; or, if the parameters passed are being either negated or reversed, undo the negation or reversal and use `ComparisonChain.compareTrueFirst(boolean, boolean)`.
com.google.common.collect.ImmutableMap.compute(K, BiFunction<? super K, ? super V, ? extends V>) Unsupported operation.
com.google.common.collect.ImmutableMap.computeIfAbsent(K, Function<? super K, ? extends V>) Unsupported operation.
com.google.common.collect.ImmutableMap.computeIfPresent(K, BiFunction<? super K, ? super V, ? extends V>) Unsupported operation.
com.google.common.io.Files.copy(File, Charset, Appendable) Prefer `asCharSource(from, charset).copyTo(to)`. This method is scheduled to be removed in January 2019.
com.google.common.graph.ImmutableGraph.copyOf(ImmutableGraph<N>) no need to use this
com.google.common.graph.ImmutableNetwork.copyOf(ImmutableNetwork<N, E>) no need to use this
com.google.common.graph.ImmutableValueGraph.copyOf(ImmutableValueGraph<N, V>) no need to use this
com.google.common.collect.ConcurrentHashMultiset.createEntrySet() Internal method, use `AbstractMultiset.entrySet()`.
com.google.common.base.CharMatcher.digit() Many digits are supplementary characters; see the class documentation.
com.google.common.collect.ImmutableBiMap.forcePut(K, V) Unsupported operation.
com.google.common.collect.FluentIterable.from(FluentIterable<E>) instances of `FluentIterable` don't need to be converted to `FluentIterable`
com.google.common.collect.Ordering.from(Ordering<T>) no need to use this
com.google.common.io.Files.hash(File, HashFunction) Prefer `asByteSource(file).hash(hashFunction)`. This method is scheduled to be removed in January 2019.
com.google.common.hash.Hasher.hashCode() This returns `Object.hashCode()`; you almost certainly mean to call `hash().asInt()`.
com.google.common.util.concurrent.Futures.immediateCheckedFuture(V) `CheckedFuture` cannot properly support the chained operations that are the primary goal of `ListenableFuture`. `CheckedFuture` also encourages users to rethrow exceptions from one thread in another thread, producing misleading stack traces. Additionally, it has a surprising policy about which exceptions to map and which to leave untouched. Guava users who want a `CheckedFuture` can fork the classes for their own use, possibly specializing them to the particular exception type they use. We recommend that most people use `ListenableFuture` and perform any exception wrapping themselves. This method is scheduled for removal from Guava in July 2018.
com.google.common.util.concurrent.Futures.immediateFailedCheckedFuture(X) `CheckedFuture` cannot properly support the chained operations that are the primary goal of `ListenableFuture`. `CheckedFuture` also encourages users to rethrow exceptions from one thread in another thread, producing misleading stack traces. Additionally, it has a surprising policy about which exceptions to map and which to leave untouched. Guava users who want a `CheckedFuture` can fork the classes for their own use, possibly specializing them to the particular exception type they use. We recommend that most people use `ListenableFuture` and perform any exception wrapping themselves. This method is scheduled for removal from Guava in July 2018.
com.google.common.base.CharMatcher.invisible() Most invisible characters are supplementary characters; see the class documentation.
com.google.common.base.CharMatcher.javaDigit() Many digits are supplementary characters; see the class documentation.
com.google.common.base.CharMatcher.javaLetter() Most letters are supplementary characters; see the class documentation.
com.google.common.base.CharMatcher.javaLetterOrDigit() Most letters and digits are supplementary characters; see the class documentation.
com.google.common.base.CharMatcher.javaLowerCase() Some lowercase characters are supplementary characters; see the class documentation.
com.google.common.base.CharMatcher.javaUpperCase() Some uppercase characters are supplementary characters; see the class documentation.
com.google.common.collect.TreeMultimap.keyComparator() Use `((NavigableSet<K>) multimap.keySet()).comparator()` instead.
com.google.common.util.concurrent.Futures.makeChecked(ListenableFuture<V>, Function<? super Exception, X>) `CheckedFuture` cannot properly support the chained operations that are the primary goal of `ListenableFuture`. `CheckedFuture` also encourages users to rethrow exceptions from one thread in another thread, producing misleading stack traces. Additionally, it has a surprising policy about which exceptions to map and which to leave untouched. Guava users who want a `CheckedFuture` can fork the classes for their own use, possibly specializing them to the particular exception type they use. We recommend that most people use `ListenableFuture` and perform any exception wrapping themselves. This method is scheduled for removal from Guava in July 2018.
com.google.common.hash.Hashing.md5() If you must interoperate with a system that requires MD5, then use this method, despite its deprecation. But if you can choose your hash function, avoid MD5, which is neither fast nor secure. As of January 2017, we suggest: For security: `Hashing.sha256()` or a higher-level API. For speed: `Hashing.goodFastHash(int)`, though see its docs for caveats.
com.google.common.math.DoubleMath.mean(double...) Use `Stats.meanOf(java.lang.Iterable<? extends java.lang.Number>)` instead, noting the less strict handling of non-finite values.
com.google.common.math.DoubleMath.mean(int...) Use `Stats.meanOf(java.lang.Iterable<? extends java.lang.Number>)` instead, noting the less strict handling of non-finite values.
com.google.common.math.DoubleMath.mean(Iterable<? extends Number>) Use `Stats.meanOf(java.lang.Iterable<? extends java.lang.Number>)` instead, noting the less strict handling of non-finite values.
com.google.common.math.DoubleMath.mean(Iterator<? extends Number>) Use `Stats.meanOf(java.lang.Iterable<? extends java.lang.Number>)` instead, noting the less strict handling of non-finite values.
com.google.common.math.DoubleMath.mean(long...) Use `Stats.meanOf(java.lang.Iterable<? extends java.lang.Number>)` instead, noting the less strict handling of non-finite values.
com.google.common.collect.ImmutableMap.merge(K, V, BiFunction<? super V, ? super V, ? extends V>) Unsupported operation.
com.google.common.collect.Sets.newSetFromMap(Map<E, Boolean>) Use `Collections.newSetFromMap(java.util.Map<E, java.lang.Boolean>)` instead.
com.google.common.collect.ImmutableSortedMap.Builder.orderEntriesByValue(Comparator<? super V>) Unsupported by ImmutableSortedMap.Builder.
com.google.common.collect.Iterators.peekingIterator(PeekingIterator<T>) no need to use this
com.google.common.collect.ImmutableSortedSet.pollFirst() Unsupported operation.
com.google.common.collect.ImmutableSortedMultiset.pollFirstEntry() Unsupported operation.
com.google.common.collect.ImmutableSortedMap.pollFirstEntry() Unsupported operation.
com.google.common.collect.ImmutableSortedSet.pollLast() Unsupported operation.
com.google.common.collect.ImmutableSortedMultiset.pollLastEntry() Unsupported operation.
com.google.common.collect.ImmutableSortedMap.pollLastEntry() Unsupported operation.
com.google.common.collect.TreeTraverser.postOrderTraversal(T) Use `Traverser.depthFirstPostOrder(N)` instead, which has the same behavior.
com.google.common.collect.TreeTraverser.preOrderTraversal(T) Use `Traverser.depthFirstPreOrder(N)` instead, which has the same behavior.
com.google.common.base.Throwables.propagate(Throwable) Use `throw e` or `throw new RuntimeException(e)` directly, or use a combination of `Throwables.throwIfUnchecked(java.lang.Throwable)` and `throw new RuntimeException(e)`. For background on the deprecation, read Why we deprecated `Throwables.propagate`.
com.google.common.base.Throwables.propagateIfInstanceOf(Throwable, Class<X>) Use `Throwables.throwIfInstanceOf(java.lang.Throwable, java.lang.Class<X>)`, which has the same behavior but rejects `null`.
com.google.common.base.Throwables.propagateIfPossible(Throwable) Use `Throwables.throwIfUnchecked(java.lang.Throwable)`, which has the same behavior but rejects `null`.
com.google.common.collect.ImmutableMultimap.put(K, V) Unsupported operation.
com.google.common.collect.ImmutableMap.put(K, V) Unsupported operation.
com.google.common.collect.ImmutableRangeMap.put(Range<K>, V) Unsupported operation.
com.google.common.collect.ImmutableTable.put(R, C, V) Unsupported operation.
com.google.common.reflect.MutableTypeToInstanceMap.put(TypeToken<? extends B>, B) unsupported operation
com.google.common.reflect.ImmutableTypeToInstanceMap.put(TypeToken<? extends B>, B) unsupported operation
com.google.common.collect.ImmutableMultimap.putAll(K, Iterable<? extends V>) Unsupported operation.
com.google.common.collect.ImmutableMap.putAll(Map<? extends K, ? extends V>) Unsupported operation.
com.google.common.reflect.MutableTypeToInstanceMap.putAll(Map<? extends TypeToken<? extends B>, ? extends B>) unsupported operation
com.google.common.reflect.ImmutableTypeToInstanceMap.putAll(Map<? extends TypeToken<? extends B>, ? extends B>) unsupported operation
com.google.common.collect.ImmutableMultimap.putAll(Multimap<? extends K, ? extends V>) Unsupported operation.
com.google.common.collect.ImmutableRangeMap.putAll(RangeMap<K, V>) Unsupported operation.
com.google.common.collect.ImmutableTable.putAll(Table<? extends R, ? extends C, ? extends V>) Unsupported operation.
com.google.common.collect.ImmutableRangeMap.putCoalescing(Range<K>, V) Unsupported operation.
com.google.common.collect.ImmutableMap.putIfAbsent(K, V) Unsupported operation.
com.google.common.reflect.ImmutableTypeToInstanceMap.putInstance(Class<T>, T) unsupported operation
com.google.common.collect.ImmutableClassToInstanceMap.putInstance(Class<T>, T) Unsupported operation.
com.google.common.reflect.ImmutableTypeToInstanceMap.putInstance(TypeToken<T>, T) unsupported operation
com.google.common.io.Files.readBytes(File, ByteProcessor<T>) Prefer `asByteSource(file).read(processor)`. This method is scheduled to be removed in January 2019.
com.google.common.io.Files.readFirstLine(File, Charset) Prefer `asCharSource(file, charset).readFirstLine()`. This method is scheduled to be removed in January 2019.
com.google.common.io.Files.readLines(File, Charset, LineProcessor<T>) Prefer `asCharSource(file, charset).readLines(callback)`. This method is scheduled to be removed in January 2019.
com.google.common.collect.UnmodifiableIterator.remove() Unsupported operation.
com.google.common.collect.ImmutableList.remove(int) Unsupported operation.
com.google.common.collect.Sets.SetView.remove(Object) Unsupported operation.
com.google.common.collect.ImmutableCollection.remove(Object) Unsupported operation.
com.google.common.collect.ImmutableMap.remove(Object) Unsupported operation.
com.google.common.collect.ImmutableMultiset.remove(Object, int) Unsupported operation.
com.google.common.collect.ImmutableMultimap.remove(Object, Object) Unsupported operation.
com.google.common.collect.ArrayTable.remove(Object, Object) Use `ArrayTable.erase(java.lang.Object, java.lang.Object)`
com.google.common.collect.ImmutableTable.remove(Object, Object) Unsupported operation.
com.google.common.collect.ImmutableMap.remove(Object, Object) Unsupported operation.
com.google.common.collect.ImmutableRangeSet.remove(Range<C>) Unsupported operation.
com.google.common.collect.ImmutableRangeMap.remove(Range<K>) Unsupported operation.
com.google.common.collect.Sets.SetView.removeAll(Collection<?>) Unsupported operation.
com.google.common.collect.ImmutableCollection.removeAll(Collection<?>) Unsupported operation.
com.google.common.collect.ImmutableRangeSet.removeAll(Iterable<Range<C>>) Unsupported operation.
com.google.common.collect.ImmutableSetMultimap.removeAll(Object) Unsupported operation.
com.google.common.collect.ImmutableMultimap.removeAll(Object) Unsupported operation.
com.google.common.collect.ImmutableListMultimap.removeAll(Object) Unsupported operation.
com.google.common.collect.ImmutableRangeSet.removeAll(RangeSet<C>) Unsupported operation.
com.google.common.collect.Sets.SetView.removeIf(Predicate<? super E>) Unsupported operation.
com.google.common.collect.ImmutableCollection.removeIf(Predicate<? super E>) Unsupported operation.
com.google.common.collect.ImmutableMap.replace(K, V) Unsupported operation.
com.google.common.collect.ImmutableMap.replace(K, V, V) Unsupported operation.
com.google.common.collect.ImmutableMap.replaceAll(BiFunction<? super K, ? super V, ? extends V>) Unsupported operation.
com.google.common.collect.ImmutableList.replaceAll(UnaryOperator<E>) Unsupported operation.
com.google.common.collect.ImmutableSetMultimap.replaceValues(K, Iterable<? extends V>) Unsupported operation.
com.google.common.collect.ImmutableMultimap.replaceValues(K, Iterable<? extends V>) Unsupported operation.
com.google.common.collect.ImmutableListMultimap.replaceValues(K, Iterable<? extends V>) Unsupported operation.
com.google.common.collect.Sets.SetView.retainAll(Collection<?>) Unsupported operation.
com.google.common.collect.ImmutableCollection.retainAll(Collection<?>) Unsupported operation.
com.google.common.collect.TreeBasedTable.rowComparator() Use `table.rowKeySet().comparator()` instead.
com.google.common.collect.UnmodifiableListIterator.set(E) Unsupported operation.
com.google.common.collect.ImmutableList.set(int, E) Unsupported operation.
com.google.common.collect.ImmutableMultiset.setCount(E, int) Unsupported operation.
com.google.common.collect.ImmutableMultiset.setCount(E, int, int) Unsupported operation.
com.google.common.hash.Hashing.sha1() If you must interoperate with a system that requires SHA-1, then use this method, despite its deprecation. But if you can choose your hash function, avoid SHA-1, which is neither fast nor secure. As of January 2017, we suggest: For security: `Hashing.sha256()` or a higher-level API. For speed: `Hashing.goodFastHash(int)`, though see its docs for caveats.
com.google.common.base.CharMatcher.singleWidth() Many such characters are supplementary characters; see the class documentation.
com.google.common.collect.ImmutableList.sort(Comparator<? super E>) Unsupported operation.
com.google.common.collect.Streams.stream(Collection<T>) There is no reason to use this; just invoke `collection.stream()` directly.
com.google.common.base.Equivalence.test(T, T) Provided only to satisfy the `BiPredicate` interface; use `Equivalence.equivalent(T, T)` instead.
com.google.common.io.Files.toString(File, Charset) Prefer `asCharSource(file, charset).read()`. This method is scheduled to be removed in January 2019.
com.google.common.util.concurrent.Futures.transform(ListenableFuture<I>, Function<? super I, ? extends O>) Use the overload that requires an executor. For identical behavior, pass `MoreExecutors.directExecutor()`, but consider whether another executor would be safer, as discussed in the `ListenableFuture.addListener` documentation. This method is scheduled to be removed in July 2018.
com.google.common.util.concurrent.Futures.transformAsync(ListenableFuture<I>, AsyncFunction<? super I, ? extends O>) Use the overload that requires an executor. For identical behavior, pass `MoreExecutors.directExecutor()`, but consider whether another executor would be safer, as discussed in the `ListenableFuture.addListener` documentation. This method is scheduled to be removed in July 2018.
com.google.common.collect.ArrayListMultimap.trimToSize() For a `ListMultimap` that automatically trims to size, use `ImmutableListMultimap`. If you need a mutable collection, remove the `trimToSize` call, or switch to a `HashMap<K, ArrayList<V>>`.
com.google.common.collect.Iterables.unmodifiableIterable(ImmutableCollection<E>) no need to use this
com.google.common.collect.Iterators.unmodifiableIterator(UnmodifiableIterator<T>) no need to use this
com.google.common.collect.Multimaps.unmodifiableListMultimap(ImmutableListMultimap<K, V>) no need to use this
com.google.common.collect.Multimaps.unmodifiableMultimap(ImmutableMultimap<K, V>) no need to use this
com.google.common.collect.Multisets.unmodifiableMultiset(ImmutableMultiset<E>) no need to use this
com.google.common.collect.Multimaps.unmodifiableSetMultimap(ImmutableSetMultimap<K, V>) no need to use this
com.google.common.collect.TreeTraverser.using(Function<T, ? extends Iterable<T>>) Use `Traverser.forTree(com.google.common.graph.SuccessorsFunction<N>)` instead. If you are using a lambda, these methods have exactly the same signature.
com.google.common.io.Files.write(CharSequence, File, Charset) Prefer `asCharSink(to, charset).write(from)`. This method is scheduled to be removed in January 2019.
com.google.common.io.ByteArrayDataOutput.writeBytes(String) This method is dangerous as it discards the high byte of every character. For UTF-8, use `write(s.getBytes(StandardCharsets.UTF_8))`.
com.google.common.io.LittleEndianDataOutputStream.writeBytes(String) The semantics of `writeBytes(String s)` are considered dangerous. Please use `LittleEndianDataOutputStream.writeUTF(String s)`, `LittleEndianDataOutputStream.writeChars(String s)` or another write method instead.

Deprecated API

Contents