12、Java 9 新特性 – try-with-resources 语句

对照 Java 7 的资源声明和 Java 9 的 try (br) 写法,用 JDK 21 实测 --release 8、--release 9 及资源变量重新赋值的编译结果。

如果你使用过 Python ,应该对 with 语句不陌生,with 语句会创建一个独立的上下文,当执行流程离开该上下文时,就会立刻释放该上下文中的所有资源

这样的机制,我们都可以不用手动去关闭已经打开的资源,比如文件等,例如

with open('hello.txt') as f:
    print(f.read())

在执行流程离开 with 语句块之后,f 这个文件资源就会自动关闭

Java 7 就支持用 try-with-resources 自动关闭资源。Java 9 扩展了括号里的写法,允许直接引用符合条件的已有变量。Oracle Java 教程

try-with-resources

资源需要实现 AutoCloseable。Closeable 继承了这个接口,所以这里可以用 BufferedReader。退出 try 时,Java 会调用资源的 close()。

下面用 BufferedReader 读取字符串。如果项目要兼容 Java 8,可以在 try 的括号里声明一个资源变量 br1,让它引用已有的 br。

TryResourceTester.java

import java.io.BufferedReader;
import java.io.IOException;
import java.io.Reader;
import java.io.StringReader;
public class TryResourceTester {
   public static void main(String[] args) throws IOException {
      System.out.println(readData("test"));
   } 
   static String readData(String message) throws IOException {
      Reader inputString = new StringReader(message);
      BufferedReader br = new BufferedReader(inputString);
      try (BufferedReader br1 = br) {
         return br1.readLine();
      }
   }
}

这份声明式写法用 JDK 21 的 javac --release 8 编译成功。编译器给出了目标版本过旧的警告,运行结果仍是 test。

为什么装了 JDK 21,try (br) 还是编译不过?

先把本节后面的 Java 9 写法保存为 TryResourceTester.java。下面两次编译用的是同一份源码,输出放到不同目录。实验使用 Temurin 21.0.13,运行成功的类文件也用这套 JDK 执行。

javac -version
mkdir -p out/existing8 out/existing9 out/reassigned9
javac 21.0.13

目标为 Java 8 时,编译器在 try (br) 这一行报错。

$ javac --release 8 -d out/existing8 TryResourceTester.java
warning: [options] source value 8 is obsolete and will be removed in a future release
warning: [options] target value 8 is obsolete and will be removed in a future release
warning: [options] To suppress warnings about obsolete options, use -Xlint:-options.
TryResourceTester.java:12: error: variables in try-with-resources are not supported in -source 8
      try (br) {
             ^
  (use -source 9 or higher to enable variables in try-with-resources)
1 error
3 warnings
[exit 1]

保留源码,只把编译目标改为 Java 9,编译通过,执行后打印 test。

$ javac --release 9 -d out/existing9 TryResourceTester.java
[exit 0]
$ java -cp out/existing9 TryResourceTester
test
[exit 0]

接着,在 try (br) 上方插入下面这一行,再用 --release 9 编译。

      br = new BufferedReader(new StringReader(message));
$ javac --release 9 -d out/reassigned9 TryResourceTester.java
TryResourceTester.java:13: error: variable br used as a try-with-resources resource neither final nor effectively final
      try (br) {
           ^
1 error
[exit 1]

Java 9 的简写要求已有变量在进入 try 前已确定赋值,并且是 final 或 effectively final。示例里的 br 在声明时已初始化,后来又被赋值,所以这次触发的是变量限制。排查时,看到 not supported in -source 8 就检查项目的编译目标,看到 neither final nor effectively final 就找资源变量的再次赋值。实验记录里的 [exit …] 由脚本打印,用来标明命令退出状态。Java 9 语言规范 §14.20.3

TryResourceTester.java(Java 9 写法)

import java.io.BufferedReader;
import java.io.IOException;
import java.io.Reader;
import java.io.StringReader;
public class TryResourceTester {
   public static void main(String[] args) throws IOException {
      System.out.println(readData("test"));
   } 
   static String readData(String message) throws IOException {
      Reader inputString = new StringReader(message);
      BufferedReader br = new BufferedReader(inputString);
      try (br) {
         return br.readLine();
      }
   }
}