Java 1.7 主要新特性简介

在查阅 API 之前，了解这些核心特性有助于你更好地理解类库的设计和用途。

1. try-with-resources 语句 (自动资源管理)

   • 简介：这是 Java 7 最受欢迎的特性之一，它允许你在 try 语句中声明一个或多个资源（如 InputStream, Connection 等），这些资源会在 try 块执行完毕后自动关闭，无需再写 finally 块。

   • 示例：

     // Java 7 之前
     BufferedReader br = null;
     try {
         br = new BufferedReader(new FileReader("path/to/file.txt"));
         // 读取文件...
     } catch (IOException e) {
         // 处理异常
     } finally {
         if (br != null) {
             try {
                 br.close();
             } catch (IOException e) {
                 // 处理关闭异常
             }
         }
     }
     // Java 7 之后
     try (BufferedReader br = new BufferedReader(new FileReader("path/to/file.txt"))) {
         // 读取文件...
     } catch (IOException e) {
         // 处理异常
     }
     // br 在这里会自动被关闭

2. switch 语句支持 String 类型

   
   （图片来源网络，侵删）
   • 简介：switch 语句终于可以直接使用 String 对象了，而之前只能用于 int, byte, short, char 等基本类型及其包装类。
   • 示例：

     String status = "OK";
     switch (status) {
         case "OK":
             System.out.println("操作成功");
             break;
         case "FAIL":
             System.out.println("操作失败");
             break;
         default:
             System.out.println("未知状态");
     }

3. Diamond 操作符 (<>)

   • 简介：用于泛型实例化时，可以省略右侧的类型声明，编译器会自动从左侧推断类型，使代码更简洁。

   • 示例：

     // Java 7 之前
     List<String> names = new ArrayList<String>();
     // Java 7 之后
     List<String> names = new ArrayList<>();
     Map<String, List<Integer>> map = new HashMap<>();

4. 数字字面量的下划线支持

   • 简介：为了提高长数字的可读性，可以在数字字面量中使用下划线 _。
   • 示例：

     int million = 1_000_000;
     long creditCardNumber = 1234_5678_9012_3456L;
     double pi = 3.14_15_92;

5. 多异常捕获

   • 简介：一个 catch 块可以捕获多个不同类型的异常，用 分隔。
   • 示例：

     try {
         // 可能抛出 IOException 或 SQLException 的代码
     } catch (IOException | SQLException e) {
         // e 的类型是 IOException 和 SQLException 的共同父类
         // 在这里是 java.lang.Exception
         e.printStackTrace();
     }

6. java.nio.file 包 (新的 I/O API)

   • 简介：这是对文件系统操作的巨大改进，提供了更强大、更灵活的文件和路径操作能力。Path, Paths, Files 等类是核心。

   • 示例：

     import java.nio.file.*;
     import java.io.IOException;
     Path path = Paths.get("path/to/file.txt");
     if (Files.exists(path)) {
         System.out.println("文件存在");
         try {
             List<String> lines = Files.readAllLines(path, StandardCharsets.UTF_8);
             for (String line : lines) {
                 System.out.println(line);
             }
         } catch (IOException e) {
             e.printStackTrace();
         }
     }

Java 1.7 API 中文文档资源

由于 Java 1.7 是一个非常古老的版本（发布于 2011 年），官方早已停止更新，因此官方不再提供其在线中文文档，你需要从第三方渠道获取。

以下是一些可靠的 Java 1.7 API 中文文档资源：

国内技术社区和网站（推荐）

这些网站是国内开发者常用的,内容质量高，访问速度快。

• Runoob (菜鸟教程)

  • 链接：Java 7 教程
  • 简介：提供了 Java 7 新特性的中文介绍，并附带了大量简单易懂的示例代码，非常适合快速入门和概念理解。

• CSDN (中国软件开发者网络)

  • 链接：在 CSDN 搜索 "Java 7 API 中文文档" 或 "Java 1.7 API"。
  • 简介：CSDN 上有大量用户分享的 API 中文文档、博客文章和学习笔记，内容质量参差不齐，但可以找到很多针对特定问题的详细解答，搜索 Java 7 NIO Files API 中文 可能会找到非常详细的教程。

• IBM Developer 中国

  • 链接：在 IBM Developer 网站搜索 "Java 7"。
  • 简介：IBM 曾发布过非常高质量的 Java 技术文章和教程，其中包含对新特性的深入分析，包括 API 的使用。

文件下载 (CHM 格式)

对于离线查阅,CHM 格式的帮助文档是最佳选择。

• 常用下载站点：
  • CNZZ 下载站：搜索 "Java 7 API 中文文档 chm"。
  • ITWen：www.itwen.com，也是一个老牌的文档下载站点。
  • 百度文库 / 道客巴巴：这些平台也有用户上传的 CHM 文档，但需要注意文件的安全性和完整性。

使用 CHM 文档的注意事项：

1. 安全：从非官方渠道下载的 CHM 文件可能存在安全风险，建议使用杀毒软件扫描。
2. 索引问题：有时 CHM 文件的索引可能不完整或损坏，导致搜索功能不可用。

结合英文官方文档

如果你具备一定的英文阅读能力,强烈建议结合 Oracle 官方的英文 API 文档一起使用，英文文档最准确、最权威，是最终的“真理来源”。

• Oracle Java SE 7 Documentation
  • 链接：Java SE 7 Documentation (Oracle 官方)
  • 简介：这是最权威的资料，你可以在这里找到完整的 API 文档、教程和规范，当中文文档有歧义或不清晰时，查阅英文文档是最好的解决方法。

如何查阅 Java 1.7 API

无论你使用哪种资源,查阅 API 的基本方法是一致的：

1. 确定包名：你知道你要使用的功能属于哪个顶层包，文件操作在 java.nio.file，集合在 java.util，网络在 java.net。
2. 查找类：在包中找到核心的类，在 java.nio.file 中，你会找到 Files, Path, Paths。
3. 阅读类说明：类的顶部通常有对类整体功能的描述。
4. 查看构造方法：了解如何创建这个类的实例。
5. 查看方法：这是最重要的部分。
   • 方法名：方法名通常能告诉你这个方法的作用（如 readAllLines）。
   • 参数：了解方法需要什么输入。
   • 返回值：了解方法执行后会返回什么类型的结果。
   • 抛出异常：了解方法在什么情况下会抛出异常，这是健壮编程的关键。
   • 方法说明：详细描述了方法的具体行为和使用示例。
6. 查看字段：对于常量类（如 StandardOpenOption），字段列表非常重要。

总结与建议

给你的建议：

1. 以英文官方文档为准：把它作为你的“字典”和最终依据。
2. 用中文资源辅助学习：当你遇到困难或想快速了解某个特性时，优先查阅 Runoob 或 CSDN 上的中文教程。
3. 注意版本差异：如果你从 Java 1.7 升级到更高版本（如 Java 8, 11, 17），一定要关注 API 的变化和新旧特性的兼容性，Java 8 的 Stream API 就是对集合操作的革命性升级。

希望这份详细的指南能帮助你顺利查阅和使用 Java 1.7 的 API！