Java SE 18 新增特性

技术分享 4年前 (2022-08-23) 0 999+

关注

Java SE 18 新增特性

作者：Grey

原文地址：Java SE 18 新增特性

源码

源仓库: Github：java_new_features

镜像仓库: GitCode：java_new_features

默认使用 UFT-8 编码

在 Java SE 18 之前的 Java中，标准字符集会因操作系统和语言设置的不同而不同。Java 标准字符集决定了在 JDK 类库的许多方法中如何将字符串转换为字节，反之亦然（例如，在写入和读取文本文件时）。这些方法包括：

FileReader, FileWriter, InputStreamReader, OutputStreamWriter的构造函数。
Formatter和Scanner的构造函数。
URLEncoder.encode()和URLDecoder.decode()的静态方法。

当一个应用程序在一个环境中被开发和测试，然后在另一个环境中运行（ Java 选择了不同的默认字符集），这可能导致不可预测的行为。

此外，由于较新的类库方法在没有指定字符集的情况下总是使用 UTF-8 ，所以变得更加混乱，例如：
Files.writeString(),Files.readString(),Files.newBufferedWriter()和Files.newBufferedReader()

为了保护应用程序免受此类错误的影响，有两种解决方案：

方案一：在调用所有将字符串转换成字节的方法时指定字符集，反之亦然。

FileWriter fw = new FileWriter("happy-coding.txt", StandardCharsets.UTF_8); // ... FileReader fr = new FileReader("happy-coding.txt", StandardCharsets.UTF_8); // ... Files.readString(Path.of("happy-coding.txt"), StandardCharsets.UTF_8);

这个方案会导致大量的代码重复，容易出错。

方案二：通过系统属性 "file.encoding "设置默认字符集。

这种方案中的属性值在 Java SE 17 之前（包括 Java SE 17 ）中没有正式记录（见system-properties）。

其次，如上所述，指定的字符集并不用于所有的 API 方法。比如：

public class Jep400Example {   public static void main(String[] args) throws IOException {     try (FileWriter fw = new FileWriter("happy-coding.txt");         BufferedWriter bw = new BufferedWriter(fw)) {       bw.write("ハッピーコーディング！");     }      String text = Files.readString(Path.of("happy-coding.txt"));     System.out.println(text);   } }

让我们用标准编码 US-ASCII 来运行一次该程序。

java -Dfile.encoding=US-ASCII Jep400Example.java

运行结果如下

?????????????????????????????????

结果是垃圾，因为 FileWriter 考虑到了默认编码，但Files.readString()忽略了它，总是使用UTF-8。只有在你统一使用 UTF-8 的情况下才能正常运行。

java -Dfile.encoding=UTF-8 Jep400Example.java

运行结果如下

ハッピーコーディング！？

在 Java SE 18 中，无论操作系统、地域和语言设置如何，默认编码将始终是 UTF-8，见：JEP 400

另外，系统属性file.encoding也可以被合法使用。然而，我们应该谨慎地这样做。

最好的方法是将-Dfile.encoding设置为 UTF-8 或完全省略它。

代码示例

package git.snippets.jdk18;  import java.nio.charset.Charset;  public class UFT8Test {     public static void main(String[] args) {         System.out.println("Default charset : " + Charset.defaultCharset());         System.out.println("file.encoding   : " + System.getProperty("file.encoding"));         System.out.println("native.encoding : " + System.getProperty("native.encoding"));         System.out.println(Charset.defaultCharset());         System.out.println("你好");     } }

输出结果为：

Default charset : UTF-8 file.encoding   : UTF-8 native.encoding : GBK UTF-8 你好

JDK 自带 Web Server

准备一个html页面，放到任意文件夹中，

<!DOCTYPE html> <html lang="en"> <head>     <meta charset="UTF-8">     <title>Java自带的WebServer</title> </head> <body> Web Server By JDK18 </body> </html>

然后在这个文件所在目录执行

C:jdkjdk-18binjwebserver.exe

启动后，控制台会打印如下信息

Binding to loopback by default. For all interfaces use "-b 0.0.0.0" or "-b ::". Serving C:workspacejava_new_featuresjdk18_featuressrcmainresources and subdirectories on 127.0.0.1 port 8000 URL http://127.0.0.1:8000/

访问http://127.0.0.1:8000/可以看到效果

API 文档注释中支持代码片段

如果我们想把多行代码片段集成到 JavaDoc 中，我们必须通过<pre>...</pre>来完成，而且必须与{@code ...}相结合，这样做非常麻烦

下面是一个使用<pre>标签的例子:

/**  * How to write a text file with Java 7:  *  * <pre>{@code try (BufferedWriter writer = Files.newBufferedWriter(path)) {  *  writer.write(text);  *}}</pre>  */

在 Java SE 18 中，引入了@snippet标签，可以用于代码片段的注释

/**  * How to write a text file with Java 7:  *  * {@snippet :  * try (BufferedWriter writer = Files.newBufferedWriter(path)) {  *   writer.write(text);  * }  * }  */

Java SE 7及以后各版本新增特性