Flattening Nested Collections in Java

1. Overview

In this quick article, we’ll explore how to flatten a nested collection in Java.

2. Example of a Nested Collection

Suppose we have a list of lists of type String.

List<List<String>> nestedList = asList(
  asList("two:one", "two:two", "two:three"), 
  asList("three:one", "three:two", "three:three", "three:four"));

3. Flattening the List With forEach

In order to flatten this nested collection into a list of strings, we can use forEach together with a Java 8 method reference:

public <T> List<T> flattenListOfListsImperatively(
    List<List<T>> nestedList) {
    List<T> ls = new ArrayList<>();
    return ls;

And here you can see the method in action:

public void givenNestedList_thenFlattenImperatively() {
    List<String> ls = flattenListOfListsImperatively(nestedList);
    assertTrue(ls.size() == 8);
    assertThat(ls, IsIterableContainingInOrder.contains(
      "two:one", "two:two", "two:three", "three:one",
      "three:two", "three:three", "three:four"));

4. Flattening the List With flatMap

We can also flatten the nested list by utilizing the flatMap method from the Stream API.

This allows us to flatten the nested Stream structure and eventually collect all elements to a particular collection:

public <T> List<T> flattenListOfListsStream(List<List<T>> list) {
    return list.stream()

And here’s the logic in action:

public void givenNestedList_thenFlattenFunctionally() {
    List<String> ls = flattenListOfListsStream(nestedList);
    assertTrue(ls.size() == 8);

5. Conclusion

A simple forEach or flatMap methods in Java 8, in combination with method references, can be used for flattening nested collections.

You can find the code discussed in this article over on GitHub.

Related posts:

ExecutorService – Waiting for Threads to Finish
Introduction to Spring Security Expressions
Java Program for Douglas-Peucker Algorithm Implementation
Các kiểu dữ liệu trong java
Remove HTML tags from a file to extract only the TEXT
Java Program to Check if a Given Set of Three Points Lie on a Single Line or Not
Java Program to Implement SimpeBindings API
Check If Two Lists are Equal in Java
A Custom Data Binder in Spring MVC
Java Program to Test Using DFS Whether a Directed Graph is Weakly Connected or Not
Using a List of Values in a JdbcTemplate IN Clause
Performance Difference Between save() and saveAll() in Spring Data
Transaction Propagation and Isolation in Spring @Transactional
Java – Write a Reader to File
Spring @RequestMapping New Shortcut Annotations
Spring JDBC
Java Program to Implement Min Hash
Using the Map.Entry Java Class
Java – Convert File to InputStream
Add Multiple Items to an Java ArrayList
Spring Security 5 – OAuth2 Login
Java Program to Implement CopyOnWriteArrayList API
Java Program to Implement Patricia Trie
Giới thiệu Aspect Oriented Programming (AOP)
Java Switch Statement
Java Program to Give an Implementation of the Traditional Chinese Postman Problem
Java Program to Find the Minimum Element of a Rotated Sorted Array using Binary Search approach
Các nguyên lý thiết kế hướng đối tượng – SOLID
So sánh HashMap và Hashtable trong Java
The Spring @Controller and @RestController Annotations
Configure a Spring Boot Web Application
Comparing Strings in Java