JDK15新特性：文本块的引入和使用

ゞ浴缸里的玫瑰 2023-10-13 15:48 35阅读 0赞

Text Blocks首次是在JDK 13中以预览功能出现的，然后在JDK 14中又预览了一次，终于在JDK 15中被确定下来，可放心使用了。

文本块是一种多行字符串文字，它避免了大多数转义序列的需要，以一种可预测的方式自动设置字符串的格式，并在需要时使开发人员可以控制格式，简化编写 Java 程序的任务。

文本块建议的目标是提高 Java 程序中的字符串的可读性，这些字符串表示以非 Java 语言编写的代码。

另一个目标是支持从字符串文本迁移，规定任何新构造都可以表达与字符串文本相同的字符串集，解释相同的转义序列，并且以与字符串文本相同的方式进行操作。OpenJDK 开发人员希望添加转义序列来管理显式空白和换行控件。

在Java中，在字符串文字中嵌入HTML，XML，SQL或JSON片段，通常需要先进行转义和串联的大量编辑，然后才能编译包含该片段的代码。该代码段通常难以阅读且难以维护，因此，如果具有一种语言学机制，可以比多行文字更直观地表示字符串，而且可以跨越多行，而且不会出现转义的视觉混乱，那么这将提高广泛Java类程序的可读性和可写性。从JDK13到JDK14开始文本块新特性的提出，提高了Java程序书写大段字符串文本的可读性和方便性。

文本块作为预览特性首次引入Java 13后收到了众多最终用户的反馈。现在，文本块得到了增强，再次作为预览特性出现在Java 14中，目标成为未来JDK版本的标准特性。使用文本块可以轻松表达跨多行源代码的字符串。它提高了Java程序中以非Java语言编写的代码的字符串的可读性；它约定，任何新构造的文本块都可以用字符串相同的字符集表示，解释相同的转义序列并以与字符串相同的方式进行操作。下面看文本块的引入方法和字符串的区别和不同：  
使用“一维”字符串引入Hello, world 文字

String html = "<html>\n" +
 " <body>\n" +
 " Hello, world\n" +
 " </body>\n" +
 "</html>\n";

使用“二维”文本块引入Hello, world 文字

String html = """
 <html>
 <body>
 Hello, world
 </body>
 </html>
 """;
 
 System.out.println("""
 Hello,
 itheima
 text blocks!
 """);

文本块是Java语言的新语法，可以用来表示任何字符串，具有更高的表达能力和更少的复杂度。文本块的开头定界符是由三个双引号 """ 开始，从新的一行开始字符串的内容。这里的新起的这行不属于字符串，只表示内容开始，是语法的一部分。以 """结束。 """可以紧跟字符串内容，也可以另起一行。另起一行时，字符串内容最后会留有一新行。

line 1
    line 2
    line 3

等效于字符串文字：

"line 1\nline 2\nline 3\n"

或字符串文字的串联：

"line 1\n" +
    "line 2\n" +
    "line 3\n"

如果在字符串的末尾不需要行终止符，则可以将结束定界符放在内容的最后一行。例如，文本块：

line 1
    line 2
    line 3"""

等效于字符串文字：

"line 1\nline 2\nline 3"

文本块可以表示空字符串，尽管不建议这样做，因为它需要两行源代码：

String empty = """
    """;

以下是一些格式错误的文本块的示例：

String a = """""";   // no line terminator after opening delimiter
    String b = """ """;  // no line terminator after opening delimiter
    String c = """
               ";        // no closing delimiter (text block continues to EOF)
    String d = """
               abc \ def
               """;      // unescaped backslash (see below for escape processing)

使用原始字符串语法：

String html = "<html>\n" +
 " <body>\n" +
 " Hello, world\n" +
 " </body>\n" +
 "</html>\n";

使用文本块文本块语法：

String html = """
 <html>
 <body>
 Hello, world
 </body>
 </html>
 """;

使用原始的字符串语法：

String query = "SELECT `EMP_ID`, `LAST_NAME` FROM `EMPLOYEE_TB`\n" +
                   "WHERE `CITY` = 'INDIANAPOLIS'\n" +
                   "ORDER BY `EMP_ID`, `LAST_NAME`;\n";

使用文本块语法：

String query = """
                   SELECT `EMP_ID`, `LAST_NAME` FROM `EMPLOYEE_TB`
                   WHERE `CITY` = 'INDIANAPOLIS'
                   ORDER BY `EMP_ID`, `LAST_NAME`;
                   """;

多语言示例

使用原始的字符串语法：

ScriptEngine engine = new ScriptEngineManager().getEngineByName("js");
    Object obj = engine.eval("function hello() {\n" +
                             "    print('\"Hello, world\"');\n" +
                             "}\n" +
                             "\n" +
                             "hello();\n");

使用文本块语法：

ScriptEngine engine = new ScriptEngineManager().getEngineByName("js");
    Object obj = engine.eval("""
                             function hello() {
                                 print('"Hello, world"');
                             }
                             
                             hello();
                             """);

java编译器会自动删除不需要的缩进：

\- 每行结尾的空格都会删除

\- 每行开始的共有的空格会自动删除

\- 只保留相对缩进。

System.out.println("""
        Hello,
        itheima
        text blocks!
        """);
    // 结果
    // > Hello,
    // > itheima
    // > text blocks!
    // >
    
    System.out.println("""
        Hello,
          itheima
        text blocks!
        """);
    // 结果
    // > Hello,
    // >   itheima
    // > text blocks!
    // >

\- 新行"""结束时，将"""向左调整，则可以给所有行前加相应数量的空格。将"""向右调整，没有作用。

System.out.println("""
            Hello,
            multiline
            text blocks!
        """);
    // 结果
    // >     Hello,
    // >     multiline
    // >     text blocks!