1. Introduction
In this quick tutorial, we'll investigate how can we initialize a List using one-liners.
2. Create From an Array
We can create a List from an array and thanks to array literals we can initialize them in one line:
List list = Arrays.asList(
new
String[]{
"foo"
,
"bar"
});
We can trust the varargs mechanism to handle the array creation. By that, we can write more concise and readable code:
public
void
givenArraysAsList_thenInitialiseList() {
List list = Arrays.asList(
"foo"
,
"bar"
);
assertTrue(list.contains(
"foo"
));
}
The result instance of this code implements the List interface but it isn't a java.util.ArrayList nor a LinkedList. Instead, it's a List backed by the original array which has two implications.
Although, the class's name happens to be ArrayList but in the java.util.Arrays package.
2.1. Fixed Size
The result instance from Arrays.asList will have a fixed size:
(expected = UnsupportedOperationException.
class
)
public
void
givenArraysAsList_whenAdd_thenUnsupportedException() {
List list = Arrays.asList(
"foo"
,
"bar"
);
list.add(
"baz"
);
}
2.2. Shared Reference
The original array and the list share the same references to the objects:
public
void
givenArraysAsList_whenCreated_thenShareReference(){
String[] array = {
"foo"
,
"bar"
};
List list = Arrays.asList(array);
array[
0
] =
"baz"
;
assertEquals(
"baz"
, list.get(
0
));
}
3. Create From a Stream (Java 8)
We can easily convert a Stream into any kind of Collection.
Therefore with the factory methods for Streams, we can create and initialize lists in one line:
public
void
givenStream_thenInitializeList(){
List list = Stream.of(
"foo"
,
"bar"
)
.collect(Collectors.toList());
assertTrue(list.contains(
"foo"
));
}
We should mark here that Collectors.toList() doesn't guarantee the exact implementation of the returned List.
There's no general contract about the mutability, serializability or thread-safety of the returned instance. Therefore our code shouldn't rely on any of these properties.
Some sources highlight that Stream.of(…).collect(…) may have larger memory and performance footprint than Arrays.asList() but in almost all cases, it's such a micro-optimization that there is little difference.
4. Factory Methods (Java 9)
In JDK 9, several convenient factory methods have been introduced for collections:
List list = List.of(
"foo"
,
"bar"
,
"baz"
);
Set set = Set.of(
"foo"
,
"bar"
,
"baz"
);
One important detail is the returned instances are immutable. Beyond that, the factory methods have several advantages in space efficiency and thread safety.
This topic is explored more in this article.
5. Double-Brace Initialization
In several places, we can find a method called‘double brace initialization' which looks like:
public
void
givenAnonymousInnerClass_thenInitialiseList() {
List cities =
new
ArrayList() {{
add(
"New York"
);
add(
"Rio"
);
add(
"Tokyo"
);
}};
assertTrue(cities.contains(
"New York"
));
}
The name ‘double brace initialization'is quite misleading. The syntax may look compact and elegant but it dangerously hides what is going under the hood.
There isn't actually a ‘double brace' syntax element in Java, those are two blocks formatted intentionally this way.
With the outer braces, we declare an anonymous inner class which will be a subclass of the ArrayList. Inside these braces, we can declare the details of our subclass.
As usual, we can use instance initializer blocks and that is where the inner pair of braces come from.
The brevity of this syntax is tempting however it's considered an anti-pattern.
To read more about double-brace initialization, have a look at our article here.
6. Conclusion
Modern Java offers several options to create a Collection in one line. The method we chose is almost entirely down to personal preference, rather than technical reasoning.
An important takeaway is that, although it looks graceful, the anti-pattern of anonymous inner class initialization (a.k.a. ‘double brace') has many negative side-effects.
As always, the code is available over on GitHub.