Skip to content

Release22

Jump to bottom
Colin Decker edited this page May 8, 2017 · 7 revisions

Guava Release 22.0: Release Notes

  • 22.0-rc1 was released on May 2, 2017.

(See ReleaseHistory.)

New: Android version

The main Guava artifact (22.0-rc1) requires Java 8, as it has since 21.0.

New in 22.0 is a version of Guava targeted at Android, differentiated by its version number: 22.0-rc1-android.

While the focus of this version is on Android, it's also the version you should use if you need to target Java 7.

We're using version number rather than artifact ID to differentiate so that Maven can detect both versions being in its dependency tree; having both in the dependency tree should be avoided. The intent is that the Android version always be a strict subset of what's available in the main/Java 8 version, so anything compiled against version N of the Android version will work when run against the Java 8 version. So if you're a libarary depending on Guava and want to support Android and/or Java 7 users, you should depend on the -android version.

So what's different in the Android version?

  • Primarily, Java 8-specific changes made in 21.0 are not present. Nothing extends new Java 8 types and APIs for supporting new Java 8 APIs are removed. See the API diffs between the Java 8 and Android versions for specifics.
  • While not Java 8, the MoreFiles class (added in 21.0) is not present because it requires (and is only useful with) support for the java.nio.file APIs, which are not supported on Android.
  • Some optimizations have been made to a number of data structures (primarily our ImmutableCollection implementations) to make them better for use on Android: lower memory footprint and less garbage generated in their use, for example.

API documentation

Java 8:

Android / Java 7:

Using Guava in your project

Guava Guava (Android) Guava (GWT)
Maven Identifier com.google.guava:guava:22.0-rc1 com.google.guava:guava:22.0-rc1-android com.google.guava:guava-gwt:22.0-rc1
Jar guava-22.0-rc1.jar guava-22.0-rc1-android.jar guava-gwt-22.0-rc1.jar
Javadoc guava-22.0-rc1-javadoc.jar guava-22.0-rc1-android-javadoc.jar guava-gwt-22.0-rc1-javadoc.jar
Sources guava-22.0-rc1-sources.jar guava-22.0-rc1-android-sources.jar guava-gwt-22.0-rc1-sources.jar

See UseGuavaInYourBuild for help integrating Guava into your build environment.

Issues resolved

9+ issues are resolved in this release.

API Changes

Significant API additions and changes

(For Android, see the changes for 21.0, ignoring those that are Java 8 specific, or the JDiff report linked above.)

common.primitives

New immutable primitive array types! Think of these as ImmutableList for primitive types (but not implementing List directly).

  • ImmutableIntArray and .Builder
  • ImmutableLongArray and .Builder
  • ImmutableDoubleArray and .Builder

common.base

  • Stopwatch.elapsed(): returns the elapsed time as a java.time.Duration .
  • Throwables.getCauseAs(Throwable, Class<X>): a way of getting the cause of an exception and casting it to a specific type without losing the original exception stack trace if the cause is not that type.

common.collect

  • Comparators.empties(First|Last)(): Comparators for java.util.Optionals
  • Comparators.(least|greatest)(k, Comparator): Collectors for collecting the least/greatest k elements (according to a Comparator) from a Stream to a List (faster and more memory efficient than sorting and limiting the stream).
  • New Collectors for Multisets and Immutable(Sorted)Multisets that take a ToIntFunction to get counts for elements.
  • RangeMap.putCoalescing(Range<K>, V)
  • Streams.forEachPair(Stream, Stream, BiConsumer): For-each over pairs of corresponding elements from two streams.
  • Tables.synchronizedTable(Table)

common.graph

A variety of changes here. See API diffs for graph.

common.hash

  • BloomFilter.approximateElementCount(): Estimate of the number of distinct elements that have been added to the Bloom filter.
  • Hashing.md5() and Hashing.sha1(): Deprecated. Will continue to exist to allow interoperation with systems requiring them.

common.io

  • CharSink.writeLines(Stream[, String]): Methods for writing elements of a Stream of CharSequences as lines to a CharSink.
  • CharSource.lines(): Returns a Stream<String> (which must be closed!) of lines of text from a CharSource.
  • CharSource.forEachLine(Consumer): For-each over the lines of text in a CharSource.
  • Files: Many methods that are redundant with creating a source or sink for a file and calling a method on it are now deprecated.
  • MoreFiles.equal(Path, Path): Returns whether or not two files are regular files containing the same bytes.

common.util.concurrent

  • CheckedFuture: Deprecated. (See the javadoc for details.)
  • TimeLimiter: callWithTimeout (taking a boolean interruptible) deprecated; callWithTimeout, callUninterruptiblyWithTimeout, runWithTimeout and runUninterruptiblyWithTimeout added.
Clone this wiki locally