Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
com.google.common.collect.Constraint Use Preconditions for basic checks. In place of constrained collections, we encourage you to check your preconditions explicitly instead of leaving that work to the collection implementation. For the specific case of rejecting null, consider the immutable collections. This interface is scheduled for removal in Guava 16.0.

Deprecated Classes

Class and Description
com.google.common.collect.Constraints Use Preconditions for basic checks. In place of constrained collections, we encourage you to check your preconditions explicitly instead of leaving that work to the collection implementation. For the specific case of rejecting null, consider the immutable collections. This class is scheduled for removal in Guava 16.0.
com.google.common.collect.DiscreteDomains Merged into DiscreteDomain. This class is scheduled for deletion in release 15.0.
com.google.common.util.concurrent.ForwardingService Instead of using a ForwardingService, consider using the Service.Listener functionality to hook into the Service lifecycle, or if you really do need to provide access to some Service methods, consider just providing the few that you actually need (e.g. just ForwardingService.startAndWait()) and not implementing Service.
com.google.common.collect.GenericMapMaker This class existed only to support the generic paramterization necessary for the caching functionality in MapMaker. That functionality has been moved to CacheBuilder, which is a properly generified class and thus needs no "Generic" equivalent; simple use CacheBuilder naturally. For general migration instructions, see the MapMaker Migration Guide. This class is scheduled for removal in Guava 16.0.
com.google.common.collect.Ranges Use the corresponding method in Range.

Deprecated Methods

