Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods

Deprecated Interfaces

Interface and Description
com.google.common.collect.MapConstraint Use 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 and Description
com.google.common.collect.MapConstraints Use 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.
com.google.common.base.Objects.ToStringHelper Use MoreObjects.ToStringHelper instead. This class is scheduled for removal in Guava 21.0.

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 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 and Description
com.google.common.collect.ImmutableCollection.add(E) Unsupported operation.
com.google.common.collect.UnmodifiableListIterator.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.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(RangeSet<C>) Unsupported operation.
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.base.Predicates.assignableFrom(Class<?>) Use the correctly-named method Predicates.subtypeOf(java.lang.Class<?>) instead.
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.ContiguousSet.builder() Use ContiguousSet.create(com.google.common.collect.Range<C>, com.google.common.collect.DiscreteDomain<C>).
com.google.common.collect.ImmutableMap.clear() Unsupported operation.
com.google.common.collect.ImmutableCollection.clear() Unsupported operation.
com.google.common.collect.ArrayTable.clear() Use ArrayTable.eraseAll()
com.google.common.collect.ImmutableMultimap.clear() Unsupported operation.
com.google.common.collect.ImmutableRangeMap.clear() Unsupported operation.
com.google.common.collect.ImmutableTable.clear() Unsupported operation.
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.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.create(MapMaker) Use ConcurrentHashMultiset.create(ConcurrentMap) instead. This method is scheduled for deletion in Guava 21.0.
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.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.net.HostAndPort.getHostText() Use getHost() instead. This method is scheduled for removal in Guava 22.0.
com.google.common.hash.Hasher.hashCode() This returns Object.hashCode(); you almost certainly mean to call hash().asInt().
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(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.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.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.FluentIterable.of(E[]) Use #from(E[]) instead (but note the differences in mutability). This method will be removed in Guava release 21.0.
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.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.collect.ImmutableMap.put(K, V) Unsupported operation.
com.google.common.collect.ImmutableMultimap.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.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.collect.UnmodifiableIterator.remove() Unsupported operation.
com.google.common.collect.ImmutableList.remove(int) Unsupported operation.
com.google.common.collect.ImmutableMap.remove(Object) Unsupported operation.
com.google.common.collect.ImmutableCollection.remove(Object) Unsupported operation.
com.google.common.collect.ImmutableMultiset.remove(Object, int) Unsupported operation.
com.google.common.collect.ArrayTable.remove(Object, Object) Use ArrayTable.erase(java.lang.Object, java.lang.Object)
com.google.common.collect.ImmutableMultimap.remove(Object, Object) Unsupported operation.
com.google.common.collect.ImmutableTable.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.ImmutableCollection.removeAll(Collection<?>) 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.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.ImmutableCollection.retainAll(Collection<?>) 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.
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.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.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.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)).