跳转至

Java 第三方库

第三方库是在 JDK 标准库之外引入的代码,用于补充 JSON 处理、测试、文件格式解析等能力。使用之前,需要知道库负责什么、怎样加入项目,以及输入输出遵循什么约定。

依赖与导入

import 使源码可以使用类型的简单名称,但不会下载对应的库。使用 Maven 时,依赖通过项目的 pom.xml 声明,再由构建工具解析和下载。

坐标 含义
groupId 发布组织或项目的分组标识
artifactId 具体构件名称
version 构件版本

例如,Gson 的 Maven 依赖可以写成:

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.13.2</version>
</dependency>

示例:从依赖到 API 调用

依赖加入项目后,源码通过 import com.google.gson.Gson 引入类型,再调用 toJson 或 fromJson 完成数据转换。

完整项目、示例与输出见 Gson:对象与 JSON 转换。该页面固定示例依赖版本,并提供可直接运行的 Maven 配置。

传递依赖

一个库也可能依赖其他库,构建工具会解析这些传递依赖。同一个构件出现多个版本时,实际选择结果应通过依赖树检查:

mvn dependency:tree

编译通过不代表运行环境一定包含全部依赖;发布应用时还需要确认类路径、模块路径和打包方式。

注意事项

  • 先检查库支持的 Java 版本,再确认它与当前项目的其他依赖是否兼容。
  • 示例中明确版本,避免运行结果随着依赖解析悄悄变化。
  • 不同库对 null、日期、泛型和未知字段的处理可能不同,需要查阅约定。
  • 依赖升级时重新运行相关示例和应用检查,关注不兼容变化。

练习

创建 Gson 示例项目,运行 mvn dependency:tree,区分自己声明的直接依赖与构建工具解析出的传递依赖。

参考资料