Method and Description
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.ImmutableCollection.addAll(Collection) Unsupported operation.
com.google.common.collect.ImmutableList.addAll(int, Collection) Unsupported operation.
com.google.common.base.Joiner.appendTo(A, I) use Joiner.appendTo(Appendable, Iterator) by casting parts to Iterator<?>, or better yet, by implementing only Iterator and not Iterable. This method is scheduled for deletion in June 2013.
com.google.common.base.Joiner.MapJoiner.appendTo(A, I) use Joiner.MapJoiner.appendTo(Appendable, Iterator) by casting entries to Iterator<? extends Entry<?, ?>>, or better yet, by implementing only Iterator and not Iterable. This method is scheduled for deletion in June 2013.
com.google.common.base.Joiner.appendTo(StringBuilder, I) use Joiner.appendTo(StringBuilder, Iterator) by casting parts to Iterator<?>, or better yet, by implementing only Iterator and not Iterable. This method is scheduled for deletion in June 2013.
com.google.common.base.Joiner.MapJoiner.appendTo(StringBuilder, I) use Joiner.MapJoiner.appendTo(StringBuilder, Iterator) by casting entries to Iterator<? extends Entry<?, ?>>, or better yet, by implementing only Iterator and not Iterable. This method is scheduled for deletion in June 2013.
com.google.common.io.ByteStreams.asByteSource(byte[]) Use ByteSource.wrap(byte[]) instead. This method is scheduled to be removed in Guava 16.0.
com.google.common.io.CharStreams.asCharSource(String) Use CharSource.wrap(CharSequence) instead. This method is scheduled to be removed in Guava 16.0.
com.google.common.collect.Range.asSet(DiscreteDomain) Use ContiguousSet.create(range, domain). To be removed in Guava 16.0.
com.google.common.collect.ImmutableMap.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.ArrayTable.clear() Use ArrayTable.eraseAll()
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). This method is scheduled for deletion in September 2013.
com.google.common.base.Stopwatch.elapsedMillis() Use stopwatch.elapsed(MILLISECONDS) instead. This method is scheduled to be removed in Guava release 16.0.
com.google.common.base.Stopwatch.elapsedTime(TimeUnit) Use Stopwatch.elapsed(TimeUnit) instead. This method is scheduled to be removed in Guava release 16.0.
com.google.common.collect.ImmutableBiMap.forcePut(K, V) Unsupported operation.
com.google.common.collect.FluentIterable.from(FluentIterable) instances of FluentIterable don't need to be converted to FluentIterable
com.google.common.collect.Ordering.from(Ordering) no need to use this
com.google.common.net.InternetDomainName.fromLenient(String) Use InternetDomainName.from(String)
com.google.common.io.ByteSource.getInput() This method is only provided for temporary compatibility with the InputSupplier interface and should not be called directly. Use ByteSource.openStream() instead.
com.google.common.io.CharSource.getInput() This method is only provided for temporary compatibility with the InputSupplier interface and should not be called directly. Use CharSource.openStream() instead.
com.google.common.io.CharSink.getOutput() This method is only provided for temporary compatibility with the OutputSupplier interface and should not be called directly. Use CharSink.openStream() instead.
com.google.common.io.ByteSink.getOutput() This method is only provided for temporary compatibility with the OutputSupplier interface and should not be called directly. Use ByteSink.openStream() instead.
com.google.common.hash.HashFunction.hashString(CharSequence) Use HashFunction.hashUnencodedChars(java.lang.CharSequence) instead. This method is scheduled for removal in Guava 16.0.
com.google.common.base.Joiner.join(I) use Joiner.join(Iterator) by casting parts to Iterator<?>, or better yet, by implementing only Iterator and not Iterable. This method is scheduled for deletion in June 2013.
com.google.common.base.Joiner.MapJoiner.join(I) use Joiner.MapJoiner.join(Iterator) by casting entries to Iterator<? extends Entry<?, ?>>, or better yet, by implementing only Iterator and not Iterable. This method is scheduled for deletion in June 2013.
com.google.common.net.InternetDomainName.name() Use InternetDomainName.toString()
com.google.common.collect.Iterators.peekingIterator(PeekingIterator) 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.ImmutableMap.put(K, V) Unsupported operation.
com.google.common.collect.ImmutableMultimap.put(K, V) Unsupported operation.
com.google.common.collect.ImmutableTable.put(R, C, V) Unsupported operation.
com.google.common.collect.ImmutableMultimap.putAll(K, Iterable) Unsupported operation.
com.google.common.collect.ImmutableMap.putAll(Map) Unsupported operation.
com.google.common.collect.ImmutableMultimap.putAll(Multimap) Unsupported operation.
com.google.common.collect.ImmutableTable.putAll(Table) Unsupported operation.
com.google.common.collect.ImmutableClassToInstanceMap.putInstance(Class, T) Unsupported operation.
com.google.common.hash.PrimitiveSink.putString(CharSequence) Use {PrimitiveSink#putUnencodedChars} instead.
com.google.common.hash.Hasher.putString(CharSequence) Use Hasher.putUnencodedChars(java.lang.CharSequence) instead. This method is scheduled for removal in Guava 16.0.
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.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.ImmutableCollection.removeAll(Collection) Unsupported operation.
com.google.common.collect.ImmutableMultimap.removeAll(Object) Unsupported operation.
com.google.common.collect.ImmutableListMultimap.removeAll(Object) Unsupported operation.
com.google.common.collect.ImmutableSetMultimap.removeAll(Object) Unsupported operation.
com.google.common.collect.ImmutableMultimap.replaceValues(K, Iterable) Unsupported operation.
com.google.common.collect.ImmutableListMultimap.replaceValues(K, Iterable) Unsupported operation.
com.google.common.collect.ImmutableSetMultimap.replaceValues(K, Iterable) Unsupported operation.
com.google.common.collect.ImmutableCollection.retainAll(Collection) Unsupported operation.
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.collect.MapMaker.softValues() Caching functionality in MapMaker has been moved to CacheBuilder, with MapMaker.softValues() being replaced by CacheBuilder.softValues(). Note that CacheBuilder is simply an enhanced API for an implementation which was branched from MapMaker. This method is scheduled for deletion in September 2014.
com.google.common.collect.GenericMapMaker.softValues() Caching functionality in MapMaker has been moved to CacheBuilder, with GenericMapMaker.softValues() being replaced by CacheBuilder.softValues(). Note that CacheBuilder is simply an enhanced API for an implementation which was branched from MapMaker. This method is scheduled for deletion in August 2014.
com.google.common.collect.ForwardingSortedMap.standardRemove(Object) This implementation is extremely awkward, is rarely worthwhile, and has been discovered to interact badly with http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6467933 in Java 6 when used with certain null-friendly comparators. It is scheduled for deletion in Guava 16.0.
com.google.common.hash.Funnels.stringFunnel() Use Funnels.unencodedCharsFunnel() instead. This method is scheduled for removal in Guava 16.0.
com.google.common.collect.Iterables.unmodifiableIterable(ImmutableCollection) no need to use this
com.google.common.collect.Iterators.unmodifiableIterator(UnmodifiableIterator) no need to use this
com.google.common.collect.Multimaps.unmodifiableListMultimap(ImmutableListMultimap) no need to use this
com.google.common.collect.Multimaps.unmodifiableMultimap(ImmutableMultimap) no need to use this
com.google.common.collect.Multisets.unmodifiableMultiset(ImmutableMultiset) no need to use this
com.google.common.collect.Multimaps.unmodifiableSetMultimap(ImmutableSetMultimap) no need to use this
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(Charsets.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 Constructors

Constructor and Description
com.google.common.base.Stopwatch() Use Stopwatch.createUnstarted() instead. This constructor is scheduled to be remove in Guava release 17.0.
com.google.common.base.Stopwatch(Ticker) Use Stopwatch.createUnstarted(Ticker) instead. This constructor is scheduled to be remove in Guava release 17.0.