Deprecated API

Contents

• Classes
• Exceptions
• Fields
• Methods
• Constructors
• Enum Constants

Classes

Class	Description
com.google.common.collect.ForwardingBlockingDeque	This class has moved to com.google.common.util.concurrent. Please use ForwardingBlockingDeque instead.
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 October 2019.

Exceptions

Exceptions

Description

com.google.common.collect.ComputationException

This exception is no longer thrown by com.google.common. Previously, it was thrown by MapMaker computing maps. When support for computing maps was removed from MapMaker, it was added to CacheBuilder, which throws ExecutionException, UncheckedExecutionException, and ExecutionError. Any code that is still catching ComputationException may need to be updated to catch some of those types instead. (Note that this type, though deprecated, is not planned to be removed from Guava.)

Fields

Field	Description
com.google.common.net.HttpHeaders.SEC_CH_UA_FORM_FACTOR	Prefer HttpHeaders.SEC_CH_UA_FORM_FACTORS.
com.google.common.net.HttpHeaders.SEC_CH_UA_FULL_VERSION	Prefer HttpHeaders.SEC_CH_UA_FULL_VERSION_LIST.

Methods

Method	Description
com.google.common.base.CharMatcher.apply(Character)	Provided only to satisfy the Predicate interface; use CharMatcher.matches(char) instead.
com.google.common.base.CharMatcher.digit()	Many digits are supplementary characters; see the class documentation.
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.base.CharMatcher.singleWidth()	Many such characters are supplementary characters; see the class documentation.
com.google.common.base.Converter.apply(A)	Provided to satisfy the Function interface; use Converter.convert(A) instead.
com.google.common.base.Equivalence.test(T, T)	Provided only to satisfy the BiPredicate interface; use Equivalence.equivalent(T, T) instead.
com.google.common.base.Throwables.lazyStackTrace(Throwable)	This method is equivalent to Throwable.getStackTrace() on JDK versions past JDK 8 and on all Android versions. Use Throwable.getStackTrace() directly, or where possible use the java.lang.StackWalker.walk method introduced in JDK 9.
com.google.common.base.Throwables.lazyStackTraceIsLazy()	This method always returns false on JDK versions past JDK 8 and on all Android versions.
com.google.common.base.Throwables.propagate(Throwable)	To preserve behavior, use throw e or throw new RuntimeException(e) directly, or use a combination of Throwables.throwIfUnchecked(java.lang.Throwable) and throw new RuntimeException(e). But consider whether users would be better off if your API threw a different type of exception. 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.cache.LoadingCache.apply(K)	Provided to satisfy the Function interface; use LoadingCache.get(K) or LoadingCache.getUnchecked(K) instead.
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.ArrayTable.clear()	Use ArrayTable.eraseAll()
com.google.common.collect.ArrayTable.remove(Object, Object)	Use ArrayTable.erase(java.lang.Object, java.lang.Object)
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.ConcurrentHashMultiset.createEntrySet()	Internal method, use Multiset.entrySet().
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.FluentIterable.from(FluentIterable<E>)	instances of FluentIterable don't need to be converted to FluentIterable
com.google.common.collect.ImmutableBiMap.Builder.buildKeepingLast()	This method does not make sense for bimaps and should not be called.
com.google.common.collect.ImmutableBiMap.forcePut(K, V)	Unsupported operation.
com.google.common.collect.ImmutableBiMap.toImmutableMap(Function<? super T, ? extends K>, Function<? super T, ? extends V>)	Use ImmutableBiMap.toImmutableBiMap(java.util.function.Function<? super T, ? extends K>, java.util.function.Function<? super T, ? extends V>).
com.google.common.collect.ImmutableClassToInstanceMap.putInstance(Class<T>, T)	Unsupported operation.
com.google.common.collect.ImmutableCollection.add(E)	Unsupported operation.
com.google.common.collect.ImmutableCollection.addAll(Collection<? extends E>)	Unsupported operation.
com.google.common.collect.ImmutableCollection.clear()	Unsupported operation.
com.google.common.collect.ImmutableCollection.remove(Object)	Unsupported operation.
com.google.common.collect.ImmutableCollection.removeAll(Collection<?>)	Unsupported operation.
com.google.common.collect.ImmutableCollection.removeIf(Predicate<? super E>)	Unsupported operation.
com.google.common.collect.ImmutableCollection.retainAll(Collection<?>)	Unsupported operation.
com.google.common.collect.ImmutableList.add(int, E)	Unsupported operation.
com.google.common.collect.ImmutableList.addAll(int, Collection<? extends E>)	Unsupported operation.
com.google.common.collect.ImmutableList.asList()	There is no reason to use this; it always returns this.
com.google.common.collect.ImmutableList.remove(int)	Unsupported operation.
com.google.common.collect.ImmutableList.replaceAll(UnaryOperator<E>)	Unsupported operation.
com.google.common.collect.ImmutableList.set(int, E)	Unsupported operation.
com.google.common.collect.ImmutableList.sort(Comparator<? super E>)	Unsupported operation.
com.google.common.collect.ImmutableListMultimap.removeAll(Object)	Unsupported operation.
com.google.common.collect.ImmutableListMultimap.replaceValues(K, Iterable<? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableMap.clear()	Unsupported operation.
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.collect.ImmutableMap.merge(K, V, BiFunction<? super V, ? super V, ? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableMap.put(K, V)	Unsupported operation.
com.google.common.collect.ImmutableMap.putAll(Map<? extends K, ? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableMap.putIfAbsent(K, V)	Unsupported operation.
com.google.common.collect.ImmutableMap.remove(Object)	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.ImmutableMultimap.clear()	Unsupported operation.
com.google.common.collect.ImmutableMultimap.put(K, V)	Unsupported operation.
com.google.common.collect.ImmutableMultimap.putAll(K, Iterable<? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableMultimap.remove(Object, Object)	Unsupported operation.
com.google.common.collect.ImmutableMultimap.removeAll(Object)	Unsupported operation.
com.google.common.collect.ImmutableMultimap.replaceValues(K, Iterable<? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableMultiset.add(E, int)	Unsupported operation.
com.google.common.collect.ImmutableMultiset.remove(Object, int)	Unsupported operation.
com.google.common.collect.ImmutableMultiset.setCount(E, int)	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.clear()	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.merge(Range<K>, V, BiFunction<? super V, ? super V, ? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.put(Range<K>, V)	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.putAll(RangeMap<K, ? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.putCoalescing(Range<K>, V)	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.remove(Range<K>)	Unsupported operation.
com.google.common.collect.ImmutableRangeSet.add(Range<C>)	Unsupported operation.
com.google.common.collect.ImmutableRangeSet.addAll(RangeSet<C>)	Unsupported operation.
com.google.common.collect.ImmutableRangeSet.remove(Range<C>)	Unsupported operation.
com.google.common.collect.ImmutableRangeSet.removeAll(RangeSet<C>)	Unsupported operation.
com.google.common.collect.ImmutableSetMultimap.removeAll(Object)	Unsupported operation.
com.google.common.collect.ImmutableSetMultimap.replaceValues(K, Iterable<? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableSortedMap.builder()	Use ImmutableSortedMap.naturalOrder(), which offers better type-safety.
com.google.common.collect.ImmutableSortedMap.Builder.buildKeepingLast()	This method is not currently implemented, and may never be.
com.google.common.collect.ImmutableSortedMap.Builder.orderEntriesByValue(Comparator<? super V>)	Unsupported by ImmutableSortedMap.Builder.
com.google.common.collect.ImmutableSortedMap.builderWithExpectedSize(int)	Not supported for ImmutableSortedMap.
com.google.common.collect.ImmutableSortedMap.of(K, V)	Pass a key of type Comparable to use ImmutableSortedMap.of(Comparable, Object).
com.google.common.collect.ImmutableSortedMap.ofEntries(Map.Entry<? extends K, ? extends V>...)	Use ImmutableSortedMap.copyOf(ImmutableMap.ofEntries(...)).
com.google.common.collect.ImmutableSortedMap.pollFirstEntry()	Unsupported operation.
com.google.common.collect.ImmutableSortedMap.pollLastEntry()	Unsupported operation.
com.google.common.collect.ImmutableSortedMap.toImmutableMap(Function<? super T, ? extends K>, Function<? super T, ? extends V>)	Use ImmutableSortedMap.toImmutableSortedMap(java.util.Comparator<? super K>, java.util.function.Function<? super T, ? extends K>, java.util.function.Function<? super T, ? extends V>).
com.google.common.collect.ImmutableSortedMultiset.builder()	Use ImmutableSortedMultiset.naturalOrder(), which offers better type-safety.
com.google.common.collect.ImmutableSortedMultiset.copyOf(Z[])	Pass parameters of type Comparable to use ImmutableSortedMultiset.copyOf(Comparable[]).
com.google.common.collect.ImmutableSortedMultiset.of(E)	Pass a parameter of type Comparable to use ImmutableSortedMultiset.of(Comparable).
com.google.common.collect.ImmutableSortedMultiset.pollFirstEntry()	Unsupported operation.
com.google.common.collect.ImmutableSortedMultiset.pollLastEntry()	Unsupported operation.
com.google.common.collect.ImmutableSortedMultiset.toImmutableMultiset()	Use ImmutableSortedMultiset.toImmutableSortedMultiset(java.util.Comparator<? super E>).
com.google.common.collect.ImmutableSortedSet.builder()	Use ImmutableSortedSet.naturalOrder(), which offers better type-safety.
com.google.common.collect.ImmutableSortedSet.builderWithExpectedSize(int)	Not supported by ImmutableSortedSet.
com.google.common.collect.ImmutableSortedSet.copyOf(Z[])	Pass parameters of type Comparable to use ImmutableSortedSet.copyOf(Comparable[]).
com.google.common.collect.ImmutableSortedSet.of(E)	Pass a parameter of type Comparable to use ImmutableSortedSet.of(Comparable).
com.google.common.collect.ImmutableSortedSet.pollFirst()	Unsupported operation.
com.google.common.collect.ImmutableSortedSet.pollLast()	Unsupported operation.
com.google.common.collect.ImmutableSortedSet.toImmutableSet()	Use ImmutableSortedSet.toImmutableSortedSet(java.util.Comparator<? super E>).
com.google.common.collect.ImmutableTable.clear()	Unsupported operation.
com.google.common.collect.ImmutableTable.put(R, C, V)	Unsupported operation.
com.google.common.collect.ImmutableTable.putAll(Table<? extends R, ? extends C, ? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableTable.remove(Object, Object)	Unsupported operation.
com.google.common.collect.Iterables.unmodifiableIterable(ImmutableCollection<E>)	no need to use this
com.google.common.collect.Iterators.peekingIterator(PeekingIterator<T>)	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.Multimaps.unmodifiableSetMultimap(ImmutableSetMultimap<K, V>)	no need to use this
com.google.common.collect.Multisets.unmodifiableMultiset(ImmutableMultiset<E>)	no need to use this
com.google.common.collect.Ordering.binarySearch(List<? extends T>, T)	Use Collections.binarySearch(List, Object, Comparator) directly.
com.google.common.collect.Ordering.from(Ordering<T>)	no need to use this
com.google.common.collect.Range.apply(C)	Provided only to satisfy the Predicate interface; use Range.contains(C) instead.
com.google.common.collect.Sets.newSetFromMap(Map<E, Boolean>)	Use Collections.newSetFromMap(java.util.Map<E, java.lang.Boolean>) instead.
com.google.common.collect.Sets.SetView.add(E)	Unsupported operation.
com.google.common.collect.Sets.SetView.addAll(Collection<? extends E>)	Unsupported operation.
com.google.common.collect.Sets.SetView.clear()	Unsupported operation.
com.google.common.collect.Sets.SetView.remove(Object)	Unsupported operation.
com.google.common.collect.Sets.SetView.removeAll(Collection<?>)	Unsupported operation.
com.google.common.collect.Sets.SetView.removeIf(Predicate<? super E>)	Unsupported operation.
com.google.common.collect.Sets.SetView.retainAll(Collection<?>)	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.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.TreeBasedTable.rowComparator()	Use table.rowKeySet().comparator() instead.
com.google.common.collect.TreeMultimap.keyComparator()	Use ((NavigableSet<K>) multimap.keySet()).comparator() instead.
com.google.common.collect.TreeTraverser.breadthFirstTraversal(T)	Use Traverser.breadthFirst(N) instead, which has the same behavior.
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.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.collect.UnmodifiableIterator.remove()	Unsupported operation.
com.google.common.collect.UnmodifiableListIterator.add(E)	Unsupported operation.
com.google.common.collect.UnmodifiableListIterator.set(E)	Unsupported operation.
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.hash.BloomFilter.apply(T)	Provided only to satisfy the Predicate interface; use BloomFilter.mightContain(T) instead.
com.google.common.hash.Hasher.hashCode()	This returns Object.hashCode(); you almost certainly mean to call hash().asInt().
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.hash.Hashing.murmur3_32(int)	This implementation produces incorrect hash values from the HashFunction.hashString(java.lang.CharSequence, java.nio.charset.Charset) method if the string contains non-BMP characters. Use Hashing.murmur3_32_fixed(int) instead.
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.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.Files.append(CharSequence, File, Charset)	Prefer asCharSink(to, charset, FileWriteMode.APPEND).write(from). This method is scheduled to be removed in October 2019.
com.google.common.io.Files.copy(File, Charset, Appendable)	Prefer asCharSource(from, charset).copyTo(to).
com.google.common.io.Files.createTempDir()	For Android users, see the Data and File Storage overview to select an appropriate temporary directory (perhaps context.getCacheDir()), and create your own directory under that. (For example, you might use new File(context.getCacheDir(), "directoryname").mkdir(), or, if you need an arbitrary number of temporary directories, you might have to generate multiple directory names in a loop until mkdir() returns true.) For JRE users, prefer Files.createTempDirectory(java.nio.file.Path, java.lang.String, java.nio.file.attribute.FileAttribute<?>...), transforming it to a File using toFile() if needed. To restrict permissions as this method does, pass PosixFilePermissions.asFileAttribute(PosixFilePermissions.fromString("rwx------")) to your call to createTempDirectory.
com.google.common.io.Files.hash(File, HashFunction)	Prefer asByteSource(file).hash(hashFunction).
com.google.common.io.Files.readBytes(File, ByteProcessor<T>)	Prefer asByteSource(file).read(processor).
com.google.common.io.Files.readFirstLine(File, Charset)	Prefer asCharSource(file, charset).readFirstLine().
com.google.common.io.Files.readLines(File, Charset, LineProcessor<T>)	Prefer asCharSource(file, charset).readLines(callback).
com.google.common.io.Files.toString(File, Charset)	Prefer asCharSource(file, charset).read().
com.google.common.io.Files.write(CharSequence, File, Charset)	Prefer asCharSink(to, charset).write(from).
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.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.reflect.ImmutableTypeToInstanceMap.put(TypeToken<? extends B>, B)	unsupported operation
com.google.common.reflect.ImmutableTypeToInstanceMap.putAll(Map<? extends TypeToken<? extends B>, ? extends B>)	unsupported operation
com.google.common.reflect.ImmutableTypeToInstanceMap.putInstance(TypeToken<T>, T)	unsupported operation
com.google.common.reflect.MutableTypeToInstanceMap.put(TypeToken<? extends B>, B)	unsupported operation
com.google.common.reflect.MutableTypeToInstanceMap.putAll(Map<? extends TypeToken<? extends B>, ? extends B>)	unsupported operation
com.google.common.util.concurrent.ClosingFuture.eventuallyClosing(ListenableFuture<C>, Executor)	Creating Futures of closeable types is dangerous in general because the underlying value may never be closed if the Future is canceled after its operation begins. Consider replacing code that creates ListenableFutures of closeable types, including those that pass them to this method, with ClosingFuture.submit(ClosingCallable, Executor) in order to ensure that resources do not leak. Or, to start a pipeline with a ListenableFuture that doesn't create values that should be closed, use ClosingFuture.from(com.google.common.util.concurrent.ListenableFuture<V>).
com.google.common.util.concurrent.FluentFuture.from(FluentFuture<V>)	no need to use this

Constructors

Constructor	Description
com.google.common.util.concurrent.ExecutionError()	Prefer ExecutionError(java.lang.Error) a constructor that accepts a cause: Users of this class typically expect for instances to have a non-null cause. At the moment, you can usually still preserve behavior by passing an explicit null cause. Note, however, that passing an explicit null cause prevents anyone from calling Throwable.initCause(java.lang.Throwable) later, so it is not quite equivalent to using a constructor that omits the cause.
com.google.common.util.concurrent.UncheckedExecutionException()	Prefer UncheckedExecutionException(java.lang.Throwable) a constructor that accepts a cause: Users of this class typically expect for instances to have a non-null cause. At the moment, you can usually still preserve behavior by passing an explicit null cause. Note, however, that passing an explicit null cause prevents anyone from calling Throwable.initCause(java.lang.Throwable) later, so it is not quite equivalent to using a constructor that omits the cause.

Enum Constants

Enum Constant	Description
com.google.common.base.StandardSystemProperty.JAVA_EXT_DIRS	This property was deprecated in Java 8 and removed in Java 9. We do not plan to remove this API from Guava, but if you are using it, it is probably not doing what you want.