自学内容网 自学内容网

JDeps 使用指南

JDeps 使用指南

jdeps 是一个 Java 类依赖分析工具,允许开发者深入分析 Java 应用程序的依赖情况,包括类、包、模块和 JDK 内部 API 的使用。下面详细介绍 jdeps 的常用命令和输出解释。


1. 基本依赖分析
jdeps path/to/yourapp.jar

这个命令会分析指定 JAR 文件中的依赖关系,并输出每个类的依赖情况。

输出示例

yourapp.jar -> java.base
   com.example.MyClass -> java.util.List
   com.example.MyClass -> java.io.File

这表明 yourapp.jar 依赖于 java.base 模块,且 MyClass 依赖于 java.util.Listjava.io.File


2. 包依赖分析(-s 或 --summary)
jdeps -s path/to/yourapp.jar

该选项会简化输出,仅显示包与包之间的依赖,而不列出每个类的详细依赖。

输出示例

yourapp.jar -> java.base
   com.example -> java.util
   com.example -> java.io

这表示 com.example 包依赖于 java.utiljava.io 包。


3. 模块依赖分析

在 Java 9 及以上版本,Java 引入了模块系统。通过 jdeps 可以分析模块之间的依赖。

jdeps --module-path path/to/modules --add-modules your.module.name path/to/yourapp.jar

输出示例

yourapp.jar -> java.base
   my.module -> java.logging
   my.module -> java.sql

这表示 my.module 依赖于 java.loggingjava.sql 模块。


4. 查找 JDK 内部 API 的使用情况(-jdkinternals)

如果你想检查项目中是否使用了不安全的 JDK 内部 API,可以使用 -jdkinternals 选项。

jdeps -jdkinternals path/to/yourapp.jar

输出示例

myapp.jar -> java.base
   com.example.MyClass -> sun.misc.Unsafe
Warning: com.example.MyClass uses JDK internal API (sun.misc.Unsafe)

这意味着 MyClass 使用了 sun.misc.Unsafe,这是一个 JDK 内部 API,应该尽量避免使用。


5. 显示类依赖(-v 或 --verbose)

使用 -v 选项可以显示更详细的依赖信息。它有三个详细级别:

  • -verbose:class:显示类的依赖。
  • -verbose:package:显示包的依赖。
  • -verbose:module:显示模块的依赖。
jdeps -v:class path/to/yourapp.jar

输出示例

yourapp.jar -> java.base
   com.example.MyClass -> java.util.ArrayList
   com.example.MyClass -> java.io.File
   com.example.MyClass -> java.lang.String

这列出了每个类的具体依赖关系。


6. 限制分析到指定包或类(-p 或 --package)

你可以使用 -p 选项仅分析指定包的依赖。

jdeps -p com.example path/to/yourapp.jar

输出说明

  • 只显示 com.example 包的依赖关系。

7. 生成依赖图文件(-dotoutput)

可以使用 -dotoutput 选项生成 .dot 文件,使用这些文件可以通过图形工具(如 Graphviz)生成依赖关系图。

jdeps -dotoutput path/to/output/ path/to/yourapp.jar
输出说明
  • 在指定的输出目录下生成 .dot 文件,用图形工具可以将依赖可视化。

JDeprScan 简介

jdeprscan 是另一个用于扫描已弃用 API 的工具,它可以帮助开发者检查代码是否依赖于即将在未来 JDK 版本中移除的 API。

常见用法
扫描指定 JDK 版本的弃用 API(–release)

--release 选项允许你扫描是否依赖于指定 JDK 版本中已弃用或将要删除的 API。

jdeprscan --release 17 path/to/jars-directory

这将扫描目录下的所有 JAR 文件,查找 JDK 17 中的已弃用或删除的 API。

输出示例

warning: com.example.MyClass uses deprecated method java.util.Date.getYear()

表示 MyClass 使用了已在 JDK 17 中弃用的 getYear() 方法。


显示所有可扫描版本的 API

使用 jdeprscan --list 可以查看可以指定的 JDK 版本。

jdeprscan --list

输出示例

Supported releases: 8, 9, 10, 11, 12, 13, 14, 15, 16, 17

扫描指定类文件或 JAR 文件的弃用 API

如果你想扫描特定的类或 JAR 文件:

jdeprscan path/to/yourapp.jar

输出示例

warning: com.example.MyClass uses deprecated method java.util.Date.getYear()

JDeps 和 JDeprScan 常见问题解答

问题 1:运行 jdeps 时没有输出,意味着什么?

如果运行 jdeps 命令后没有任何输出,可能有以下几种情况:

  1. 无依赖:所分析的类或 JAR 文件中没有外部依赖。
  2. 类文件格式不兼容:可能分析的 .jar.class 文件不兼容(例如,JDK 版本不一致)。
问题 2:为什么 jdeprscan --release 17 没有输出?

如果运行 jdeprscan --release 17 path/to/jar 没有输出,说明:

  1. 没有使用弃用的 API:项目中没有使用 JDK 17 已弃用的 API。
  2. 路径不正确:确保你提供了正确的路径,并且该路径下有需要扫描的 JAR 文件或类文件。

总结:JDeps 和 JDeprScan 的全面使用

  • jdeps 是分析 Java 类和模块依赖的工具,常用来迁移和检查内部 API 的使用。

    • 常用选项包括 -v(显示详细依赖)、-s(显示包依赖)、-jdkinternals(检查内部 API)。
  • jdeprscan 用于扫描代码中使用的弃用 API,常用 --release 来指定扫描的目标 JDK 版本。

    • jdeprscan --release 17 可以检查代码是否使用了在 JDK 17 中被弃用的 API。

掌握这些工具有助于你有效迁移代码到较新的 JDK 版本,并避免使用将来可能被移除的 API。


原文地址:https://blog.csdn.net/pumpkin84514/article/details/142371848

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!