Java API 概述

API（Application Programming Interface）是 Java 提供的一套预定义的类、接口和方法库，用于简化开发过程。Java API 包含核心类库（如 java.lang、java.util）和扩展库（如 java.sql、java.net），涵盖字符串处理、集合操作、文件 I/O、网络通信等功能。

常用核心 API 分类

java.lang 包

• 自动导入，包含基础类如 String、Integer、Math。
• Object 类是所有类的超类，提供 equals()、hashCode() 等方法。
• String 类提供不可变字符串操作，StringBuilder 用于可变字符串。

java.util 包

• 集合框架：List（ArrayList）、Set（HashSet）、Map（HashMap）。
• 工具类：Arrays（数组操作）、Collections（集合工具）。

java.io 包

• 文件读写：File 类、FileInputStream/FileOutputStream。
• 字符流：BufferedReader、BufferedWriter。

java.time 包（Java 8+）

• 日期时间处理：LocalDate、LocalDateTime、DateTimeFormatter。

示例代码：字符串与集合操作

字符串处理

String str = "Hello, API";
System.out.println(str.length());      // 输出长度
System.out.println(str.substring(7)); // 截取子串

集合操作

List<String> list = new ArrayList<>();
list.add("Java");
list.add("API");
System.out.println(list.contains("API")); // 检查元素

自定义 API 设计原则

1. 单一职责：每个类或方法只做一件事。
2. 清晰命名：方法名如 getUserById() 明确表达意图。
3. 文档注释：使用 Javadoc 标注功能与参数。

/**
 * 计算两数之和
 * @param a 第一个加数
 * @param b 第二个加数
 * @return 和值
 */
public int add(int a, int b) {
    return a + b;
}

注意事项

• 版本兼容性：注意不同 JDK 版本的 API 差异（如 java.time 需 Java 8+）。
• 性能考量：避免在循环中频繁创建对象（如字符串拼接用 StringBuilder）。
• 异常处理：调用 API 时处理可能抛出的异常（如 IOException）。