Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
com.google.common.io.InputSupplier For InputSupplier<? extends InputStream>, use ByteSource instead. For InputSupplier<? extends Reader>, use CharSource. Implementations of InputSupplier that don't fall into one of those categories do not benefit from any of the methods in common.io and should use a different interface. This interface is scheduled for removal in June 2015.
com.google.common.io.OutputSupplier For OutputSupplier<? extends OutputStream>, use ByteSink instead. For OutputSupplier<? extends Writer>, use CharSink. Implementations of OutputSupplier that don't fall into one of those categories do not benefit from any of the methods in common.io and should use a different interface. This interface is scheduled for removal in June 2015.

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.ImmutableCollection.addAll(Collection) Unsupported operation.
com.google.common.collect.ImmutableList.addAll(int, Collection) 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.io.ByteStreams.asByteSink(OutputSupplier) Convert all OutputSupplier<? extends OutputStream> implementations to extend ByteSink or provide a method for viewing the object as a ByteSink. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.asByteSource(InputSupplier) Convert all InputSupplier<? extends InputStream> implementations to extend ByteSource or provide a method for viewing the object as a ByteSource. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.asCharSink(OutputSupplier) Convert all OutputSupplier<? extends Appendable> implementations to extend CharSink or provide a method for viewing the object as a CharSink. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.asCharSource(InputSupplier) Convert all InputSupplier<? extends Readable> implementations to extend CharSource or provide a method for viewing the object as a CharSource. This method is scheduled for removal in Guava 18.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.ArrayTable.clear() Use ArrayTable.eraseAll()
com.google.common.collect.ImmutableCollection.clear() Unsupported operation.
com.google.common.collect.ImmutableMultimap.clear() Unsupported operation.
com.google.common.collect.ImmutableTable.clear() Unsupported operation.
com.google.common.collect.ImmutableMap.clear() Unsupported operation.
com.google.common.io.Files.copy(File, Charset, OutputSupplier) Use Files.asCharSource(from, charset).copyTo(to) after changing to to a CharSink if necessary. This method is scheduled to be removed in Guava 18.0.
com.google.common.io.Files.copy(File, OutputSupplier) Use Files.asByteSource(from).copyTo(to) after changing to to a ByteSink if necessary. This method is scheduled to be removed in Guava 18.0.
com.google.common.io.ByteStreams.copy(InputStream, OutputSupplier) Use ByteSink.writeFrom(InputStream) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.Files.copy(InputSupplier, File) Use from.copyTo(Files.asByteSink(to)) after changing from to a ByteSource if necessary. This method is scheduled to be removed in Guava 18.0.
com.google.common.io.ByteStreams.copy(InputSupplier, OutputStream) Use ByteSource.copyTo(OutputStream) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.copy(InputSupplier, OutputSupplier) Use ByteSource.copyTo(ByteSink) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.copy(InputSupplier, Appendable) Use CharSource.copyTo(Appendable) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.Files.copy(InputSupplier, File, Charset) Use from.copyTo(Files.asCharSink(to, charset)) after changing from to a CharSource if necessary. This method is scheduled to be removed in Guava 18.0.
com.google.common.io.CharStreams.copy(InputSupplier, OutputSupplier) Use {@link CharSource#copyTo(CharSink) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.equal(InputSupplier, InputSupplier) Use ByteSource.contentEquals(ByteSource) instead. This method is scheduled for removal in Guava 18.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.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. This method is scheduled for removal in Guava 18.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. This method is scheduled for removal in Guava 18.0.
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. This method is scheduled for removal in Guava 18.0.
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. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.hash(InputSupplier, HashFunction) Use ByteSource.hash(HashFunction) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.join(InputSupplier...) Use ByteSource.concat(ByteSource[]) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.join(InputSupplier...) Use CharSource.concat(CharSource[]) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.join(Iterable>) Use ByteSource.concat(Iterable) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.join(Iterable>) Use CharSource.concat(Iterable) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.length(InputSupplier) Use ByteSource.size() instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.newInputStreamSupplier(byte[]) Use ByteSource.wrap(byte[]) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.newInputStreamSupplier(byte[], int, int) Use ByteSource.wrap(b).slice(off, len) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.Files.newInputStreamSupplier(File) Use Files.asByteSource(File). This method is scheduled for removal in Guava 18.0.
com.google.common.io.Resources.newInputStreamSupplier(URL) Use Resources.asByteSource(URL) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.Files.newOutputStreamSupplier(File) Use #asByteSink(File). This method is scheduled for removal in Guava 18.0.
com.google.common.io.Files.newOutputStreamSupplier(File, boolean) Use Files.asByteSink(File, FileWriteMode...), passing FileWriteMode.APPEND for append. This method is scheduled for removal in Guava 18.0.
com.google.common.io.Files.newReaderSupplier(File, Charset) Use Files.asCharSource(File, Charset). This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.newReaderSupplier(InputSupplier, Charset) Use ByteSource.asCharSource(Charset) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.newReaderSupplier(String) Use CharSource#wrap(CharSequence} instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.Resources.newReaderSupplier(URL, Charset) Use Resources.asCharSource(URL, Charset) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.Files.newWriterSupplier(File, Charset) Use #asCharSink(File, Charset). This method is scheduled for removal in Guava 18.0.
com.google.common.io.Files.newWriterSupplier(File, Charset, boolean) Use Files.asCharSink(File, Charset, FileWriteMode...), passing FileWriteMode.APPEND for append. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.newWriterSupplier(OutputSupplier, Charset) Use ByteSink.asCharSink(Charset) instead. This method is scheduled for removal in Guava 18.0.
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.ImmutableMultimap.put(K, V) Unsupported operation.
com.google.common.collect.ImmutableMap.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.io.ByteStreams.readBytes(InputSupplier, ByteProcessor) Use ByteSource.read(ByteProcessor) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.readFirstLine(InputSupplier) Use CharSource.readFirstLine() instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.readLines(InputSupplier) Use CharSource.readLines() instead, but note that it returns an ImmutableList. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.readLines(InputSupplier, LineProcessor) Use CharSource.readLines(LineProcessor) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.collect.UnmodifiableIterator.remove() Unsupported operation.
com.google.common.collect.ImmutableList.remove(int) Unsupported operation.
com.google.common.collect.ImmutableCollection.remove(Object) Unsupported operation.
com.google.common.collect.ImmutableMap.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.ImmutableCollection.removeAll(Collection) 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.removeAll(Object) 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.ImmutableListMultimap.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.io.ByteStreams.slice(InputSupplier, long, long) Use ByteSource#slice(int, int) instead. This method is scheduled for removal in Guava 18.0.
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.util.concurrent.AbstractIdleService.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.AbstractExecutionThreadService.start()
com.google.common.util.concurrent.AbstractScheduledService.start()
com.google.common.util.concurrent.AbstractIdleService.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.AbstractExecutionThreadService.startAndWait()
com.google.common.util.concurrent.AbstractScheduledService.startAndWait()
com.google.common.util.concurrent.AbstractIdleService.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.AbstractExecutionThreadService.stop()
com.google.common.util.concurrent.AbstractScheduledService.stop()
com.google.common.util.concurrent.AbstractIdleService.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.AbstractExecutionThreadService.stopAndWait()
com.google.common.util.concurrent.AbstractScheduledService.stopAndWait()
com.google.common.io.ByteStreams.toByteArray(InputSupplier) Use ByteSource.read() instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.toString(InputSupplier) Use CharSource.read() instead. This method is scheduled for removal in Guava 18.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.base.Enums.valueOfFunction(Class) Use Enums.stringConverter(java.lang.Class<T>) instead. Note that the string converter has slightly different behavior: it throws IllegalArgumentException if the enum constant does not exist rather than returning null. It also converts null to null rather than throwing NullPointerException. This method is scheduled for removal in Guava 18.0.
com.google.common.io.ByteStreams.write(byte[], OutputSupplier) Use ByteSink.write(byte[]) instead. This method is scheduled for removal in Guava 18.0.
com.google.common.io.CharStreams.write(CharSequence, OutputSupplier) Use CharSink.write(CharSequence) instead. This method is scheduled for removal in Guava 18.0.
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.