Take the 2-minute tour ×
Programmers Stack Exchange is a question and answer site for professional programmers interested in conceptual questions about software development. It's 100% free, no registration required.

I wonder why java.util.ArrayList allows to add null. Is there any case where I would want to add null to an ArrayList?

I am asking this question because in a project we had a bug where some code was adding nulls to the List and it was hard to spot where the bug was. Obviously a NullPointerException was thrown but not until another code tried to access the element. The problem was how to locate the code that added the null object. It would have been easier if the ArrayList throwed an exception in the code where the elements was being added.

share|improve this question
The Guava Project has a pretty interesting page on that topic (they don't allow null in most of their collections). –  Joachim Sauer Sep 3 '12 at 15:09
I believe that the answers given here cover well the question. Maybe one thing that should be mentioned is: don't take everything that's in the JDK as holly and perfect, and then whack your head trying to understand why it is so "perfect". Some things are (honest, IMHO) mistakes, that remained there due to backwards compatibility and that's that. Even the Java creators admit it, just read Joshua Bloch's books to see his critique of certain Java APIs. At any rate, your question comes down to weather there isn't a more elegant way to catch NPE in Java. The answer is, no, but there should be. –  Shivan Dragon Sep 3 '12 at 15:13
Can you provide more information on why it should not be allowed? If it is just a matter of taste, then the less restrictive should be prefered. –  Mare Infinitus Jul 16 at 10:54

6 Answers 6

up vote 18 down vote accepted

This design decision appears mostly driven by naming.

Name ArrayList suggests to reader a functionality similar to arrays - and it is natural for Java Collections Framework designers to expect that vast majority of API users will rely on it functioning similar to arrays.

This in particular, involves treatment of null elements. API user knowing that below works OK:

array[0] = null; // NPE won't happen here

would be quite surprised to find out if similar code for ArrayList would throw NPE:

arrayList.set(0, null); // NPE => WTF?

Reasoning like above is presented in JCF tutorial stressing points that suggest close similarity between ArrayList and plain arrays:

ArrayList... offers constant-time positional access and is just plain fast...

If you would want a List implementation disallowing nulls, it would better be called like NonNullableArrayList or something like that, to avoid confusing API users.

share|improve this answer
also arrayList.add(null); give NPE ! –  LOG_TAG Oct 21 '13 at 11:44
No, it doesn't. –  JohnEye Mar 17 at 12:32
@LOG_TAG because your arrayList is null. –  Sufian May 29 at 6:21
This explanation is not convincing, considering that LinkedList also supports null list entries. –  Stephen C Jul 16 at 11:50
Yea ... but a simpler and (IMO) more plausible explanation is that allowing null entries is useful in a lot of cases. –  Stephen C Jul 21 at 22:48

Null may be a valid value for an element of a list. Say your list contains elements which represent some optional data about a list of users and is stored in the same order as the users. If the extra data is populated then your list will contain the additional data otherwise the slot corresponding to a user will be null. (I'm sure there are better examples, but you get the idea)

if you don't want to allow nulls to be added then you could wrap the array list with your own wrapper which threw when null was added.

share|improve this answer
That seems like a bad example of why nulls should be allowed -- there's better ways of representing optional data than using null values in a list. –  casablanca Sep 4 '12 at 3:34
@casablanca yeah totally agree, its not a great example. –  Sam Holder Sep 4 '12 at 7:26
I can't find a good reason for a ArrayList to contain nulls, other then bad surprises for the next developer to 'discover' it :/ –  AndreasScheinert Sep 4 '12 at 10:58
@casablanca While I agree with you that nulls should be avoided for representing optional data, in Java, for better or worse, that is "traditional". –  user949300 Sep 15 at 18:16

Is there any case where I would want to add null to an ArrayList?

Sure, what about pre-allocation? You want an ArrayList of things you can't create yet because you don't have enough info. Just because you can't think of a reason why someone may want to do something doesn't make it a bad idea. Whatever. (Now, I'm sure someone will come along and say you should instead have empty objects that fulfill some pattern they read about on some obscure blog and that programmers should really be able to write programs without ever using if statements, blah blah.)

If you guys have a contract that there never should be nulls in a container then it's up to you lot to make sure that contract is upheld, probably most appropriately by asserting. It would probably have taken you max 10 lines of code. Java makes it incredibly easy for you to do this sort of thing. The JDK cannot read your mind.

share|improve this answer
Your preallocation argument is invalid, because this is already build into ArrayList with the ensureCapacity(int minCapacity) method and the ArrayList(int initialCapacity) constructor. –  Philipp Sep 15 at 15:10
@Philipp What values will it put into that space? –  James Sep 15 at 17:25

ArrayList allows null by design. It is intentional. From the javadoc:

"[ArrayList is a] resizable-array implementation of the List interface. Implements all optional list operations, and permits all elements, including null."

The answer to "why" is that if it didn't the ArrayList wouldn't be usable in cases where it is necessary to put a null in the list. By contrast, you can prevent an ArrayList from containing nulls by either testing values before adding them or using a wrapper that prevents this happening.

Is there any case where I would want to add null to an ArrayList?

Obviously, any case where null has a distinct meaning. For instance it might mean that the value at a given position in the list has not been initialized or supplied.

It would have been easier if the ArrayList had thrown an exception in the code where the elements was being added.

You could easily implement that behaviour by creating a wrapper class. However, this is not the behaviour that most programmers / applications need.

share|improve this answer
The question was about use cases where this would be useful. The OP already acknowledges that they know it's possible to add nulls –  Gareth Sep 3 '12 at 14:54
@Gareth - I know that, but I can't type that quickly. –  Stephen C Sep 3 '12 at 14:55
Aha, ninja edit ;) –  Gareth Sep 3 '12 at 14:56

This seems to be more of a (software-)philosophic question here.

ArrayList as a utility class is designed to be helpful in a wide context of possible use-cases.

Contrary to your hidden claim that accepting null as a valid value should be discouraged, there are many examples where the null value is perfectly legal.

The single most important reason is that null is the do not know equivalent of any reference type, including framework types. So null cannot be replaced in any case by a more fluent version of the nothing value.

share|improve this answer

It is easier to accept everything, than to be to be restrictive and then try opening up your design after the fact.

For example, what if they oracle/sun provided only NonNullableArrayList, but you wanted to be able to add a Null to your list. How would you do it? You would probably have to create an entirely different object, you couldn't use extend the NonNullableArrayList. Instead if you have a ArrayList that takes everything, you could easily extend it, and override the add, where it doesn't accept null values.

share|improve this answer
Disagreed. Allowing too much is harder to correct once the misfeature has seen widespread use. If language designers allowed nulls at a later stage, it wouldn't break existing programs, but the opposite is not true. –  Andres F. Sep 3 '12 at 16:49
But I agree. It is about maximizing functionality. You can use a list that accepts nulls even you don't need them. You cannot use a list that refuses nulls if you need nulls. –  Florian F Sep 14 at 7:01

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.