java 中文版api —— 开发者的权威参考手册

本平台致力于为全球中文Java开发者提供最准确、最完整、最及时的Java 中文版api文档服务。我们不仅收录了JDK从8到21全系列核心类库的官方文档中文翻译版本,还结合社区实践,补充了大量实战示例、常见问题解析与性能优化建议,力求打造中文世界最专业、最实用的Java技术知识库。

在当今快速迭代的软件开发环境中,API文档是开发者每日必查的“工具书”。然而,官方英文文档对许多中文用户而言存在理解门槛,而网络上零散的中文资料又常存在滞后、错误或缺失问题。为此,我们组建了由资深Java工程师与技术译者组成的团队,对JDK各版本API进行系统性翻译、校对与补充,并建立自动化更新机制,确保内容与Oracle官方同步。

本页面所有内容均基于JDK 8(长期支持版)、JDK 11(当前LTS)与JDK 17(最新LTS)三大主流版本构建,同时覆盖JDK 21最新特性。我们严格遵循Java语言规范与官方API文档结构,确保术语一致性与技术准确性。所有示例代码均通过实际编译与运行验证,支持直接复制使用。

无论您是初学者入门Java基础语法,还是资深工程师查阅高并发并发工具类(如java.util.concurrent包下类)的细节行为,或是研究泛型、反射、动态代理等高级特性,本平台都能为您提供权威、清晰、可操作的参考依据。

核心价值亮点

  • • 全面覆盖:JDK 8/11/17/21核心类库与常用扩展包(如java.sql, java.nio, java.time等)完整收录
  • • 实时更新:与Oracle官方发布节奏同步,新版本API文档在72小时内上线
  • • 中文精准:由专业Java译者团队翻译,术语统一,避免机器翻译生硬表达
  • • 示例丰富:每个重要类/方法均配可运行代码示例,附运行结果与注意事项
  • • 实战导向:融入社区高频问题与性能调优经验,提升实际开发效率

💡 使用提示

建议将本页面加入浏览器收藏夹,作为日常开发的“第一参考源”。在遇到不确定的API行为时,优先查阅本平台文档,可避免大量潜在陷阱。

⚡ 核心类库深度解析

Java 中文版api的根基在于其核心类库(Core Libraries),这是Java语言强大表达力与稳定性的基石。以下对几类关键类库进行系统梳理与深度解读。

〔1〕java.lang:语言基石

java.lang包提供Java语言运行所需最基础的类,无需显式导入即可使用。其核心成员包括:

  • • Object:所有类的根类,定义了equals()、hashCode()、toString()、clone()等关键方法
  • • String:不可变字符串类,支持丰富的操作方法(如concat、substring、split)
  • • Integer等包装类:提供基本类型与对象的双向转换,支持自动装箱/拆箱
  • • System:提供标准输入输出流(in/out/err)、数组复制(arraycopy)等系统级操作
  • • Runtime:与JVM运行时环境交互,如获取内存信息(maxMemory/freeMemory/totalMemory)

示例:Object.equals()的正确使用

String a = "Java";
String b = new String("Java");
System.out.println(a == b);        // false:引用地址不同
System.out.println(a.equals(b));   // true:内容相等
System.out.println(a.intern() == b.intern()); // true:字符串常量池复用

⚠️ 注意:equals()方法应满足自反性、对称性、传递性与一致性。自定义类重写equals()时,务必同步重写hashCode(),否则在HashMap等集合中将导致逻辑错误。

〔2〕java.util:工具类宝库

java.util包是Java开发中使用最频繁的工具库集合,涵盖集合框架、日期时间处理、随机数、扫描器等。

① 集合框架(Collections Framework)

以Collection接口为根,分为List、Set、Map三大子接口:

  • • List(有序可重复):ArrayList(数组实现,随机访问快)、LinkedList(链表实现,增删快)、Vector(线程安全但已过时)
  • • Set(无序不可重复):HashSet(基于HashMap,无序)、TreeSet(基于TreeMap,有序)、LinkedHashSet(插入有序)
  • • Map(键值对):HashMap(最常用)、TreeMap(有序)、ConcurrentHashMap(并发安全)、HashTable(线程安全但已弃用)

