Deprecated API

Contents

• Interfaces
• Classes
• Fields
• Methods

Deprecated Interfaces

Interface	Description
com.google.common.collect.MapConstraint	Use invalid reference Preconditions for basic checks. In place of constrained maps, we encourage you to check your preconditions explicitly instead of leaving that work to the map implementation. For the specific case of rejecting null, consider ImmutableMap. This class is scheduled for removal in Guava 21.0.

Deprecated Classes

Class	Description
com.google.common.base.Objects.ToStringHelper	Use MoreObjects.ToStringHelper instead. This class is scheduled for removal in Guava 21.0.
com.google.common.collect.MapConstraints	Use invalid reference Preconditions for basic checks. In place of constrained maps, we encourage you to check your preconditions explicitly instead of leaving that work to the map implementation. For the specific case of rejecting null, consider ImmutableMap. This class is scheduled for removal in Guava 21.0.

Deprecated Fields

Field	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	Use CharMatcher.digit() instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.INVISIBLE	Use CharMatcher.invisible() instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_DIGIT	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	Use CharMatcher.javaLetter() instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_LETTER_OR_DIGIT	Use CharMatcher.javaLetterOrDigit() instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_LOWER_CASE	Use CharMatcher.javaLowerCase() instead. This constant is scheduled to be removed in June 2018.
com.google.common.base.CharMatcher.JAVA_UPPER_CASE	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	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	Description
com.google.common.base.CharMatcher.apply(Character)	Provided only to satisfy the Predicate interface; use CharMatcher.matches(char) instead.
com.google.common.base.Converter.apply(A)	Provided to satisfy the Function interface; use Converter.convert(A) instead.
com.google.common.base.Objects.firstNonNull(T, T)	Use MoreObjects.firstNonNull(T, T) instead. This method is scheduled for removal in Guava 21.0.
com.google.common.base.Objects.toStringHelper(Class<?>)	Use MoreObjects.toStringHelper(Class) instead. This method is scheduled for removal in Guava 21.0.
com.google.common.base.Objects.toStringHelper(Object)	Use MoreObjects.toStringHelper(Object) instead. This method is scheduled for removal in Guava 21.0.
com.google.common.base.Objects.toStringHelper(String)	Use MoreObjects.toStringHelper(String) instead. This method is scheduled for removal in Guava 21.0.
com.google.common.base.Predicates.assignableFrom(Class<?>)	Use the correctly-named method Predicates.subtypeOf(java.lang.Class<?>) instead.
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). This method is scheduled to be removed in July 2018.
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. This method is scheduled to be removed in July 2018.
com.google.common.base.Throwables.propagateIfPossible(Throwable)	Use Throwables.throwIfUnchecked(java.lang.Throwable), which has the same behavior but rejects null. This method is scheduled to be removed in July 2018.
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.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.create(MapMaker)	Use ConcurrentHashMultiset.create(ConcurrentMap) instead. This method is scheduled for deletion in Guava 21.0.
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.FluentIterable.of(E[])	Use invalid reference #from(E[]) instead (but note the differences in mutability). This method will be removed in Guava release 21.0.
com.google.common.collect.ImmutableBiMap.forcePut(K, V)	Unsupported operation.
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.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.remove(int)	Unsupported operation.
com.google.common.collect.ImmutableList.set(int, 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.put(K, V)	Unsupported operation.
com.google.common.collect.ImmutableMap.putAll(Map<? extends K, ? extends V>)	Unsupported operation.
com.google.common.collect.ImmutableMap.remove(Object)	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(Multimap<? extends K, ? extends 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.ImmutableMultiset.setCount(E, int, int)	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.clear()	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.put(Range<K>, V)	Unsupported operation.
com.google.common.collect.ImmutableRangeMap.putAll(RangeMap<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.orderEntriesByValue(Comparator<? super V>)	Unsupported by ImmutableSortedMap.Builder.
com.google.common.collect.ImmutableSortedMap.pollFirstEntry()	Unsupported operation.
com.google.common.collect.ImmutableSortedMap.pollLastEntry()	Unsupported operation.
com.google.common.collect.ImmutableSortedMultiset.pollFirstEntry()	Unsupported operation.
com.google.common.collect.ImmutableSortedMultiset.pollLastEntry()	Unsupported operation.
com.google.common.collect.ImmutableSortedSet.pollFirst()	Unsupported operation.
com.google.common.collect.ImmutableSortedSet.pollLast()	Unsupported operation.
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. This method is scheduled for deletion in June 2018.
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. This method will be removed in December 2017.
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.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.
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. This method will be removed in February 2018.
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. This method will be removed in February 2018.
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. This method will be removed in February 2018.
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. This method will be removed in February 2018.
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. This method will be removed in February 2018.
com.google.common.net.HostAndPort.getHostText()	Use HostAndPort.getHost() instead. This method is scheduled for removal in Guava 22.0.
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.ImmutableTypeToInstanceMap.putInstance(Class<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.MoreExecutors.sameThreadExecutor()	Use MoreExecutors.directExecutor() if you only require an Executor and MoreExecutors.newDirectExecutorService() if you need a ListeningExecutorService. This method will be removed in Guava 21.0.