Vavr for Java: Complete Guide to Functional Programming

\n\n

1. What is Vavr and why is it needed?

\n\n

Vavr (formerly known as Javaslang) is a powerful library for functional programming in Java that provides immutable collections, functional data structures, and utilities for working with higher-order functions. Unlike the standard Java Collections Framework, Vavr emphasizes immutability and code expressiveness, allowing you to write more predictable, thread-safe, and concise programs.

\n\n

Why is Vavr needed? Modern Java (starting from version 8) introduced lambda expressions and the Stream API, but standard collections remained mutable. This leads to side effects, complexities in multithreaded programming, and the need to write a lot of boilerplate code. Vavr solves these problems by offering:

\n

\n
• Immutable collections (List, Set, Map) with a rich API similar to Scala or Kotlin.
\n
• Option, Try, Either, Validation types for safe handling of null, exceptions, and errors without try-catch blocks.
\n
• Tuples for grouping values of different types without creating DTOs.
\n
• Functional interfaces (FunctionN, CheckedFunction) with composition, memoization, and partial application.
\n
• Lazy evaluation (Lazy) and Pattern Matching.
\n

\n\n

Vavr is especially useful in projects requiring high reliability (financial systems, data processing), multithreading (immutability simplifies parallelism), or simply a desire to write more declarative and clean code. It does not replace standard Java but complements it, allowing you to choose the right tool for each task.

\n\n

2. Installation

\n\n

Vavr is distributed via Maven Central. To add it to your project, use one of the build systems:

\n\n

Maven

\n

<dependency>\n    <groupId>io.vavr</groupId>\n    <artifactId>vavr</artifactId>\n    <version>0.10.4</version>\n</dependency>

\n\n

Gradle

\n

implementation 'io.vavr:vavr:0.10.4'

\n\n

Gradle (Kotlin DSL)

\n

implementation("io.vavr:vavr:0.10.4")

\n\n

For Java 9+ module system, add to module-info.java:

\n

requires vavr;

\n\n

The current version at the time of writing is 0.10.4 (released in 2019, but stable and widely used). Check the latest version on MVNRepository.

\n\n

3. Quick Start — Minimal Working Example

\n\n

Create a class VavrDemo.java and run it:

\n\n

import io.vavr.collection.List;\nimport io.vavr.control.Option;\n\npublic class VavrDemo {\n    public static void main(String[] args) {\n        // Create an immutable list\n        List<Integer> numbers = List.of(1, 2, 3, 4, 5);\n\n        // Functional transformation\n        List<Integer> doubled = numbers\n            .filter(n -> n % 2 == 0)   // even numbers\n            .map(n -> n * 2);          // double\n\n        System.out.println(doubled); // List(4, 8)\n\n        // Option instead of Optional\n        Option<String> maybeName = Option.of("Alice");\n        String greeting = maybeName\n            .map(name -> "Hello, " + name)\n            .getOrElse("Hello, stranger");\n\n        System.out.println(greeting); // Hello, Alice\n    }\n}

\n\n

This example demonstrates two key features: immutable collections with method chaining and safe null handling via Option.

\n\n

4. Main Methods