文本块是JDK
增强建议(JEP 355),可以在JDK13和JDK14中作为预览语言功能使用。它计划在JDK15中成为永久性功能。文本块是一个字符串文字,它跨越多行,并且不需要大多数转义字符。
在标准 Java 字符串中嵌入XML
、JSON
或SQL
之类的格式会变得很烦人。例如,由于需要转义,因此只有两个键的简单JSON
代码片段在Java
中几乎无法流畅阅读:
String json =
"{\n" +
"\"name\": \"FunTester\",\n" +
"\"age\": 30\n" +
"}";
使用新的文本块功能,我们可以将代码重写为:
String text = """
{
"name": "FunTester",
"age": "30"
}
""";
使用三引号"""打开和关闭文本块。文本从下一行开始。打开文本块后,该行的其余部分需要保持空白。
如果我们将此字符串打印到控制台,我们将看到:
{
"name": "FunTester",
"age": "30"
}
可能你已经注意到,左侧的缩进已被去除。这是因为文本块的处理分为三个步骤:
LF
字符。这样可以避免不同平台(例如Windows
和Unix
)之间的兼容性问题。\t
或\n
)。请注意,已经添加了两个新的转义序列:\s
用于显式空间,\<eol>
作为连续指示符(稍后在\<eol>
上有更多介绍)。如果我们明确需要前置空格,则可以使用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 = """
测试文本 \"""
""";
控制台输出:
测试文本 """