示例:HashMap与ConcurrentHashMap在并发场景下的表现

// ❌ 错误示例:多线程下HashMap可能死循环
Map map = new HashMap<>();
new Thread(()->{
    for(int i=0;i<10000;i++) map.put("key"+i, i);
}).start();
new Thread(()->{
    for(int i=0;i<10000;i++) map.get("key"+i);
}).start();
// ✅ 正确示例:使用ConcurrentHashMap
Map safeMap = new ConcurrentHashMap<>();
new Thread(()->{
    for(int i=0;i<10000;i++) safeMap.put("key"+i, i);
}).start();
new Thread(()->{
    for(int i=0;i<10000;i++) safeMap.get("key"+i);
}).start();

② java.time日期时间API(JDK 8+)

替代了过时的java.util.Date与Calendar,提供线程安全、不可变的日期时间类:

  • • LocalDateTime:本地日期时间(不含时区)
  • • ZonedDateTime:带时区的日期时间
  • • Duration/Period:计算时间差
  • • DateTimeFormatter:格式化与解析

示例:计算两个日期之间的天数

LocalDate start = LocalDate.of(2023, 1, 1);
LocalDate end = LocalDate.of(2023, 12, 31);
long days = ChronoUnit.DAYS.between(start, end); // 结果:364

〔3〕java.io与java.nio:输入输出体系

传统IO(java.io)基于流模型,适合小数据量顺序读写;NIO(java.nio)引入通道(Channel)与缓冲区(Buffer)模型,支持非阻塞与多路复用,适用于高并发网络应用。

示例:使用BufferedInputStream提升文件读取性能

try (BufferedInputStream bis = new BufferedInputStream(
        new FileInputStream("data.txt"))) {
    byte[] buffer = new byte[1024];
    int len;
    while ((len = bis.read(buffer)) != -1) {
        System.out.write(buffer, 0, len);
    }
} catch (IOException e) {
    e.printStackTrace();
}

⚠️ 注意

java.io包中多数类(如InputStream)未实现自动资源关闭,必须显式使用try-with-resources或手动close(),否则可能导致资源泄露。

相关资源

  • • 《Effective Java》第3版:第6章“方法”、第8章“并发”对类库使用有深刻洞见
  • • Oracle官方Javadoc:https://docs.oracle.com/en/java/javase/21/docs/api/

⚙️ API文档速查中心

本模块按功能模块组织,提供快速定位关键类与方法的结构化索引。所有API均附带中文说明、参数详解、返回值说明及典型使用场景。

〔1〕java.lang包重点类速览

类名核心方法说明
Stringsubstring(int beginIndex, int endIndex)返回指定范围的子字符串(含头不含尾)
StringBuilderappend(String str)线程不安全但高效,适用于单线程字符串拼接
Mathrandom()返回[0.0, 1.0)之间的double值
OptionalofNullable(T value)创建可能为空的Optional实例,避免NPE
JDK 8重点特性
JDK 11增强
JDK 17新特性
JDK 21前沿

JDK 8:函数式编程与时间API的里程碑

  • • Lambda表达式:简化匿名内部类,如list.forEach(s -> System.out.println(s))
  • • Stream API:函数式操作集合,支持filter/map/sort/reduce等链式调用
  • • Default Methods:接口可含默认实现方法,支持向后兼容
  • • java.time:全新日期时间API,彻底解决Date类线程不安全问题
Stream API实战示例
List names = Arrays.asList("Alice", "Bob", "Charlie");
List result = names.stream()
    .filter(s -> s.length() > 3)
    .map(String::toUpperCase)
    .sorted()
    .collect(Collectors.toList());
// 结果:[ALICE, CHARLIE]

JDK 11:LTS版本的性能与可用性提升

  • • HTTP Client API:正式支持现代HTTP/2客户端,替代过时的HttpURLConnection
  • • Local-Variable Syntax for Lambda Parameters:允许在Lambda中使用var(如(var x) -> x.length())
  • • String APIs增强:新增isBlank()、lines()、repeat(int)等方法
  • • ZGC垃圾回收器:实验性低延迟GC,暂停时间≤10ms
