Simplifying Multi-line Strings with Text Blocks in Java

Hello, Java developers! I'm Igor Fraga, and I'm back after a short pause of some days that I've been busy with the book I'm writing (I will bring it here very soon) This is the third post from a series called “The upgraded Java Developer” about the latest Java programming language enhancements to be up to date and use these features in your daily work. We will look into some enhancements Java had during these last years regarding String handling before jumping into more advanced stuff. Today we're exploring Text Blocks, a feature that has revolutionized how we handle multi-line strings in Java. Introduced as a preview feature in Java 13 and standardized in Java 15, Text Blocks are now a robust part of Java 21, offering a cleaner and more intuitive way to work with complex string literals. What are Text Blocks? Text Blocks are a new way to represent multi-line string literals in Java. They allow you to write strings spanning multiple lines without the need for most escape sequences or explicit line breaks. How Text Blocks Work Here's an example of how to use a Text Block: String json = """ { "name": "John Doe", "age": 30, "city": "New York", "hobbies": [ "reading", "swimming", "hiking" ] } """; In this example, the Text Block is denoted by triple quotes (""") and preserves the formatting of the JSON structure. Why are Text Blocks Better? Compared to traditional string concatenation, Text Blocks offer several advantages: Improved Readability: They eliminate the need for escape characters and string concatenation operators. Preserved Formatting: The structure of the text is visually represented in the code. Reduced Errors: Fewer escape sequences mean fewer opportunities for syntax errors. Better Maintainability: Updating multi-line strings becomes much easier. Best Practices Use Text Blocks for multi-line strings like SQL queries, JSON, HTML, or any formatted text. Be mindful of indentation, as it affects the resulting string. Use the \ character at the end of a line to suppress the following new line if needed. Conclusion Text Blocks, fully supported in Java 21, represent a significant improvement in how we handle multi-line strings in Java. They make our code cleaner, more readable, and easier to maintain, especially when dealing with structured text formats like JSON, SQL, or HTML. In our next article, we'll explore String Templates, that is the evolution of Text Blocks that has been introduced in Java 21 and how it has evolved from String concatenation, to Text Blocks and finally into String Templates. See you then!

Mar 21, 2025 - 20:16

Simplifying Multi-line Strings with Text Blocks in Java

Hello, Java developers! I'm Igor Fraga, and I'm back after a short pause of some days that I've been busy with the book I'm writing (I will bring it here very soon)

This is the third post from a series called “The upgraded Java Developer” about the latest Java programming language enhancements to be up to date and use these features in your daily work. We will look into some enhancements Java had during these last years regarding String handling before jumping into more advanced stuff.

Today we're exploring Text Blocks, a feature that has revolutionized how we handle multi-line strings in Java. Introduced as a preview feature in Java 13 and standardized in Java 15, Text Blocks are now a robust part of Java 21, offering a cleaner and more intuitive way to work with complex string literals.

What are Text Blocks?

Text Blocks are a new way to represent multi-line string literals in Java. They allow you to write strings spanning multiple lines without the need for most escape sequences or explicit line breaks.

How Text Blocks Work

Here's an example of how to use a Text Block:

    String json = """
        {
            "name": "John Doe",
            "age": 30,
            "city": "New York",
            "hobbies": [
                "reading",
                "swimming",
                "hiking"
            ]
        }
        """;

In this example, the Text Block is denoted by triple quotes (""") and preserves the formatting of the JSON structure.

Why are Text Blocks Better?

Compared to traditional string concatenation, Text Blocks offer several advantages:

Improved Readability: They eliminate the need for escape characters and string concatenation operators.
Preserved Formatting: The structure of the text is visually represented in the code.
Reduced Errors: Fewer escape sequences mean fewer opportunities for syntax errors.
Better Maintainability: Updating multi-line strings becomes much easier.

Best Practices

Use Text Blocks for multi-line strings like SQL queries, JSON, HTML, or any formatted text.
Be mindful of indentation, as it affects the resulting string.
Use the \ character at the end of a line to suppress the following new line if needed.

Conclusion

Text Blocks, fully supported in Java 21, represent a significant improvement in how we handle multi-line strings in Java. They make our code cleaner, more readable, and easier to maintain, especially when dealing with structured text formats like JSON, SQL, or HTML.

In our next article, we'll explore String Templates, that is the evolution of Text Blocks that has been introduced in Java 21 and how it has evolved from String concatenation, to Text Blocks and finally into String Templates. See you then!