JDK 14的新特性:文本块Text Blocks

时间 2020-05-20

标签 jdk 特性文本 text blocks 栏目 Java 繁體版

原文原文链接

提及来，Text Blocks是在JDK13中以第一次预览版本引入的。如今在JDK14中是第二次预览版本 JEP 368: Text Blocks。html

在咱们平常的工做中，有时候须要用到一大段的字符串，这些字符串须要换行，须要排版，须要转义。在一个文本编辑器中，这固然是很是容易的事情。可是在java代码中，就是一个噩梦了。java

虽然IDE能够自动帮咱们加上换行甚至能够对字符串进行拼接。但在java程序眼中，添加的诸多额外的代码破坏了代码的美感。是任何一个有洁癖的程序员都没法忍受的。linux

怎么办？ Text Blocks就是来解救你们的。git

举个例子

咱们先来个直观的例子，而后再分析Text Blocks的特色。程序员

仍是举HTML的例子,若是咱们想要打印出带缩减，有格式的html，传统方法能够这样作：github

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

上面的代码看着特别别扭，让咱们看看用文本块方式怎么作：windows

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

是否是清爽不少，想要当即给文本块点个赞。api

别慌点赞，咱们还有更多的东西要讨论。编辑器

Indentation编排

可能有人又有问题了，文本块好用是好用，你这输出结果中，字段前面的空格都去哪了了呀？翻译

这里就要介绍这个概念了：英文名字叫Indentation，中文我把它翻译为编排。

再看一下上面的代码，这一次咱们把代码前面的空格以点来表示：

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

Indentation的规则就是以最下面的“”“为界，对每一行都移除相同数量的空格。

上面的代码输出：

<html>
    <body>
        <p>Hello, world</p>
    </body>
</html>

上面的例子，最下面的”“”恰好在最左边的位置，若是把“”“向右移动4个空格会发生什么呢？

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

输出结果：

<html>
    <body>
        <p>Hello, world</p>
    </body>
</html>

咱们看到输出结果是不变的，这样咱们又获得一条结论：若是”“”向右移动，则以text block中最左的那一行记录为准。

若是咱们把“”“向左移动四位，就会发现最终的输出结果每行前面都有四个空格。

这个功能是和String添加的新的String::stripIndent()对于的。

Escaping转义

仍是看一个直观的例子：

@Test
    public void useEscape(){
        String code =
                """
                "
                ""
                \s\s\s\s\s保留这行前面的空白
                String text = \"""
                    这里展现的是escape的用法！
                \""";
                跟你们说个密码，这一行很长，我准备分行\
                来写，哈哈！
                """;
        log.info("{}",code);
    }

输出结果：

”
""
     保留这行前面的空白
String text = """
    这里展现的是escape的用法！
""";
跟你们说个密码，这一行很长，我准备分行来写，哈哈！

首先能够看到一个双引号和两个双引号都是不用转义的，直接写就好了。三个双引号就须要转义了。

另外s表示的是一个空格。在须要的时候可使用。

在一行结尾直接插入，表示这一行太长了，还没结束。

注意在Text Block中，无论是windows的回车，换行符仍是linux的换行符都会转义成为换行符。

这个转义功能也对于了String的新方法translateEscapes()。

formatted格式化

最后介绍一下Text block的格式化，和String的格式化是同样的，举个SQL的例子:

@Test
    public void useMethod(){
        String query1 = """
                SELECT `EMP_ID`, `LAST_NAME` FROM `EMPLOYEE_TB`
                WHERE `CITY` = '%s'
                ORDER BY `EMP_ID`, `LAST_NAME`;
                """;

        log.info(query1.formatted("我是一个参数"));
    }

输出结果：

SELECT `EMP_ID`, `LAST_NAME` FROM `EMPLOYEE_TB`
WHERE `CITY` = '我是一个参数'
ORDER BY `EMP_ID`, `LAST_NAME`;

上面的例子中，咱们使用%s来定义占位符。

总结

虽然Text Block好用，但惋惜仍是预览版本，正式版本可能要等JDK15了。

本文的例子https://github.com/ddean2009/learn-java-base-9-to-20

本文做者：flydean程序那些事
本文连接：http://www.flydean.com/jdk-14-text-blocks/

本文来源：flydean的博客

欢迎关注个人公众号:程序那些事，更多精彩等着您！