文本块是JDK增强建议(JEP 355),可以在JDK13JDK14中作为预览语言功能使用。它计划在JDK15中成为永久性功能。文本块是一个字符串文字,它跨越多行,并且不需要大多数转义字符。

动机

在标准 Java 字符串中嵌入XMLJSONSQL之类的格式会变得很烦人。例如,由于需要转义,因此只有两个键的简单JSON代码片段在Java中几乎无法流畅阅读:

String json =
        "{\n" +
            "\"name\": \"FunTester\",\n" +
            "\"age\": 30\n" +
        "}";

文本块来拯救

使用新的文本块功能,我们可以将代码重写为:

String text = """
        {
            "name": "FunTester",
            "age": "30"
        }
        """;

使用三引号"""打开和关闭文本块。文本从下一行开始。打开文本块后,该行的其余部分需要保持空白。

如果我们将此字符串打印到控制台,我们将看到:

{
    "name": "FunTester",
    "age": "30"
}

可能你已经注意到,左侧的缩进已被去除。这是因为文本块的处理分为三个步骤:

前置空格

如果我们明确需要前置空格,则可以使用indent()方法:

String text = """
        {
            "name": "FunTester",
            "age": "30"
        }
        """.indent(4);

这会将 4 个额外的前导空格添加到我们的JSON代码段中。控制台输出看起来像这样:

{
    "name": "FunTester",
    "age": "30"
}

或者,我们可以从封闭的三引号中删除 4 个前导空格以产生相同的结果:

String text = """
        {
            "name": "FunTester",
            "age": "30"
        }
    """; // 将这4个空格向左移动会产生4个额外的前导空格

新的转义序列

使用新的转义序列,我们可以将单行的内容拆分为多行,而无需创建实际的行终止符。

String text = """
        1
        2 \
        3 \
        4
        5
        """;

控制台输出:

1
2 3 4
5

转义三引号

如果我们需要在文本块中写入三引号,则只需要转义第一引号即可:

String text = """
        测试文本 \"""
        """;

控制台输出:

测试文本 """


热文精选


↙↙↙阅读原文可查看相关链接,并与作者交流