1. 简介
本文档的 PDF 版本在这里。
本文档中的代码在这里。
本文档由 Anthropic 的 AI Claude 制作。它是课程“使用 .NET 10 学习 C# 14 语言”(2026 年 10 月)的 Java 移植版,而该课程本身又是对课程“使用 .NET 3.5 学习 C# 3.0 版本语言的重写,后者由 Serge Tahé 于 2008 年 5 月撰写。本文档保留了该课程的提纲、示例和中心主线,并用现代 Java 重写:
- 本文档使用Java 25 (2025 年 9 月),即最新的长期支持版本(LTS),并在各章中介绍该语言的新特性——从 Java 25 的紧凑源文件到 Java 21 的虚拟线程,其间还包括记录、密封类和模式匹配;
- 在两种语言存在差异之处,本文档不只是简单翻译:C# 的属性、结构体、运算符重载和委托在 Java 中并不存在,Java 有自己的解决方案(getter、记录、函数式接口);反过来,Java 也有其独有的概念,例如受检异常 和虚拟线程,本文档对这些都作了详细介绍;
- 有两章的侧重点不同:异步编程,Java 使用[CompletableFuture]类和虚拟线程来处理,而不是[async] / [await] 关键字;以及对象关系映射,由Hibernate提供,它是 Java 世界中使用最广泛的 ORM;
- 所用的库都是当前 Java 中常用的:[JUnit 6] 用于测试,[Spring Framework 7] 用于依赖注入,[Jackson 3] 用于 JSON,[MySQL Connector/J]驱动程序用于 JDBC,[Hibernate 7],以及[Spring Boot 4] 用于 Web 服务;项目使用[Maven]构建。
本文档并非一门全面的课程。与它所源自的那些课程一样,它面向已经会编程、希望学习 Java 基础知识的人。它采用示例的方式:两百多个程序(三百多个 Java 文件),大多数篇幅很短,并带有逐行注释。
1.1. 1995 年至 2026 年的 Java
Java 由 Sun Microsystems 于 1995 年 5 月发布。它基于一个成就其成功的关键想法:[javac]编译器生成的不是机器码,而是一种中间代码——字节码——存放在[.class]文件中,由Java 虚拟机 (JVM,“Java Virtual Machine”)通过即时编译成机器码来执行。因此,同一个编译好的程序可以在 Windows、Linux 或 macOS 上运行:“一次编写,到处运行”。Kotlin、Scala 和 Groovy 语言同样生成字节码,并使用相同的库。
重要里程碑:
- 2006–2007 年:OpenJDK。Sun 以开源许可证发布了 Java 源代码(JDK)。目前所有的 Java 发行版都构建自 OpenJDK;
- 2010 年:Oracle 收购 Sun,成为 Java 的主要贡献者;
- 2014 年:Java 8,一个关键性的版本:lambda 表达式、Stream API、新的日期和时间 API。许多生产环境中的程序仍采用这种风格编写;
- 自 2017 年(Java 9)起:Java 的新版本每六个月发布一次,分别在三月和九月。有些版本提供长期支持 (LTS,“Long-Term Support”):Java 11(2018)、17(2021)、21(2023)以及 25(2025 年 9 月),本文档使用的就是它;从 Java 17 起,LTS 版本每两年发布一次。其他版本只获得六个月的支持;新特性往往先以“预览”形式出现,然后在后续版本中定稿;
- JDK 由多家供应商发布,它们都基于 OpenJDK,就我们的目的而言是等价的:Oracle、Eclipse 基金会(Eclipse Temurin,Adoptium 项目)、Microsoft、Amazon(Corretto)以及各 Linux 发行版。
自 Java 8 以来,该语言有了显著的演进。下表概括了本文档介绍的主要新特性,并指出它们出现的章节:
版本 | 年份 | 主要新特性 | 章 |
Java 8 | 2014 | lambda 表达式、方法引用、Stream API、接口方法、[default]、[java.time]、[CompletableFuture] | 5, 7, 9 |
Java 9 | 2017 | 模块(JPMS)、[jshell]、不可变集合 [List.of]、[Map.of] | 2, 4, 5 |
Java 10 | 2018 | 局部变量的类型推断 [var] | 3 |
Java 11 | 2018 | HTTP 客户端 [java.net.http.HttpClient]、直接执行源文件 [java File.java]、字符串方法 [strip]、[repeat]、[lines] | 2, 5, 12 |
Java 14 | 2020 | 表达式 [switch] ([case ->]、[yield])、[NullPointerException] 的详细消息 | 3, 4 |
Java 15 | 2020 | 文本块 ["""] | 3 |
Java 16 | 2021 | 记录、使用 [instanceof] 的模式过滤 | 4 |
Java 17 | 2021 | 密封类和密封接口([sealed]、[permits]) | 4 |
Java 18 | 2022 | UTF-8 作为默认编码 | 5 |
Java 21 | 2023 | 虚拟线程、有序集合、[switch]中的模式过滤、记录模式 | 3, 4, 5, 8, 9 |
Java 22 | 2024 | 匿名变量和参数 [_]、从多个源文件启动程序 | 3, 4, 7 |
Java 24 | 2025 | 流的中间操作([Gatherers]) | 5, 7 |
Java 25 | 2025 | 紧凑源文件和实例方法([main])、类([IO])、模块导入、作用域值([ScopedValue]) | 2, 3, 8 |
在库和工具方面,所介绍的新特性包括:[Maven]构建工具、现代集合、Stream API、[java.nio.file] 文件 API、[java.util.concurrent]类、Java 11 的 HTTP 客户端,以及生态系统中的主要框架:JUnit、Spring、Jackson、Hibernate 和 Spring Boot。
1.2. 文档内容
本文档包括以下各章:
- 第 2 章:搭建开发环境(JDK 25、IntelliJ IDEA 或 VS Code、Maven、[java] 和 [javac] 命令);
- 第 3 章:语言基础(类型、运算符、控制语句、受检异常和非受检异常、枚举、参数传递);
- 第 4 章:类、记录、接口、继承、密封类、泛型、包、模式匹配;
- 第 5 章:常用的 Java 类:字符串、数组、集合、Stream API、文本文件和二进制文件、使用 Jackson 处理 JSON、正则表达式;
- 第 6 章:分层架构、使用 JUnit 6 进行单元测试,以及使用 Spring 的依赖注入;
- 第 7 章:函数式接口、lambda 表达式和事件;
- 第 8 章:执行线程、同步和虚拟线程;
- 第 9 章:使用 [CompletableFuture] 和虚拟线程的异步编程;
- 第 10 章:使用 JDBC 访问数据库;
- 第 11 章:Hibernate;
- 第 12 章:Web 编程(TCP/IP、TCP 客户端和服务器、使用 [HttpClient]的 HTTP);
- 第 13 章:使用 Spring Boot 的 Web 服务;
- 第 14 章:进一步学习;
- 附录:安装 Laragon 和 MySQL,所用的 Maven 依赖。
1.3. 贯穿主线:税款计算
整个文档反复回到同一个问题:计算只有工资收入需要申报的纳税人的所得税。所用的税率档是最初的版本(2003 年收入):它已不再是现行税率,但对于我们的目的已经足够,我们的目的是用多种不同的方式编写同一个应用程序。它以九个版本实现:
版本 | 章 | 内容 |
1 | 3 | 单个程序:经过验证的输入、计算、显示 |
2 | 4 | 类和接口:[TaxBracket], [ITax], [AbstractTax], [HardwiredTax] |
3 | 5 | 从文本文件或 JSON 文件中读取计算数据 |
4 | 6 | 分层架构([dao]、[business]、[ui])位于单个程序之内 |
5 | 6 | 每层一个 Maven 模块、单元测试,以及通过依赖注入集成各层 |
6 | 10 | 使用 JDBC 从 MySQL 数据库读取数据的 [dao]层 |
7 | 11 | 使用 Hibernate 编写的 [dao]层 |
8 | 12 | 一个 TCP 税款计算服务器及其客户端 |
9 | 13 | 一个税款计算 REST Web 服务、一个控制台客户端和一个 Web 客户端 |
从版本 5 开始,后续版本复用版本 5 的各层,只替换发生变化的那一层:这正是第 6 章所介绍的分层架构的全部意义所在。
1.4. 示例
本文档中的代码组织在一个名为 [java-oct-2026]的文件夹中,每章对应一个子文件夹:
小程序都是紧凑源文件:即单个名为 [.java]的文件,使用命令 [java File.java] 执行(第 2 章)。只使用 JDK 库的多文件程序以同样的方式启动。需要外部库(Jackson、JUnit、Spring、MySQL 驱动程序、Hibernate、Spring Boot)的程序是 Maven 项目 ([pom.xml])。
本文档中的所有程序都由 JDK 25 的 [javac]编译器编译,使用启用全部警告的 [-Xlint:all]选项,编译时没有任何错误或警告,并使用附录中列出的库版本运行。本文档中重现的结果就是这些执行的结果。第 2 至 4 章的结果是在法语语言和地区设置(fr-FR)下得到的,就像在法语版 Windows 系统上一样:格式化的浮点数以小数逗号显示,日期为法语;后续各章则在英语设置下运行(小数点、英语日期)。有两点说明:
- JDK 的错误消息(异常消息、编译器消息)是英文的:JDK 没有提供它们的法语翻译;
- 这些示例是在 Linux 上运行的。在大多数情况下这没有区别:Java 是跨平台的。少数差异(使用 / 而不是 \ 的文件路径、终端命令)会在出现之处注明。
多线程、异步或网络程序的结果,以及测得的执行时间,每次运行可能有所不同:注释侧重于可重现的内容。
1.5. 资料来源
本文档的主要资料来源是:
- 官方 Java 文档:网站 https://dev.java(教程)以及 Java SE 25 API 文档:https://docs.oracle.com/en/java/javase/25/;
- Java 增强提案(JEP,“JDK Enhancement Proposals”),它们详细描述了语言和平台的每一项新特性: https://openjdk.org/jeps/0;
- 各个库的文档:JUnit(https://docs.junit.org)、Spring(https://spring.io/projects)、Hibernate(https://hibernate.org/orm/documentation/)、Jackson(https://github.com/FasterXML/jackson);
- 两本参考书:Joshua Bloch 的“Effective Java”(Addison-Wesley)和 Brian Goetz 等人的“Java Concurrency in Practice”(Addison-Wesley),它们至今仍是优秀的读物。