使用String.lines()处理多行文本
String text = "Line 1\nLine 2\nLine 3";
List lines = text.lines().collect(Collectors.toList());
// 结果:["Line 1", "Line 2", "Line 3"]

JDK 17:长期支持版的稳定性与安全强化

  • • Sealed Classes:密封类,限制继承层次(使用sealed、permits关键字)
  • • Pattern Matching for instanceof:简化类型检查与转换(if (obj instanceof String s) {...})
  • • Records:不可变数据载体类(自动生成构造器、getter、equals等)
  • • Strongly Encapsulate JDK Internals:默认封闭非公开API,提升安全性
Records简化数据类定义
public record Person(String name, int age) {}
Person p = new Person("Alice", 30);
System.out.println(p.name() + " - " + p.age()); // Alice - 30

JDK 21:前沿特性的集大成者

  • • Virtual Threads:虚拟线程,大幅提升高并发应用吞吐量(Project Loom)
  • • Structured Concurrency:结构化并发,简化多任务协作与异常传播
  • • String Templates:预览特性,支持内嵌表达式的字符串模板
  • • Sequence Containers:改进集合API的不可变性与构建器模式
虚拟线程示例(JDK 21)
try (var executor = Executors.newVirtualThreadPerTaskExecutor()) {
    for (int i = 0; i < 10000; i++) {
        final int taskId = i;
        executor.submit(() -> {
            System.out.println("Task " + taskId + " on " + Thread.currentThread());
            return taskId * 2;
        });
    }
}

每个任务运行在独立虚拟线程上,实际映射到少量平台线程,显著降低内存占用与上下文切换开销。

开发者建议

优先使用JDK 17或JDK 21开发新项目,以获得长期支持与新特性红利。老项目升级时,注意测试第三方库兼容性,尤其是对内部API的反射调用。

〔攻略〕Java 中文版api高效使用指南

掌握API文档的正确使用方式,能极大提升开发效率与代码质量。以下结合实战经验,提供系统性指导。

〔1〕如何快速定位关键API

  • • 按包名检索:如查找线程池,直接搜索java.util.concurrent包
  • • 利用IDE提示:IntelliJ IDEA按Ctrl+Q(Windows/Linux)或Ctrl+J(Mac)查看Quick Documentation
  • • 关注@since标签:确认API引入版本,避免在旧JDK中使用新特性
  • • 阅读throws子句:明确方法可能抛出的异常类型,提前处理

〔2〕避免常见API误用陷阱

陷阱1:StringBuilder与StringBuffer混淆

StringBuilder适用于单线程(性能高),StringBuffer适用于多线程(线程安全但慢)。多数场景应优先用StringBuilder。

陷阱2:HashMap的负载因子设置

默认负载因子0.75是时间与空间的平衡点。若内存充足且查询频繁,可适当调低(如0.5)减少冲突;若插入频繁且内存紧张,可调高(如0.9)减少扩容。

陷阱3:Date与Calendar的线程安全问题

两者均非线程安全!多线程环境下必须使用java.time包替代,或通过ThreadLocal隔离实例。

〔3〕高级调试技巧

  • • 重写toString():为自定义类提供有意义的字符串表示,便于日志分析
  • • 使用Objects工具类:Objects.equals(a, b)安全处理null值
  • • 启用JVM参数:如-XX:+PrintGCDetails观察GC行为,关联API性能

学习路径建议

  1. 基础:掌握java.lang、java.util基础类(1周)
  2. 进阶:深入集合框架与泛型机制(2周)
  3. 实战:结合Spring框架理解API在工程中的应用(持续)

〔问答〕网友最常问的10个问题

我们汇总了GitHub、Stack Overflow及国内技术社区的高频问题,结合Java 中文版api文档,提供权威解答。

Q1:String s = new String("abc")创建了几个对象?

A:通常创建2个对象:字符串常量"abc"(在常量池中) + new String()在堆上创建的新对象。若常量池中已存在"abc"(如之前已定义),则仅创建1个新对象。

验证方式:

