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.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.hash.HashCodes Use the duplicated methods in HashCode instead. This class is scheduled to be removed in Guava 16.0.

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.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.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.ImmutableMultimap.clear() Unsupported operation.
com.google.common.collect.ArrayTable.clear() Use ArrayTable.eraseAll()
com.google.common.collect.ImmutableTable.clear() Unsupported operation.
com.google.common.collect.ImmutableCollection.clear() Unsupported operation.
com.google.common.io.Closeables.closeQuietly(Closeable) Where possible, use the try-with-resources statement if using JDK7 or Closer on JDK6 to close one or more Closeable objects. This method is deprecated because it is easy to misuse and may swallow IO exceptions that really should be thrown and handled. See Guava issue 1118 for a more detailed explanation of the reasons for deprecation and see Closing Resources for more information on the problems with closing Closeable objects and some of the preferred solutions for handling it correctly. This method is scheduled to be removed in Guava 16.0.
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.io.BaseEncoding.decodingStream(InputSupplier) Use BaseEncoding.decodingSource(CharSource) instead. This method is scheduled to be removed in Guava 16.0.
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.io.BaseEncoding.encodingStream(OutputSupplier) Use BaseEncoding.encodingSink(CharSink) instead. This method is scheduled to be removed in Guava 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.hash.HashCodes.fromBytes(byte[]) Use HashCode.fromBytes(byte[]) instead. This method is scheduled to be removed in Guava 16.0.
com.google.common.hash.HashCodes.fromInt(int) Use HashCode.fromInt(int) instead. This method is scheduled to be removed in Guava 16.0.
com.google.common.net.InternetDomainName.fromLenient(String) Use InternetDomainName.from(String)
com.google.common.hash.HashCodes.fromLong(long) Use HashCode.fromLong(long) instead. This method is scheduled to be removed in Guava 16.0.
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.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.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.FileBackedOutputStream.getSupplier() Use FileBackedOutputStream.asByteSource() instead. This method is scheduled to be removed in Guava 16.0.
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.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.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.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. This method is scheduled for removal in Guava 16.0.
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.ArrayTable.remove(Object, Object) Use ArrayTable.erase(java.lang.Object, java.lang.Object)
com.google.common.collect.ImmutableTable.remove(Object, Object) Unsupported operation.
com.google.common.collect.ImmutableCollection.removeAll(Collection) Unsupported operation.
com.google.common.collect.ImmutableListMultimap.removeAll(Object) 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.replaceValues(K, Iterable) Unsupported operation.
com.google.common.collect.ImmutableMultimap.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.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.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.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.util.concurrent.AbstractExecutionThreadService.start()
com.google.common.util.concurrent.ForwardingService.start()
com.google.common.util.concurrent.Service.start() Use Service.startAsync() instead of this method to start the Service or use a Service.Listener to asynchronously wait for service startup.
com.google.common.util.concurrent.AbstractService.start()
com.google.common.util.concurrent.AbstractIdleService.start()
com.google.common.util.concurrent.AbstractScheduledService.start()
com.google.common.util.concurrent.AbstractExecutionThreadService.startAndWait()
com.google.common.util.concurrent.ForwardingService.startAndWait()
com.google.common.util.concurrent.Service.startAndWait() Use Service.startAsync() and Service.awaitRunning() instead of this method.
com.google.common.util.concurrent.AbstractService.startAndWait()
com.google.common.util.concurrent.AbstractIdleService.startAndWait()
com.google.common.util.concurrent.AbstractScheduledService.startAndWait()
com.google.common.util.concurrent.AbstractExecutionThreadService.stop()
com.google.common.util.concurrent.ForwardingService.stop()
com.google.common.util.concurrent.Service.stop() Use Service.stopAsync() instead of this method to initiate service shutdown or use a service Service.Listener to asynchronously wait for service shutdown.
com.google.common.util.concurrent.AbstractService.stop()
com.google.common.util.concurrent.AbstractIdleService.stop()
com.google.common.util.concurrent.AbstractScheduledService.stop()
com.google.common.util.concurrent.AbstractExecutionThreadService.stopAndWait()
com.google.common.util.concurrent.ForwardingService.stopAndWait()
com.google.common.util.concurrent.Service.stopAndWait() Use Service.stopAsync() and Service.awaitTerminated() instead of this method.
com.google.common.util.concurrent.AbstractService.stopAndWait()
com.google.common.util.concurrent.AbstractIdleService.stopAndWait()
com.google.common.util.concurrent.AbstractScheduledService.stopAndWait()
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 removed in Guava release 17.0.
com.google.common.base.Stopwatch(Ticker) Use Stopwatch.createUnstarted(Ticker) instead. This constructor is scheduled to be removed in Guava release 17.0.