Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Methods

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 January 2019.

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 January 2019.
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 January 2019.
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 October 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 January 2019.

Deprecated Methods

Method and Description
com.google.common.collect.Sets.SetView.add(E) Unsupported operation.
com.google.common.collect.UnmodifiableListIterator.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.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.collect.Sets.SetView.clear() Unsupported operation.
com.google.common.collect.ImmutableRangeMap.clear() Unsupported operation.
com.google.common.collect.ImmutableMultimap.clear() Unsupported operation.
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.ArrayTable.clear() Use ArrayTable.eraseAll()
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.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 January 2019.
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 January 2019.
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 January 2019.
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.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.ImmutableSortedMap.pollFirstEntry() Unsupported operation.
com.google.common.collect.ImmutableSortedMultiset.pollFirstEntry() Unsupported operation.
com.google.common.collect.ImmutableSortedSet.pollLast() Unsupported operation.
com.google.common.collect.ImmutableSortedMap.pollLastEntry() Unsupported operation.
com.google.common.collect.ImmutableSortedMultiset.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.ImmutableTypeToInstanceMap.put(TypeToken<? extends B>, B) unsupported operation
com.google.common.reflect.MutableTypeToInstanceMap.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.ImmutableTypeToInstanceMap.putAll(Map<? extends TypeToken<? extends B>, ? extends B>) unsupported operation
com.google.common.reflect.MutableTypeToInstanceMap.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.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.ImmutableTable.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.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.ImmutableMultimap.removeAll(Object) Unsupported operation.
com.google.common.collect.ImmutableSetMultimap.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.ImmutableMultimap.replaceValues(K, Iterable<? extends V>) Unsupported operation.
com.google.common.collect.ImmutableSetMultimap.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.io.Files.toString(File, Charset) Prefer asCharSource(file, charset).read(). This method is scheduled to be removed in January 2019.
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.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.
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)).