Tuesday, 25 October 2011

Collection creation and Immutability with Google Guava

So, thought I'd take a look at some of the collection creation patterns Guava offers, and also some of the Immutable collection types it offers.

If you've not seen my previous posts, you may want to start here:

Guava part 1 - MultiMaps
Guava part 2 - BiMaps
Guava part 3 - MultiSets

create methods

All of Guava's collection implementations contain one or more static create methods, these do what you'd expect, and generally offer a slightly more concise way of instantiating the collection classes.

Here are two different ways of creating a ArrayListMultimap

    Multimap<String,String> multimap1 = new ArrayListMultimap<String,String>();
    Multimap<String,String> multimap2 = ArrayListMultimap.create();

Ok, so there's not a huge amount in it - 12 characters in this example - but the way I see it, you're removing some redundancy, do we really need to reproduce the Generic type information twice?

That's nice, it's a shame Sun didn't think to add create methods to their Collection types when the created Java 5!

Again, Guava rides to your rescue here, and provides some utility classes for dealing with the standard collection types. com.google.common.collect.Lists, com.google.common.collect.Sets, and com.google.common.collect.Maps

These each provide several methods of the format newCollectionType(), here's some examples

    List<String> myList1 = new ArrayList<String>(); //old way
    List<String> myList2 = Lists.newArrayList();    //guava way

    Set<String> mySet1 = new HashSet<String>(); //old way
    Set<String> mySet2 = Sets.newHashSet();     //guava way

Since the "new" methods are static, you can cut out even more characters by using a static import ie...

    import static com.google.common.collect.Lists.newArrayList;
    import static com.google.common.collect.Sets.newHashSet;

    //elsewhere in code
    List<String> myList2 = newArrayList();
    Set<String> mySet2 = newHashSet();

Keypress wise you're not really saving a great deal using the guava methods, so I guess this is a matter of taste as much as anything else. Personally I think the Guava way reads much better, although I think I'd go without the static imports.

Good so far, but hardly earth shattering, what next?

Immutable collections

These are essentially collection objects that you can't change once they've been created, and are useful for all sorts of reasons. Guava provides Immutable implementations for most of the regular Collection interfaces: ImmutableList, ImmutableSet, and ImmutableMap , and also immutable implementations of some of the Guava collection interfaces ( ImmutableMultimap etc.)

My main use for them is creating static constants. For example lets say you need to hardcode a Set of Strings for some purpose. One way to do this might be, eg.

    private static final Set<String> farmAnimals =
                new HashSet<String>(Arrays.asList("Cow","Pig","Sheep"));

Doesn't look great does it, and it suffers from one major problem. Any code that can access this Set can also change it, which could lead to all sorts of unexpected problems.

Couldn't we just use Collection.unmodifiableSet(Set s) to solve this?

Well, in this particular example I guess we could write...

    private static final Set<String> farmAnimals =
                new HashSet<String>(Arrays.asList("Cow","Pig","Sheep")));

...but that's starting to look a bit unwieldy, and the unmodifiable methods have one other problem. They only return an unmodifiable view of the collection, if you have a reference to the original collection, you can still alter it!

Whilst this may not be a problem in the last example, I still think a much better way of doing this is to use an ImmutableSet

    private static final Set<String> farmAnimals = 

That's much nicer isn't it! And there's several other ways we can create them, here's some examples:

    // use copyOf()...
    public void doStuffWithList(List<Object> unsafeList) {
       List<Object> safeList = ImmutableList.copyOf(unsafeList);
    // use a builder...
    public Map<String,Integer> makeImmutableMap() {
        ImmutableMap.Builder<String,Integer> mapBuilder = 
                         new ImmutableMap.Builder<String,Integer>();
        Entry<String,Integer> entry = null;
        while((entry = getEntry()) != null) {
            mapBuilder.put(entry.getKey(), entry.getValue());
        return builder.build();
So, any other advantages of using Immutable collections?

Well there's several. They can simplify logic considerably, especially in multi-threaded environments. If threads only have read access to an object, them you don't need to worry about complicated thread synchronization logic

They are also slightly more efficient to use once they've been created. If a collection knows beforehand what it needs to store, and there's never going to be any changes, you can make various time and space savings. For example, most implementations of ArrayLists or HashMaps, will leave some unused space for new objects, so they don't have to constantly resize themselves. If you know there's never going to be any new objects, there's no need for this.

Finally you could also use them as hash keys. If the contents of a collection can't change, then neither will it's hashcode!

Any disadvantages?

There is of course one big disadvantage of Immutable objects, which is pretty obvious. You can't change them! If you need to alter the collection, you'll first need to take a copy of it. In certain situations - ie where concurrency is a concern - you may in fact want to take this approach. However this is going to be impractical where collections contain many many objects and you'll probably want a good old fashioned mutable collection (complete with synchronization code if required).

The only other thing to be aware of is, just because your collection is immutable, it doesn't mean the objects contained in them automatically are. If you can get a reference to an object in an immutable collection, then there's nothing to stop you changing any mutable state on that object! As a consequence it's best practice to make sure anything you keep in an immutable collection is immutable itself!


Krisanth John said...

very nice post, appreciate your efforts. Best essay writing service

Curtis Albert said...

The study of the different subjects and domains of academics is very vital and important. Success in academic papers is achieved by seeking help in assignments service from an expert and the acquisition of knowledge in different stages.
Academic Term Paper Writing Service

Mark Harrington said...


Ive just started to read up on this and have hit a problem After downloading the guava-18 jar file and including this in my net beans project for some reason I don't seem to be able to access the sets class or imutableIterator class

What could I be doing wrong Current Os is linux JDK 8

Cheers Mark

Mique Fahey Kalsder said...

In light of a couple of reasons ravens can't complete last quarter. Their beginning and end partners play without him since some individual hurt ravens http://www.resume2016.com/best-resume-examples-2016/ that is the reason he can't bounce back in this match. His beginning and end partner bid to God for his prosperity and play without him.

Jeffery Morgan said...

Thanks for sharing this code. This is very helpful for us beginners in the programming world. We could certainly toy around this and learn from this. Make a few mistakes perhaps but this guide will be great.

Jeff (click here)

david bruce said...

Can you Write My Essay for Cheap? Yes, we provide Cheap and High-Quality Essay Writing Service with 24/7 Customer Care Support, and 100% Plagiarism Free Paper. You must know that essay writing is not an easy work for the students. It requires in-depth, detailed, and accurate information towards the topic. Especially the essays having the word count of more than 1,000 words are really difficult to write when the students are busy in their exam preparation.

Students want someone in this case to whom they can trust and hand over their assignments. They feel it difficult to lift the burden of the assignments, follow the deadlines, prepare the exams, and make presentations and projects. After all, doing all of this by hand can make students very upset. The Top Academic Tutors is working for the help of students who are not able to do their assignment and want someone to share their burden with.

In the past, students were not able to get the write my essay for me services from professional writers. But now the time has changed. There are many websites providing the online assignment writing services. And we are one of them. We are leading the market of writers for a few years now. Our packages for the students are set according to the financial conditions of the students.

Write my essay is one of our major writing services. Our services have many features and qualities that make our services best for the students. In this service, we write the essay for students or for other customers on the given topics. Your topic of the essay can belong to any subject like business and law, communication or history. We write essays on all subjects.

We have a team that specializes in business, physics, biology, law, history, other natural sciences, and science subjects. Our team of writers writes on all the subjects and topics. The benefits and qualities of our essay help services are discussed later in this article. Read the full article to get complete information about the write my essay for me service.

Faiza Ashraf said...


Faiza Ashraf said...