Coming changes to Google Collections

[Kevin Bourrillion]

Folks, I've made the next month's worth of changes in subversion, but will not be regenerating a new build (+ javadocs, etc.) until RC1.  Here are the changes made so far vs. snapshot-20090211.

New stuff

Join replaced by Joiner, a much more flexible API.
Collections2.transform() (counterpart to Iterables.transform(), Lists.transform()).
Maps.difference() computes the difference between two maps as a MapDifference.
Multisets.immutableEntry().
New @GwtCompatible annotation; inert for now.
New setCount() methods on Multiset.

Changed stuff

Removed Multiset.removeAllOccurrences() (use setCount(0) or elementSet().remove()).

Multiset methods add(E, int) and remove(E, int) now return the previous count of the element.
Most Multimap factory methods moved to the Multimap implementation classes.
Deleted our @Nullable annotation; we use the jsr305 annotation now.
Removed Itera*s.containsNull(it); use Itera*s.contains(it, null).
Removed Preconditions.checkContentsNotNull(); make a defensive copy using Immutable*.copyOf() instead
Various generics-related changes in method signatures (adding wildcards, removing wildcards, etc.)

Tests

28K unit tests now checked in. Not all pass, due to misc. issues; will continue to work on it.
There is a lot of redundant test code that should be cleaned out.

Any feedback is welcome.

--
Kevin Bourrillion @ Google
internal:  http://go/javalibraries
google-collections.googlecode.com
google-guice.googlecode.com

[Dennis Benzinger]

Hi Kevin!

Am 17.03.2009 04:14, Kevin Bourrillion schrieb:
> Folks, I've made the next month's worth of changes in subversion, but will
> not be regenerating a new build (+ javadocs, etc.) until RC1.

> [...]

Is there a release schedule for the RCs?

Dennis Benzinger

[Kevin Bourrillion]

RC1 by April 1 -- no, seriously. :-) 

I'll be counting on as many of you to adopt it as can; that's the only way 1.0-RC* can ever become 1.0!

[Kevin Bourrillion]

One more week.  Again, these changes are in subversion but I'm not generating jars until the RC is ready soon soon.


New:

ImmutableSetMultimap
ImmutableClassToInstanceMap
Predicates.instanceOf()

Changed:

The last of the Multimap factory methods, Multimaps.newTreeMultimap(), is finally moved (TreeMultimap.create()); very sorry for all the transitional pain
Likewise, Maps.newClassToInstanceMap() --> MutableClassToInstanceMap.create()
Small behavior changes - please reread javadocs if you use these:
  - Maps.fromProperties(),
  - Multimaps.index()
  - Ordering.givenOrder()

Removed:

CustomConcurrentHashMap is no longer public. We aren't ready to stabilize its API any time soon.
Multimaps.index(3-arg version) is not useful; use the 2-arg version.