String a = "abc";
String b = new String("abc");
System.out.println(a == b);        // false
System.out.println(a == b.intern()); // true

Q2:final修饰的变量真的不能变吗?

A:final修饰引用类型时,仅保证引用地址不变,对象内部状态仍可修改:

final List list = new ArrayList<>();
list.add("Java"); // ✅ 允许
list = new ArrayList<>(); // ❌ 编译错误:重新赋值被禁止

Q3:为什么推荐用equals比较字符串内容而非==?

A:==比较引用地址,equals比较内容。但注意:

  • • 对于String,JVM对常量字符串会复用常量池,故"abc" == "abc"可能为true
  • • 对于非String对象(如Integer),需确保值在缓存范围[-128,127]时equals才可靠

Q4:ConcurrentHashMap在JDK 7与8中的实现差异?

A:

  • • JDK 7:Segment分段锁 + HashEntry数组,锁粒度为Segment
  • • JDK 8:取消Segment,采用Node数组 + CAS + synchronized,锁粒度为桶(首节点)

JDK 8性能更优,尤其在高并发写场景下。

Q5:如何正确关闭InputStream?

A:必须使用try-with-resources确保自动关闭:

try (InputStream is = new FileInputStream("file.txt")) {
    // 读取操作
} catch (IOException e) {
    e.printStackTrace();
} // 自动调用is.close()

Q6:Stream的中间操作是延迟执行的吗?

A:是的!中间操作(filter/map/sorted)仅构建操作流水线,直到遇到终止操作(collect/forEach/toArray)才真正执行。这避免了多次遍历,提升效率。

Q7:Optional的get()方法为何不推荐?

A:get()在值为空时抛出NoSuchElementException,违背Optional设计初衷。应优先使用:

  • • orElse(T other):有值返回自身,否则返回默认值
  • • orElseGet(Supplier other):延迟提供默认值
  • • orElseThrow(Supplier exceptionSupplier):自定义异常

Q8:如何避免HashMap在扩容时死循环?

A:在JDK 8中已修复此问题(通过反转链表顺序)。但多线程下仍需使用ConcurrentHashMap。单线程环境可考虑用LinkedHashMap保持插入顺序。

Q9:System.arraycopy是native方法吗?

A:是的!该方法使用C/C++实现,直接操作内存,因此性能远超手动循环复制。推荐用于数组复制场景。

Q10:java.time包的类是线程安全的吗?

A:全部是!java.time包下所有类(如LocalDateTime、ZonedDateTime)均设计为不可变类,天然线程安全,可放心用于多线程环境。

延伸阅读

推荐关注:java.util.concurrent包下AtomicInteger、LongAdder等类,它们在高并发计数场景下比synchronized更高效。

〔资讯〕Java生态动态

跟踪Java语言与JDK演进最新进展,把握技术发展趋势。

2024-09-17

JDK 23进入Feature Freeze阶段

新特性包括:

  • • Pattern Matching for switch(增强switch表达式)
  • • Unnamed Classes(Unnamed Instance Main Methods)简化单文件程序
  • • ArrayIndexOutOfBoundsException优化
2024-03-19

JDK 22正式发布

关键更新:

  • • Unnamed Classes & Main Methods:允许void main()作为程序入口,无需public class声明
  • • Record Patterns:支持在模式匹配中解构record
  • • Weakly Named Classes:为JEP 445铺路
2023-09-19

JDK 21正式发布(LTS)

重磅特性:

  • • Virtual Threads(虚拟线程)
  • • Structured Concurrency(结构化并发)
  • • String Templates(字符串模板,预览)
  • • Sequenced Collections(有序集合接口)

Oracle官方发布计划

版本发布日期支持类型生命周期
JDK 82014-03-18LTS至2030-12(商业版)
JDK 112018-09-25LTS至2031-09(商业版)
JDK 172021-09-14LTS至2029-09(商业版)
JDK 212023-09-19LTS至2031-09(商业版)
JDK 242025-03-18非LTS6个月

开发者建议

生产环境优先选择LTS版本(JDK 17或21),新项目可尝试最新特性;非LTS版本适合实验性项目,需及时升级。